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 步：安装

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                    # 启动 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@latest

Docker 部署

快速启动：

# 初始化配置
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 安装

# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest

# yarn
yarn 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	查看

---

插件扩展

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

🏁 总结

🎉 恭喜！ 你现在拥有了一个完全中文化的私有化 AI 助手。

从 3 步快速上手到汉化界面体验，从常用命令到插件扩展——OpenClaw 汉化版让「个人 AI 助理」真正触手可及。数据本地存储、多平台即时交互、自动化任务处理，这些曾经复杂的功能，现在开源免费且中文友好。

forks项目仓库 ：https://github.com/MaoTouHU/OpenClawChinese

现在，向你的 AI 助手发出第一条中文指令吧！ 🚀