每小时自动同步 OpenClaw 官方更新，汉化版延迟 < 1 小时！
OpenClaw 是 GitHub 100,000+ Stars 的开源个人 AI 助手平台。它运行在你的电脑上，通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。
本项目 = OpenClaw + 全中文界面，CLI 命令行和 Dashboard 网页控制台均已深度汉化。
前提条件：需要 Node.js >= 22（下载 Node.js）
检查版本：
node -v
npm install -g @qingchencloud/openclaw-zh@latestopenclaw onboard初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道
openclaw dashboard浏览器会自动打开全中文的 Dashboard 控制台。完成！
想了解每一步的详细说明？查看 详细安装指南（包含 Node.js 安装、模型配置、守护进程、内网访问等）
概览仪表板 - 网关状态、实例监控、快捷操作一目了然
查看更多截图
对话界面 - 与 AI 助手实时交互
渠道管理 - WhatsApp、Telegram、Discord 等全平台支持
配置中心 - 完整汉化
节点配置 - 执行审批、安全策略管理
技能插件 - 1Password、Apple Notes 等丰富扩展
openclaw # 启动 OpenClaw
openclaw onboard # 初始化向导
openclaw dashboard # 打开网页控制台
openclaw config # 查看/修改配置
openclaw skills # 管理技能
openclaw --help # 查看帮助npm update -g @qingchencloud/openclaw-zh查看当前版本：
openclaw --version
| 版本 | 安装命令 | 说明 |
|---|---|---|
| 稳定版 | npm install -g @qingchencloud/openclaw-zh@latest |
经过测试，推荐使用 |
| 最新版 | npm install -g @qingchencloud/openclaw-zh@nightly |
每小时同步上游，体验新功能 |
国内用户强烈推荐使用 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 Hub 镜像
IMAGE=1186258278/openclaw-zh:latest
# 海外用户使用: IMAGE=ghcr.io/1186258278/openclaw-zh:latest
# 1. 初始化
docker run --rm -v openclaw-data:/root/.openclaw $IMAGE openclaw setup
docker run --rm -v openclaw-data:/root/.openclaw $IMAGE openclaw config set gateway.mode local
# 2. 启动
docker run -d --name openclaw -p 18789:18789 \
-v openclaw-data:/root/.openclaw --restart unless-stopped \
$IMAGE 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.shWindows 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@latestpnpm / yarn 安装
# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest
# yarn
yarn global add @qingchencloud/openclaw-zh@latestGit 克隆加速
# 方案 1: 使用 GitHub 代理
git clone https://ghproxy.net/https://github.com/1186258278/OpenClawChineseTranslation.git
# 方案 2: 无需 git，直接用 npx 运行
npx @qingchencloud/openclaw-zh@latest❶ 安装卡住 / 下载慢
原因：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
# 然后重启容器| 问题 | 快速解决 | 详情 |
|---|---|---|
| 远程 / 内网访问不了 | openclaw config set gateway.bind lan 然后重启 |
查看 → |
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 监听所有网卡 |
查看 → |
# 安装更新检测插件
npm install -g @qingchencloud/openclaw-updater访问 插件市场 获取更多插件。
| 汉化版 | 上游项目 |
|---|---|
| 汉化官网 | OpenClaw 官网 |
| npm 包 | OpenClaw GitHub |
| GitHub 仓库 | ClawHub 技能市场 |
| GitHub Pages | Discord 社区 |
武汉晴辰天下网络科技有限公司 出品 | qingchencloud.com | MIT License
© 武汉晴辰天下网络科技有限公司 | 鄂ICP备2025164966号