OpenClaw 在 Linux/Ubuntu 上的安装与部署实战
本文详细介绍在 Ubuntu 22.04/24.04 系统上安装和部署 OpenClaw 的完整流程，涵盖系统环境准备、Node.js 安装、OpenClaw 部署、配置向导、安全加固以及常见问题排查，帮助开发者从零开始搭建自己的 OpenClaw AI 助手系统。
一、环境准备与系统要求
在开始安装 OpenClaw 之前，需要确保服务器满足最低硬件和软件要求。OpenClaw 对硬件的要求相对友好，但为了保证流畅运行，建议配置如下：CPU 至少 4 核心以保证 Agent 能够并发处理多个任务；内存建议 8GB 以上，4GB 是最低可用配置，但可能会在处理复杂任务时出现卡顿；存储空间至少需要 10GB 可用空间，用于存储模型缓存、Skills 插件和日志文件。此外，还需要稳定的网络连接，以及 sudo 管理员权限用于执行安装操作。
软件方面，OpenClaw 要求操作系统为 Ubuntu 22.04 或 24.04，其他基于 Debian 的发行版理论上也可以运行，但本文以 Ubuntu 为例进行说明。Node.js 版本必须不低于 22.0.0，这是硬性要求，低于此版本将无法正常工作。此外还需要 git 用于克隆代码仓库，以及 build-essential 编译工具链用于编译原生依赖。
二、系统基础环境配置
无论采用哪种安装方式，首先都需要更新系统软件包列表并安装基础依赖。这是避免后续安装过程中出现"依赖缺失"错误的关键步骤。打开终端，执行以下命令：
sudo apt update && sudo apt upgrade -y && sudo apt install -y curl wget git python3 build-essential libssl-dev ufw
这些命令的作用各不相同：curl 和 wget 用于下载安装脚本和依赖包；git 用于后续可能的源码操作；python3 是一些原生模块编译时需要的依赖；build-essential 包含了 gcc、g++ 等编译工具；libssl-dev 提供 SSL/TLS 支持；ufw 是防火墙工具，用于后续的安全配置。安装过程可能需要几分钟时间，请耐心等待完成。
更新完成后，建议配置防火墙规则。OpenClaw 默认监听 18789 端口，如果需要从外部访问，需要开放这个端口。但出于安全考虑，默认建议只允许本地访问：
sudo ufw allow 22/tcp # 保留 SSH 访问
sudo ufw enable # 不开放 18789 端口，保持默认的仅本地访问
这样配置后，只有通过 SSH 登录到服务器的用户才能访问 OpenClaw，减少了被攻击的风险。如果确实需要远程访问，建议配置反向代理或 VPN，而不是直接开放端口。
三、Node.js 运行时安装
Node.js 是 OpenClaw 的核心依赖，安装方式有多种。推荐使用 nvm (Node Version Manager) 进行安装，因为它能够方便地管理多个 Node.js 版本，避免版本冲突问题。首先安装 nvm，官方脚本托管在 GitHub 上，但由于网络原因，国内用户可能无法直接访问。可以使用 Gitee 镜像：
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
source ~/.bashrc
安装完成后，验证 nvm 是否正常工作：
nvm --version
接下来安装 Node.js 22 版本：
nvm install 22 && nvm use 22
nvm 会自动下载并安装 Node.js 22 的最新稳定版本。安装完成后，验证版本：
node -v # 应输出 v22.x.x
npm -v # 应输出对应的 npm 版本
