目标：在 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 配置

2) Gateway 启动失败

  • 先看状态：openclaw gateway status

  • 再重启：openclaw gateway restart

  • 仍失败就跑：openclaw doctor --non-interactive

3) 搜索工具报 missing_brave_api_key

  • 说明未配置 Web 搜索 API Key

  • 运行：openclaw configure --section web

九、结语

到这里，OpenClaw 的安装和基础运行就完成了。
下一步建议做两件事：

  1. 按你的使用场景配置消息通道

  2. 做一次安全检查（最小权限、端口暴露、密钥管理）