OpenClaw开源汉化发行版:介绍、下载、安装、配置教程
🎬 背景
🦞 想要一个 100% 私有化、全中文界面的 AI 助手? OpenClaw 汉化版让你零门槛拥有!
这是 GitHub 100,000+ Stars 明星项目第三方开源中文发行版——不仅做了深度界面汉化(CLI + Dashboard 全中文),更实现了每小时自动同步官方更新,汉化版延迟 < 1 小时,让你既享受中文体验,又不掉队最新功能。
无论你是 Docker 老手还是命令行小白,3 步即可上手,本教程覆盖安装、配置、升级、排障全流程。
🔗 开源forks地址:MaoTouHU/OpenClawChinese(持续更新,建议 Star 收藏)
什么是 OpenClaw?
OpenClaw 是 GitHub 100,000+ Stars 的开源个人 AI 助手平台。它运行在你的电脑上,通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互,帮你处理邮件、日历、文件等日常事务。
本项目 = OpenClaw + 全中文界面,CLI 命令行和 Dashboard 网页控制台均已深度汉化。
每小时自动同步OpenClaw 官方更新,汉化版延迟 < 1 小时!
forks项目仓库 :https://github.com/MaoTouHU/OpenClawChinese
3 步上手
前提条件:需要 Node.js >= 22(下载 Node.js)
检查版本:node -v
第 1 步:安装
npm install -g @qingchencloud/openclaw-zh@latest
第 2 步:初始化
openclaw onboard
初始化向导会引导你完成:选择 AI 模型 → 配置 API 密钥 → 设置聊天通道
第 3 步:打开控制台
openclaw dashboard
浏览器会自动打开全中文的 Dashboard 控制台。完成!
想了解每一步的详细说明?查看 详细安装指南(包含 Node.js 安装、模型配置、守护进程、内网访问等)
汉化效果预览
概览仪表板 - 网关状态、实例监控、快捷操作一目了然
更多截图
对话界面 - 与 AI 助手实时交互
渠道管理 - WhatsApp、Telegram、Discord 等全平台支持
配置中心 - 完整汉化
节点配置 - 执行审批、安全策略管理
技能插件 - 1Password、Apple Notes 等丰富扩展
常用命令
openclaw # 启动 OpenClawopenclaw 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 | |
其他安装方式
完整的手动安装教程(含 Node.js 安装、各系统配置、守护进程管理)请查看 详细安装指南
一键安装脚本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]::UTF8Invoke-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
Docker 部署快速启动:
# 初始化配置docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:latest openclaw setupdocker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:latest openclaw config set gateway.mode local# 启动容器docker run -d --name openclaw -p 18789:18789 \ -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:latest openclaw gateway run
访问:http://localhost:18789
完整 Docker 指南(远程部署、Nginx 反代、Docker Compose 等)请查看 Docker 部署指南
pnpm / yarn 安装# pnpmpnpm add -g @qingchencloud/openclaw-zh@latest# yarnyarn global add @qingchencloud/openclaw-zh@latest
常见问题
| | |
|---|
| 安装卡住 / 下载慢 | 加镜像源:npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com | |
| 安装后还是英文 | 先卸载原版:npm uninstall -g openclaw && npm install -g @qingchencloud/openclaw-zh@latest | |
token mismatch | 运行 openclaw dashboard 自动打开带 Token 的 URL | |
pairing required | openclaw devices list 然后 openclaw devices approve <ID> | |
| 远程 / 内网访问不了 | openclaw config set gateway.bind lan | |
Missing config | | |
Missing workspace template | 2026.2.4-zh.1 及更早版本的已知 Bug,升级即可修复:npm install -g @qingchencloud/openclaw-zh@latest | |
| Ollama 无响应 | 检查 baseURL 配置是否为 http://localhost:11434/v1 | |
插件扩展
# 安装更新检测插件npm install -g @qingchencloud/openclaw-updater
🏁 总结
🎉 恭喜! 你现在拥有了一个完全中文化的私有化 AI 助手。
从 3 步快速上手到汉化界面体验,从常用命令到插件扩展——OpenClaw 汉化版让「个人 AI 助理」真正触手可及。数据本地存储、多平台即时交互、自动化任务处理,这些曾经复杂的功能,现在开源免费且中文友好。
forks项目仓库 :https://github.com/MaoTouHU/OpenClawChinese
现在,向你的 AI 助手发出第一条中文指令吧! 🚀