Skip to content
/ OpenClawChineseTranslation Public

🦞 OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入 | WhatsApp/Telegram/Discord 多平台 | 每小时自动同步 | CLI + Dashboard 全中文 | 全流程搭建教程，以及排错指南！

openclaw.qt.cool

License

View license
1.2k stars 161 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

1186258278/OpenClawChineseTranslation

BranchesTags

Repository files navigation

OpenClaw 汉化发行版

Release npm Nightly Build Platform License

每小时自动同步 OpenClaw 官方更新，汉化版延迟 < 1 小时！

汉化官网

什么是 OpenClaw？

OpenClaw 是 GitHub 195,000+ Stars 的开源个人 AI 助手平台。它运行在你的电脑上，通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。

本项目 = OpenClaw + 全中文界面，CLI 命令行和 Dashboard 网页控制台均已深度汉化。

🏷️ 合作伙伴

胜算云 - 国内 AI API 聚合平台，新用户注册送额度，充值尊享 7 折优惠！

阶梯 春节消耗 奖励
尝鲜礼 ≥50元 5元 模力券
极客礼 ≥100元 10元 模力券 + Kimi K2.5 七折卡(7天)
大神礼 ≥500元 50元 模力券 + Kimi K2.5 七折卡(7天)

查看活动 → · 注册账号 →

4 步上手

前提条件：需要 Node.js >= 22（下载 Node.js）

检查版本：node -v

第 1 步：安装

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

第 2 步：初始化（推荐守护进程模式）

openclaw onboard --install-daemon

初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道

第 3 步：启动网关

openclaw gateway

第 4 步：打开控制台

openclaw dashboard

浏览器会自动打开全中文的 Dashboard 控制台。完成！

想了解每一步的详细说明？查看 详细安装指南（包含 Node.js 安装、模型配置、守护进程、内网访问等）

汉化效果预览

概览仪表板
概览仪表板 - 网关状态、实例监控、快捷操作一目了然

查看更多截图

对话界面
对话界面 - 与 AI 助手实时交互

渠道管理
渠道管理 - WhatsApp、Telegram、Discord 等全平台支持

配置中心
配置中心 - 完整汉化

节点配置
节点配置 - 执行审批、安全策略管理

技能插件
技能插件 - 1Password、Apple Notes 等丰富扩展

常用命令

openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw dashboard          # 打开网页控制台
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

# 网关管理
openclaw gateway run        # 前台运行（挂终端，用于调试）
openclaw gateway start      # 后台守护进程（不挂终端，推荐！）
openclaw gateway stop       # 停止网关
openclaw gateway restart    # 重启网关
openclaw gateway status     # 查看网关状态
openclaw gateway install    # 安装为系统服务（开机自启）

# 常用操作
openclaw update             # 检查并更新 CLI
openclaw doctor             # 诊断问题（自动修复）

Windows 用户注意：如果 gateway install 失败（提示 schtasks 不可用），可使用 gateway start 启动后台进程，或使用 Docker 部署方案。

网关重启

# 方式 1：使用 gateway 子命令（推荐）
openclaw gateway restart

# 方式 2：先停止再启动
openclaw gateway stop
openclaw gateway start

# 方式 3：守护进程模式（后台运行，不挂终端）
openclaw daemon start       # 启动后台守护
openclaw daemon stop        # 停止守护
openclaw daemon restart    # 重启守护
openclaw daemon status     # 查看状态

# Docker 容器重启
docker restart openclaw

卸载教程

CLI 卸载

# 卸载汉化版
npm uninstall -g @qingchencloud/openclaw-zh

# 如果之前安装过原版，也一并卸载
npm uninstall -g openclaw

数据清理（可选）

# 删除配置和缓存（不可恢复！）
rm -rf ~/.openclaw

# Docker 清理
docker rm -f openclaw                # 删除容器
docker volume rm openclaw-data       # 删除数据卷

守护进程卸载

# macOS
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
rm ~/Library/LaunchAgents/com.openclaw.plist

# Linux (systemd)
sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

更新升级

npm update -g @qingchencloud/openclaw-zh

查看当前版本：openclaw --version

版本 安装命令 说明
稳定版 npm install -g @qingchencloud/openclaw-zh@latest 经过测试，推荐使用
最新版 npm install -g @qingchencloud/openclaw-zh@nightly 每小时同步上游，体验新功能

Docker 部署（国内推荐）

国内用户强烈推荐使用 Docker Hub 镜像，拉取速度快，无需翻墙！

镜像源 拉取命令 适用
Docker Hub（国内推荐） docker pull 1186258278/openclaw-zh:latest 国内用户
GitHub Container Registry docker pull ghcr.io/1186258278/openclaw-zh:latest 海外用户

一键部署（最简单）

# Linux/macOS — 加 --china 自动使用国内镜像
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash -s -- --china
# Windows PowerShell — 加 -China 自动使用国内镜像
irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex
# 或: .\docker-deploy.ps1 -China

手动 Docker 部署

# 国内用户使用 Docker Hub 镜像
IMAGE=1186258278/openclaw-zh:latest
# 海外用户使用: IMAGE=ghcr.io/1186258278/openclaw-zh:latest

# 1. 初始化（首次运行）
# Docker 需要交互式运行来配置 AI 模型和 API 密钥
docker run --rm -it -v openclaw-data:/root/.openclaw $IMAGE openclaw onboard

# 按向导完成：选择模型 → 配置 API 密钥 → 设置聊天通道

# 2. 配置网关模式
docker run --rm -v openclaw-data:/root/.openclaw $IMAGE openclaw config set gateway.mode local

# 3. 启动（守护进程模式，容器会一直运行）
docker run -d --name openclaw -p 18789:18789 \
  -v openclaw-data:/root/.openclaw --restart unless-stopped \
  $IMAGE openclaw gateway run

参数说明：

  • -d: 后台运行（守护进程模式）
  • --name openclaw: 给容器取名，方便管理
  • -p 18789:18789: 端口映射
  • --restart unless-stopped: 除非手动停止，否则一直运行
  • openclaw gateway run: 启动网关（容器启动命令）

访问：http://localhost:18789

完整指南（远程部署、Nginx 反代、Docker Compose、内网访问等）请查看 Docker 部署指南

其他安装方式

一键安装脚本（npm）

Linux / macOS：

curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh

Windows PowerShell：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1" -Encoding UTF8; powershell -ExecutionPolicy Bypass -File ".\install.ps1"

如遇中文乱码，直接用 npm 安装：npm install -g @qingchencloud/openclaw-zh@latest

npm 国内加速安装 
# 使用 npmmirror 镜像源（国内推荐）
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

# 或全局设置镜像源后再安装
npm config set registry https://registry.npmmirror.com
npm install -g @qingchencloud/openclaw-zh@latest
pnpm / yarn 安装 
# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest

# yarn
yarn global add @qingchencloud/openclaw-zh@latest
Git 克隆加速 
# 方案 1: 使用 GitHub 代理
git clone https://ghproxy.net/https://github.com/1186258278/OpenClawChineseTranslation.git

# 方案 2: 无需 git，直接用 npx 运行
npx @qingchencloud/openclaw-zh@latest

常见问题

🔥 Top 3 高频问题

❶ 安装卡住 / 下载慢

原因：npm 默认从国外源下载，国内网络可能很慢。

解决：加 --registry 参数使用国内镜像源，或直接用 Docker 部署：

# 方案 1：npm 加镜像源
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

# 方案 2：用 Docker（国内最快）
docker pull 1186258278/openclaw-zh:latest

详细说明 →

❷ 安装后还是英文界面

原因：系统上还残留了英文原版 openclaw，它的优先级高于汉化版。

解决：先卸载原版，再重装汉化版：

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

验证：openclaw --version 输出应包含 -zh 后缀。

详细说明 →

❸ 打开 Dashboard 报 `pairing required` 或 `token mismatch`

原因：OpenClaw 的安全机制要求设备配对或 Token 验证。

解决：

# token mismatch —— 用 dashboard 命令自动带 Token 打开：
openclaw dashboard

# pairing required —— 批准设备：
openclaw devices list           # 查看待批准设备 ID
openclaw devices approve <ID>   # 批准该设备

# Docker 用户如果无法运行 CLI，可以一键关闭设备认证：
docker run --rm -v openclaw-data:/root/.openclaw \
  1186258278/openclaw-zh:latest \
  openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
# 然后重启容器

token mismatch 详细说明 → | pairing required 详细说明 →

其他常见问题

问题 快速解决 详情
远程 / 内网访问不了 openclaw config set gateway.bind lan 然后重启 查看 →
镜像源版本落后 去掉 --registry 参数直接安装，或等待镜像同步（已自动触发） #32
Missing config 运行 openclaw onboard 初始化配置 查看 →
Missing workspace template 升级到最新版即可：npm install -g @qingchencloud/openclaw-zh@latest 查看 →
Ollama 无响应 检查 baseURL 是否为 http://localhost:11434/v1 查看 →
Docker 容器启动后退出 确保启动命令包含 openclaw gateway run 查看 →
Docker 打不开 Dashboard 设置 gateway.bind lan 监听所有网卡 查看 →

完整排查手册 (25+ 个问题) | Docker 问题排查

插件扩展

# 安装更新检测插件
npm install -g @qingchencloud/openclaw-updater

访问 插件市场 获取更多插件。

社区交流

Discord    元宝派

微信交流群

微信交流4群      微信交流5群
4群快满了，推荐扫码加入5群 | 碰到问题也可以直接在群内反馈

1~3群已满（点击查看）

微信交流1群      微信交流2群      微信交流3群
1群、2群、3群均已满200人

相关链接

汉化版 上游项目
汉化官网 OpenClaw 官网
npm 包 OpenClaw GitHub
GitHub 仓库 ClawHub 技能市场
GitHub Pages Discord 社区

参与贡献

关于

武汉晴辰天下网络科技有限公司 出品 | qingchencloud.com | MIT License

© 武汉晴辰天下网络科技有限公司 | 鄂ICP备2025164966号

About

🦞 OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入 | WhatsApp/Telegram/Discord 多平台 | 每小时自动同步 | CLI + Dashboard 全中文 | 全流程搭建教程，以及排错指南！

openclaw.qt.cool

Topics

nodejs open-source telegram localization discord chatbot whatsapp chinese lobster zh-cn ai-assistant claude-ai clawd clawdbot moltbot openclaw

Resources

Readme

License

View license

Contributing

Contributing
Activity

Stars

1.2k stars

Watchers

5 watching

Forks

161 forks
Report repository

Releases 25

🦞 OpenClaw 汉化版 v2026.2.14-zh.1 Latest
Feb 15, 2026
+ 24 releases

Packages

 
 
 

Contributors 14

Languages