OpenClaw汉化发行版

itHub星标超10万的开源个人AI助手平台OpenClaw，因强大的本地部署能力、多聊天应用适配（WhatsApp/Telegram/Discord等）和全场景事务处理能力（邮件/日历/文件管理）广受好评，但纯英文界面和命令行让国内用户上手门槛较高。

现在无需手动汉化！OpenClaw汉化发行版已上线——不仅将CLI命令行、Dashboard网页控制台全部深度汉化，还能每小时自动同步OpenClaw官方更新，汉化版延迟低于1小时，既保留原版全部功能，又适配国内用户的使用习惯，3步即可完成安装部署，零基础也能快速上手。

什么是OpenClaw？

OpenClaw是一款可本地运行的开源个人AI助手平台，核心优势在于：

• 本地化部署：运行在你的电脑上，数据不泄露，隐私更可控；
• 多端交互：通过WhatsApp、Telegram、Discord等聊天应用即可和AI助手对话；
• 全场景处理：帮你自动化处理邮件、日历、文件管理等日常事务；
• 高社区认可度：GitHub星标超10万，功能迭代快、生态完善。

而本次的汉化发行版 = OpenClaw原版核心功能 + 全中文界面（CLI+Dashboard），且保持与官方版本的实时同步，无需担心功能滞后。

3步极速上手，零基础也能搞定

前提条件

必须安装 Node.js >= 22（低于22版本会导致安装/运行失败）：

• 下载地址：Node.js官方下载页（https://nodejs.org/）
• 检查版本：安装后打开终端/命令行，输入 node -v，确认版本号≥22即可。

第1步：安装汉化版（多包管理器支持）

推荐使用npm全局安装，也支持pnpm/yarn，命令如下：

# npm（推荐）
npm install -g @qingchencloud/openclaw-zh@latest

# 若安装卡住/下载慢，添加国内镜像源
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

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

# yarn
yarn global add @qingchencloud/openclaw-zh@latest

第2步：初始化配置（可视化向导）

运行初始化命令，按中文向导提示完成配置，全程无需懂英文：

openclaw onboard

向导会引导你完成3个核心配置：

1. 选择AI模型（如OpenAI、Ollama等）；
2. 配置模型API密钥（按需填写）；
3. 设置聊天通道（WhatsApp/Telegram等）。

第3步：打开中文控制台

运行命令后，浏览器会自动打开全中文的Dashboard网页控制台，至此完成部署：

openclaw dashboard

常用命令速查（全中文交互）

版本更新与升级

• 稳定版（推荐）：始终安装最新测试通过的版本，命令：npm install -g @qingchencloud/openclaw-zh@latest；
• 最新版（尝鲜）：每小时同步官方更新，体验最新功能，命令：npm install -g @qingchencloud/openclaw-zh@nightly；
• 升级已安装版本：npm update -g @qingchencloud/openclaw-zh。

进阶部署：Docker一键启动（适合服务器/团队场景）

如果需要在服务器部署，或不想配置Node.js环境，可使用Docker快速启动，数据持久化且无需担心依赖问题：

步骤1：初始化配置

# 初始化配置并设置网关模式为本地
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

步骤2：启动容器

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 即可打开中文Dashboard，若需远程/内网访问，可参考下文「常见问题」解决。

完整Docker部署指南（含远程访问、Nginx反代、Docker Compose）可查看官方文档，覆盖更复杂的部署场景。

一键安装脚本（懒人专属）

如果觉得手动安装麻烦，可使用一键脚本，自动完成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。

常见问题速解（25+问题完整排查见文末）

完整排查手册（含25+常见问题）、Docker专属问题排查可查看官方文档，覆盖绝大多数使用场景。

插件扩展：丰富AI助手能力

汉化版兼容OpenClaw原版插件生态，也可安装专属扩展插件，例如：

# 安装更新检测插件（实时提醒版本更新）
npm install -g @qingchencloud/openclaw-updater

更多插件可访问「OpenClaw插件市场」获取，覆盖自动化、多模型适配、自定义技能等场景。

适合谁用？

1. 个人用户：想搭建本地部署的AI助手，处理日常事务（邮件/文件/日历），且偏好中文界面；
2. 开发者：基于OpenClaw二次开发，中文界面降低调试、配置门槛；
3. 小团队：通过Docker部署在服务器，共享AI助手能力，适配多聊天应用交互场景。

OpenClaw汉化发行版的核心价值在于“无门槛使用10万星开源AI助手”——既保留原版的强大功能和实时更新，又通过全中文化降低国内用户的上手成本，无论是个人使用还是二次开发，都是性价比极高的选择。