一、OpenClaw介绍
OpenClaw 是一个运行在本地设备上的个人 AI 助手。
二、安装 (V10SP1和V11步骤一样)
1.关闭kysec安全 (略)
V10-SP1和V11不同，关闭步骤可以查看一下我其他文章。
2.安装依赖程序（可以切换root，也可以不切）
sudo apt update && sudo apt install git -y
3.使用nvm安装node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
上面命令执行没问题后，再执行以下命令：
source ~/.bashrc
nvm install 22
nvm use 22
node --version
4.安装pnpm
npm install -g pnpm
pnpm setup
source ~/.bashrc
# 配置淘宝镜像源
pnpm config set registry https://registry.npmmirror.com
pnpm config set @npm:registry https://registry.npmmirror.com
# 验证配置
pnpm config get registry # 输出 https://registry.npmmirror.com
5.使用 pnpm 全局安装openclaw
pnpm add -g openclaw@latest
openclaw --version
如上图所示，openclaw已经安装完成。
三、初始化及配置openclaw
1.执行以下命令配置工作目录（可以省略）
openclaw setup
2.执行以下命令进行导航式配置：
openclaw onboard
3.配置QQ机器人
浏览器打开
用qq扫码登录
点创建机器人
把这三条命令，复制到终端去执行
打开QQ就能看到小龙虾机器人了
4.安装chromium浏览器
四、卸载
全局卸载OpenClaw
1.使用以下命令卸载通过pnpm全局安装的OpenClaw：
pnpm remove -g openclaw
或简写为：
pnpm rm -g openclaw
2.检查是否已卸载
执行以下命令检查是否已成功卸载：
pnpm list -g | grep openclaw
若无输出，则表示已卸载。
3.手动删除残留文件（可选）
如果标准方法无效，可以手动删除全局包：
找到pnpm全局安装目录：
pnpm root -g
进入该目录并删除OpenClaw相关文件夹：
rm -rf
4.清除缓存（可选）：
pnpm store prune
五、常用命令
| 命令 | 作用 | 备注 / 参数 |
|---|---|---|
| npm install -g openclaw@latest –registry https://registry.npmmirror.com | 安装 | openclaw |
| openclaw onboard | 安装引导 | |
| openclaw status | 查看 Gateway 状态 | 检查网关是否可达及运行状况 |
| openclaw health | 健康检查 | 主要检测 core 运行和依赖情况 |
| openclaw doctor | 综合诊断与修复建议 | 可配合 –yes / –non-interactive 自动执行 |
| openclaw configure | 交互式配置向导 | 用于设置模型、通道、凭据等 |
| openclaw config get | 获取配置值 | 指定路径提取配置 |
| openclaw config set | 设置配置项 | 支持 JSON5/raw 文本 |
| openclaw config unset | 清除配置项 | 移除单个键值 |
| openclaw channels list | 列出已登录通道 | 可观察 WhatsApp/Telegram 等登录状态 |
| openclaw channels login | 登录新的通道账号 | 用于扫描 / 授权链接 |
| openclaw skills list | 列出技能 | 查看可用 / 已安装的技能 |
| openclaw skills info | 技能详情 | 观察某项技能参数或版本 |
| openclaw plugins list | 列出插件 | 查看已安装插件 |
| openclaw plugins install | 安装插件 | 例如 @openclaw/voice-call |
| openclaw plugins enable | 启用插件 | 之后通常需要重启网关 |
| openclaw logs –follow | 显示日志 | –json / –plain / –limit 等组合使用 |
| openclaw gateway | 启动 Gateway 网关 | |
| openclaw gateway install | 安装系统服务 | 根据平台注册 Gateway 守护进程 |
| openclaw gateway start | 启动 Gateway 网关 | 系统服务模式下启动 |
| openclaw gateway stop | 停止 Gateway 网关 | 同上 |
| openclaw gateway restart | 重启 Gateway 网关 | 适合配置变更后应用 |
| openclaw gateway status | 网关系统服务状态 | 不同于 openclaw status，会探测服务单元 |
| openclaw uninstall | 卸载 Gateway 服务及数据 | 官方推荐使用 |
| openclaw uninstall –all –yes –non-interactive | 全自动卸载 | 包含状态、workspace、插件等 |
| openclaw uninstall –state | 删除状态文件 | 不删除 workspace/CLI |
| openclaw uninstall –workspace | 删除工作区 | 移除 agent/workspace 文件 |
| openclaw uninstall –service | 仅卸载服务 | 不删除数据 |
| openclaw uninstall –dry-run | 模拟卸载 | 显示结果但不实际执行 |
其他
官网中文文档地址：https://docs.openclaw.ai/zh-CN
安装过程中的常见错误
1.pnpm 找不到全局 bin 目录，如下图所示：
这个错误是因为 pnpm 找不到全局 bin 目录，导致无法将 openclaw 命令链接到全局。你可以按以下步骤解决：
自动创建全局 bin 目录（推荐）
直接运行 pnpm 提供的 setup 命令，它会自动创建并配置好目录：
pnpm setup
source ~/.bashrc
执行完成后，重启终端或重新加载 shell 配置，再尝试安装：
pnpm add -g openclaw@latest
2.缺少git命令
处理：
apt update && apt install -y git
3.打开的web界面显示4008，如下图所示：
处理方法1：
从软件商店上下载chromium浏览器，用chromium浏览器打开就好了。
处理方法2：
# 生成新的 gateway token
openclaw doctor --generate-gateway-token
# 重启服务
systemctl --user restart openclaw-gateway
# 打开带 token 的 dashboard
openclaw dashboard