OpenClaw开源汉化发行版：介绍、下载、安装、配置教程
OpenClaw开源汉化发行版：介绍、下载、安装、配置教程
🎬 背景
🦞 想要一个 100% 私有化、全中文界面的 AI 助手？ OpenClaw 汉化版让你零门槛拥有！
这是 GitHub 100,000+ Stars 明星项目的开源中文发行版——不仅做了深度界面汉化（CLI + Dashboard 全中文），更实现了每小时自动同步官方更新，汉化版延迟 < 1 小时，让你既享受中文体验，又不掉队最新功能。
通过 WhatsApp、Telegram、Discord 就能指挥你的 AI 处理邮件、日历、文件，数据完全本地掌控，告别隐私焦虑。无论你是 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 步：安装
npminstall -g @qingchencloud/openclaw-zh@latest 第 2 步：初始化
openclaw onboard 初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道
第 3 步：打开控制台
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 | 每小时同步上游，体验新功能 |
其他安装方式
完整的手动安装教程（含 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]::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@latestDocker 部署
快速启动：
# 初始化配置docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:latest openclaw setup docker 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 安装
# pnpmpnpmadd -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 + 设置 Token + 重启 | 查看 |
Missing config | 运行 openclaw onboard 初始化 | 查看 |
Missing workspace template | 2026.2.4-zh.1 及更早版本的已知 Bug，升级即可修复：npm install -g @qingchencloud/openclaw-zh@latest | 查看 |
| Ollama 无响应 | 检查 baseURL 配置是否为 http://localhost:11434/v1 | 查看 |
插件扩展
# 安装更新检测插件npminstall -g @qingchencloud/openclaw-updater 🏁 总结
🎉 恭喜！ 你现在拥有了一个完全中文化的私有化 AI 助手。
从 3 步快速上手到汉化界面体验，从常用命令到插件扩展——OpenClaw 汉化版让「个人 AI 助理」真正触手可及。数据本地存储、多平台即时交互、自动化任务处理，这些曾经复杂的功能，现在开源免费且中文友好。
forks项目仓库 ：https://github.com/MaoTouHU/OpenClawChinese
现在，向你的 AI 助手发出第一条中文指令吧！ 🚀
