OpenClaw-CN 安装与使用教程（Linux 环境）
本教程基于实际成功安装流程整理，适用于 Debian/Ubuntu 系统，已解决常见兼容性问题（如
--disable-warning报错）。
文档：http://clawd.org.cn/start/getting-started.html
✅ 一、前置要求
- 操作系统：Ubuntu/Debian（root 或具有 sudo 权限的用户）
- 网络：可访问 npm 官方源（如遇慢速可配置国内镜像）
- 推荐 Node.js 版本：v22.x LTS（v18 可能存在兼容性问题）
🔧 二、完整安装步骤
步骤 1：安装 Node.js 与 npm（如未安装）
sudo apt update
sudo apt install -y nodejs npm
✅ 验证：
node -v # 建议 ≥ v22 npm -v
步骤 2：安装 pnpm 包管理器
npm install -g pnpm
pnpm -v # 验证安装
步骤 3：配置 pnpm 全局 bin 目录（关键！）
pnpm setup
source ~/.bashrc # 使配置立即生效
🔍 验证配置：
echo $PNPM_HOME # 应输出类似 /root/.local/share/pnpm which pnpm # 应在 $PNPM_HOME 路径下
步骤 4：升级 Node.js 至 v22 LTS（推荐，避免兼容问题）
# 方法一：使用 n 工具（推荐）
npm install -g n
n lts # 安装最新 LTS 版本（当前为 v22）
# 方法二：使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
# 验证
node -v # 应显示 v22.x.x
⚠️ 重要：Node.js v18 可能因
--disable-warning限制导致openclaw-cn启动失败，强烈建议升级至 v22。
步骤 5：全局安装 OpenClaw-CN
pnpm add -g openclaw-cn@latest
✅ 成功标志：
+ openclaw-cn 2026.1.31 Done in Xs
步骤 6：验证安装
openclaw-cn --version # 查看版本
openclaw-cn --help # 查看帮助
🚀 三、首次使用：登录与初始化
# 执行 onboard 流程（扫码登录微信）
openclaw-cn onboard
这里有一个安装向导，我们（使用箭头或者空格）选择YES，选择快速安装。
1月31日这个版本增加了国内的硅基流动、阿里云百炼、DeepSeek等模型厂商。
由于Agent有可能消耗上万token，费用不好控制。我选择的是OpenCode Zen，从如下地址获取API key：https://opencode.ai/auth
选一个free的免费模型。
模型选择完成后，接下来选择通道。
跳过通信通道配置：选择“Skip for now”（后续专门配置飞书）；
技能配置：选择“No”（暂不配置，后续可按需扩展）；
Hooks配置：选择“Skip for now”（暂不启用）；
启动方式选择：选择“TUI”（终端聊天界面），出现聊天界面后输入“Hello”测试，确认安装成功；
关闭TUI界面：按ctrl+c退出，后续通过Web UI或飞书交互。
访问Web UI面板
建立SSH隧道（本地电脑终端执行）：
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
输入服务器密码完成连接；
获取授权链接：服务器终端执行clawdbot dashboard，复制输出的“Dashboard URL”；
访问面板：本地浏览器打开复制的URL，即可进入OpenClaw Web UI，首次使用可设置AI助手名称与自身称呼（如输入“Name: Openclaw”“My Name: Boss”）。
⚠️ 四、常见问题解决
| 问题 | 原因 | 解决方案 |
|---|---|---|
Command 'pnpm' not found |
未安装 pnpm | 执行 npm install -g pnpm
|
ERR_PNPM_NO_GLOBAL_BIN_DIR |
未配置全局 bin 目录 | 执行 pnpm setup && source ~/.bashrc
|
--disable-warning= is not allowed |
Node.js 版本过低（v18）或非法 NODE_OPTIONS |
升级至 Node.js v22（使用 n lts） |
| 命令未找到 | PATH 未包含 pnpm bin | 检查 ~/.bashrc 是否含 export PATH="$PNPM_HOME:$PATH"
|
🔍 排查技巧：
# 检查 NODE_OPTIONS 是否被意外设置 echo $NODE_OPTIONS # 查看 openclaw-cn 实际路径 which openclaw-cn
🔐 五、安全与维护建议
定期更新
pnpm add -g openclaw-cn@latest
卸载
pnpm remove -g openclaw-cn
