目标:在 Linux 服务器/本机上完成 OpenClaw 安装与基础可用验证。
一、环境要求
- Linux 系统(建议 Ubuntu 22.04+)
- Node.js 22.x
- npm
- sudo/root 权限(用于部分系统级操作)
先检查环境:
node -v
npm -v
二、安装 Node.js 22(如未安装)
推荐用 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
node -v
npm -v
三、安装 OpenClaw
全局安装:
npm install -g openclaw
安装后验证:
openclaw --version
openclaw help
四、启动 Gateway 服务
OpenClaw 常用服务命令:
openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
首次执行:
openclaw gateway start
openclaw gateway status
五、基础配置
执行初始化配置:
openclaw configure
按提示完成基础项(模型、通道、工具等)。
如果需要网页搜索工具(web_search),需要单独配置 Web 部分(如 Brave API Key):
openclaw configure --section web
六、健康检查
建议执行一次诊断:
openclaw doctor --non-interactive
如有异常,根据输出逐项修复(通常是依赖、环境变量或网络连通性问题)。
七、升级与维护
升级 OpenClaw:
npm install -g openclaw@latest
升级后建议:
openclaw gateway restart
openclaw doctor --non-interactive
八、常见问题
1) openclaw:找不到命令
- 说明全局 npm bin 不在 PATH 中
- 先执行
npm prefix -g和npm bin -g检查路径并加入 shell 配置

