OpenClaw 汉化版提供开源个人 AI 助手的中文界面，支持 WhatsApp/Telegram/Discord 多平台接入，集成 Claude/ChatGPT 等模型。本页包含安装教程、Docker 部署、免费 AI 接口推荐及常见问题排错，帮助中文用户快速搭建。
OpenClaw 汉化发行版是基于开源个人 AI 助手平台 OpenClaw 的中文本地化版本，提供全中文 CLI 与 Dashboard 界面，支持 WhatsApp/Telegram/Discord 多平台接入，每小时自动同步官方更新，降低中文用户使用门槛。
OpenClaw 汉化版是开源个人 AI 助手平台 OpenClaw 的中文本地化发行版，由武汉晴辰天下网络科技有限公司维护。项目核心定位是降低中文用户使用门槛，提供全中文界面的命令行工具（CLI）与网页管理控制台（Dashboard）。用途涵盖个人 AI 助手部署、多平台聊天集成（WhatsApp/Telegram/Discord）、自动化任务处理，以及作为连接各类大语言模型（如 Claude、ChatGPT 及国产模型）的统一网关。项目每小时自动同步官方更新，确保功能与汉化内容同步。
主要解决 OpenClaw 官方界面英文带来的使用障碍，为不熟悉英文的用户提供本地化界面和中文文档；简化复杂部署流程，提供一键安装脚本与 Docker 方案；整合免费 AI 接口资源（如 gpt.qt.cool），降低使用成本；提供系统化的排错指南（docs/FAQ.md），覆盖安装、启动、网络、模型对话等常见问题，减少用户自行摸索的时间。
适用于希望使用 AI 助手处理日常事务（如邮件、日历、文件）的中文个人用户；需要在 WhatsApp、Telegram、Discord 等社交平台集成 AI 对话或自动化功能的开发者或爱好者；寻求免费或低成本 AI 接口的中文开发者；以及需要完整中文文档和排错指南进行本地或服务器部署的技术人员。项目也适合作为学习 OpenClaw 架构与多平台 Bot 开发的入门案例。
仓库中明确提供三种安装方式：1) 脚本安装：Linux/macOS 运行根目录 install.sh，Windows 运行 install.ps1；2) Docker 部署：使用 docker-deploy.sh/ps1 一键脚本或 docker-compose.yml 启动容器，支持本地与远程服务器部署，并可配置 Nginx 反代与 HTTPS；3) npm 全局安装：通过 npm install -g @qingchencloud/openclaw-zh 安装包后使用 openclaw-zh-cli 命令管理。详细步骤参考 docs/INSTALL_GUIDE.md 与 docs/DOCKER_GUIDE.md。
部署后，通过 CLI 命令管理汉化状态：openclaw-zh-cli status 查看状态，apply 应用汉化补丁，verify 验证翻译完整性，restore 恢复原版界面。访问 Dashboard（默认 http://localhost:18789）进行可视化配置。首次运行需初始化 AI 提供商：可选择 OpenAI Compatible 或免费平台（如 gpt.qt.cool），通过 openclaw onboard 交互式配置或 openclaw config set 命令设置 API 地址与密钥。免费平台需签到获取额度，实现持续使用。遇到问题查阅 docs/FAQ.md 获取分类解决方案。
项目基于 Node.js（要求 >=22.12.0）开发，以 CLI 工具为核心，通过 JSON 格式翻译资源实现界面汉化，资源按模块组织于 translations/ 目录。汉化机制支持动态补丁应用与恢复，不修改上游源码。包含辅助脚本如翻译验证（validate-translations.mjs）、未翻译检测（detect-untranslated.mjs）及 Dashboard 功能面板注入（inject_panel.py）。文档系统完善，除基础指南外，还提供国产模型配置（docs/guides/models-cn.md）、中国网络优化（china-network.md）、飞书集成、NAS 部署等专题。项目遵循 MIT 许可证，欢迎通过 CONTRIBUTING.md 参与翻译贡献。
提供三种方式：1) 运行系统对应安装脚本（Linux/macOS 用 install.sh，Windows 用 install.ps1）；2) 使用 Docker 部署（docker-deploy.sh/ps1 或 docker-compose.yml）；3) 通过 npm 全局安装包 @qingchencloud/openclaw-zh。详细步骤见 docs/INSTALL_GUIDE.md 与 docs/DOCKER_GUIDE.md。
首先确认服务已启动且端口 18789 未被占用；检查本地防火墙或服务器安全组是否放行该端口；若使用 Docker，确保容器运行正常（docker ps）。远程访问需配置反向代理（Nginx）并设置 Token 认证，参考 docs/DOCKER_GUIDE.md 的远程访问与 Nginx 章节。更多排查见 docs/FAQ.md 的 Dashboard 问题部分。
初始化时运行 openclaw onboard 进行交互式配置，选择 AI 提供商（如 OpenAI Compatible）并填入 API 地址与密钥。也可使用 openclaw config set 命令手动设置模型、baseURL 和 apiKey。项目推荐免费平台 gpt.qt.cool，注册后签到获取额度，填入 Key 即可使用。国产模型配置见 docs/guides/models-cn.md。
使用 openclaw-zh-cli 命令管理：openclaw-zh-cli apply 应用汉化，openclaw-zh-cli restore 恢复原版界面，openclaw-zh-cli status 查看当前汉化状态，openclaw-zh-cli verify 验证翻译完整性。该工具基于 translations/ 目录的 JSON 资源动态注入，不修改上游代码。
项目推荐内部公益平台 gpt.qt.cool，注册后每日签到可领取免费额度，邀请好友获得更多，支持 OpenAI 兼容接口，即开即用。此外，合作伙伴胜算云（shengsuanyun.com）提供国内 AI API 聚合，新用户送额度且充值享 7 折。免费平台配置方式见 README 的“🎁 免费AI接口”章节。