OpenClaw 汉化版 npm 安装、卸载与升级教程

一、安装 Node.js#

根据官方安装指南，OpenClaw 要求：

1
Node.js >= 22.12.0

如果你还没有安装 Node.js，可以按你的系统选择下面一种方式。

Windows#

访问 Node.js 官网下载页面下载 LTS 版本安装包并安装。

Ubuntu / Debian#

1
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
2
sudo apt-get install -y nodejs

CentOS / RHEL#

1
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
2
sudo yum install -y nodejs

安装完成后检查版本#

1
node -v
2
npm -v

二、安装 OpenClaw 汉化版#

官方 npm 安装命令：

1
npm install -g @qingchencloud/openclaw-zh@latest

如果你在国内下载慢，可以直接使用官方文档里的镜像源：

1
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

三、初始化配置（图文详解）#

运行初始化命令：

1
openclaw onboard --install-daemon

按照界面提示依次完成以下步骤：

初始化配置选择 yes

选择快速开始

选择模型提供商（自建选择自定义）

输入 URL、选择密钥、输入令牌回车

再回车，输入模型名称（如 gpt-5.4）回车

直接回车两次

四、配置 Telegram 机器人（可选）#

如果想通过 Telegram 使用 OpenClaw，需要先创建机器人。

选择渠道（以 Telegram 为例）

在 Telegram 中搜索 @BotFather

对话输入 /newbot，输入机器人名称，再输入机器人用户名，得到 token

回到电脑终端，输入 Telegram 机器人的 token

五、完成配置#

技能先不配置，选择 no

Hooks 全部点击空格勾选，然后回车

安装成功

六、启动与访问#

启动 OpenClaw

1
openclaw gateway

打开 Dashboard 控制台

1
openclaw dashboard

或手动访问 http://localhost:18789

七、修复无法打开浏览器问题#

如果 OpenClaw 无法打开浏览器，需要修改配置文件。

找到配置文件

路径：C:\Users\用户名\.openclaw\openclaw.json

修改 profile 为 full

找到 tools 部分，将 profile 改为 full：

1
"tools": {
2
    "profile": "full",
3
    "web": {
4
      "search": {
5
        "enabled": true
6
      },
7
      "fetch": {
8
        "enabled": true
9
      }
10
    }
11
  },

修改完成后重启 OpenClaw 服务即可。

补充：Telegram 渠道提权配置#

如果你希望在 Telegram 渠道里允许指定账号使用提权能力，可以继续在 openclaw.json 的 tools 配置里补充下面这段：

1
"tools": {
2
    "profile": "full",
3
    "web": {
4
      "search": {
5
        "provider": "brave"
6
      }
7
    },
8
    "elevated": {
9
      "enabled": true,
10
      "allowFrom": {
11
        "telegram": [
12
          "123456789"
13
        ]
14
      }
15
    }
16
  },

说明：

provider: "brave"：把搜索提供商设置为 brave
enabled: true：开启提权能力
allowFrom.telegram：只允许这里填写的 Telegram 用户 ID 使用提权
123456789：记得替换成你自己的 Telegram 数字 ID

修改完成后同样需要重启 OpenClaw 服务。

八、常用管理命令#

1
# 查看状态和诊断
2
openclaw status
3
openclaw doctor
4

5
# 重启服务
6
openclaw gateway restart
7

8
# 守护进程管理
9
openclaw daemon start
10
openclaw daemon stop
11
openclaw daemon restart
12
openclaw daemon status
13

14
# 其他常用命令
15
openclaw dashboard          # 打开网页控制台
16
openclaw config             # 查看/修改配置
17
openclaw skills             # 管理技能
18
openclaw --help             # 查看帮助

九、卸载教程#

卸载 CLI：

1
npm uninstall -g @qingchencloud/openclaw-zh

删除配置（可选，不可恢复）：

1
rm -rf ~/.openclaw

卸载守护进程：

macOS

1
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
2
rm ~/Library/LaunchAgents/com.openclaw.plist

Linux

1
sudo systemctl stop openclaw
2
sudo systemctl disable openclaw
3
sudo rm /etc/systemd/system/openclaw.service
4
sudo systemctl daemon-reload

十、更新升级#

升级到最新版：

1
npm update -g @qingchencloud/openclaw-zh

或使用 CLI 检查更新：

1
openclaw update

官方来源#

官方仓库：https://github.com/1186258278/OpenClawChineseTranslation
官方安装指南：https://github.com/1186258278/OpenClawChineseTranslation/blob/main/docs/INSTALL_GUIDE.md
官方 README：https://github.com/1186258278/OpenClawChineseTranslation/blob/main/README.md

如果后续命令有变化，以官方仓库里的最新文档为准。