<a id="top"></a>

OpenClaw 汉化发行版

每小时自动同步 OpenClaw 官方更新，汉化版延迟 < 1 小时！

<p align="center"> <a href="https://openclaw.qt.cool/"><img src="https://img.shields.io/badge/🔥_汉化官网-openclaw.qt.cool-dc2626?style=for-the-badge" alt="汉化官网"></a> </p>

<a id="toc"></a>

🦀 ClawPanel — 内置 AI 助手的可视化管理面板 | 📱 ClawApp — 手机端聊天客户端 | 查看生态工具 →

目录

什么是 OpenClaw？ · 🎁 免费AI接口 · 4 步上手 · 汉化效果预览 · 常用命令 · 网关重启 · 卸载教程 · 更新升级 · Docker 部署 · 其他安装方式 · 手机端 ClawApp · 常见问题 · 插件扩展 · 社区交流 · 相关链接 · 参与贡献 · 关于

子文档导航：

• 安装指南 — 前提条件 · 安装 · 初始化配置 · 验证运行 · 进阶配置 · 模型配置 · 守护进程
• Docker 部署指南 — 一键部署 · 本地启动 · 远程部署 · Token 认证 · Nginx 反代 · Docker Compose · 错误排查
• 常见问题 — 安装问题 · 启动问题 · Dashboard 连不上 · 内网/远程访问 · 模型和对话 · 其他问题
• 贡献指南 — 环境准备 · 项目结构 · 添加新翻译 · 提交 PR
• 翻译规范 — 术语表 · 翻译原则 · 风格指南

---

<a id="what-is-openclaw"></a>

什么是 OpenClaw？

OpenClaw 是 GitHub 195,000+ Stars 的开源个人 AI 助手平台。它运行在你的电脑上，通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。

本项目 = OpenClaw + 全中文界面，CLI 命令行和 Dashboard 网页控制台均已深度汉化。

<p align="right"><a href="#top">回到顶部</a></p>

---

<a id="free-ai"></a>

🎁 免费 AI 接口

内部公益平台，免费使用主流 AI 模型！ 签到领额度，邀请得更多，持续免费用 AI！

<p align="center"> <a href="https://gpt.qt.cool/"><img src="https://img.shields.io/badge/🚀_免费AI接口-gpt.qt.cool-10b981?style=for-the-badge" alt="免费AI接口"></a> </p>

平台亮点：

• � 签到领免费额度 — 每日签到 + 邀请好友，持续获取免费使用额度
• 💰 不满意可退 — 用着不爽随时退款，零风险体验
• ⚡ 兼容 OpenAI 接口 — 无缝对接 OpenClaw，即开即用
• 🔒 内部公益项目 — 长期维护，安全稳定

配合 OpenClaw 使用：

在 gpt.qt.cool 注册并签到领取免费额度，获取 API Key 后，初始化 OpenClaw 时选择 OpenAI Compatible 提供商，填入地址和 Key 即可使用。

💡 小贴士：每日签到 + 邀请好友即可持续获取免费额度，搭配 OpenClaw 等于拥有一个免费私人 AI 助手！

立即使用 →

<a id="partners"></a>

合作伙伴

胜算云 - 国内 AI API 聚合平台，新用户注册送额度，充值尊享 7 折优惠！

注册账号 →

<p align="right"><a href="#top">回到顶部</a></p>

---

<a id="ecosystem"></a>

🔥 生态工具

<table> <tr> <td width="50%"> <h3>🦀 <a href="https://github.com/qingchencloud/clawpanel">ClawPanel</a></h3> <p><strong>内置 AI 助手</strong>的 OpenClaw 可视化管理面板</p> <ul> <li>🤖 AI 助手 — 8 大工具 + 4 种模式，自动诊断配置</li> <li>🖼️ 图片识别 — 粘贴截图，AI 一眼看懂</li> <li>⚡ 一键安装 — 自动检测环境，无需终端</li> <li>🎛️ 可视化管理 — 模型、Gateway、Agent</li> </ul> <p> <a href="https://github.com/qingchencloud/clawpanel/releases/latest"><img src="https://img.shields.io/github/v/release/qingchencloud/clawpanel?style=flat-square&color=6366f1&label=latest" alt="Release"></a> <a href="https://claw.qt.cool/"><img src="https://img.shields.io/badge/site-claw.qt.cool-8b5cf6?style=flat-square" alt="Site"></a> </p> <details> <summary>📸 预览截图（点击展开）</summary> <br> <img src="https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/ai-assistant-demo.gif" width="100%" alt="ClawPanel AI Demo"> <br><br> <img src="https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/00.png" width="100%" alt="ClawPanel AI"> <br><br> <img src="https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/13.png" width="100%" alt="ClawPanel Vision"> <br><br> <img src="https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/01.png" width="100%" alt="ClawPanel Dashboard"> </details> </td> <td width="50%"> <h3>📱 <a href="https://github.com/qingchencloud/clawapp">ClawApp</a></h3> <p>用手机浏览器和 OpenClaw AI 智能体聊天</p> <ul> <li>💬 流式聊天 — WebSocket 实时对话</li> <li>📷 图片收发 — 拍照上传，AI 图片回复</li> <li>🔧 工具调用 — 实时状态显示</li> <li>📱 PWA + APK — 添加到主屏幕</li> </ul> <p> <a href="https://github.com/qingchencloud/clawapp/releases/latest"><img src="https://img.shields.io/github/v/release/qingchencloud/clawapp?style=flat-square&color=10b981&label=latest" alt="Release"></a> <a href="https://clawapp.qt.cool/"><img src="https://img.shields.io/badge/site-clawapp.qt.cool-10b981?style=flat-square" alt="Site"></a> </p> <details> <summary>📸 预览截图（点击展开）</summary> <br> <img src="https://raw.githubusercontent.com/qingchencloud/clawapp/main/docs/image/chat-response.png" width="280" alt="ClawApp Chat"> <img src="https://raw.githubusercontent.com/qingchencloud/clawapp/main/docs/image/login-page.png" width="280" alt="ClawApp Login"> </details> </td> </tr> </table> <p align="right"><a href="#top">回到顶部</a></p>

---

<a id="quickstart"></a>

4 步上手

前提条件：需要 Node.js >= 22（下载 Node.js）

检查版本：node -v

第 1 步：安装

npm install -g @qingchencloud/openclaw-zh@latest

第 2 步：初始化（推荐守护进程模式）

openclaw onboard --install-daemon

初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道

第 3 步：启动网关

openclaw gateway

第 4 步：打开控制台

openclaw dashboard

浏览器会自动打开全中文的 Dashboard 控制台。完成！

想了解每一步的详细说明？查看 详细安装指南（包含 Node.js 安装、模型配置、守护进程、内网访问等）

<p align="right"><a href="#top">回到顶部</a></p>

---

<a id="preview"></a>

汉化效果预览

<p align="center"> <img src="docs/image/5.png" alt="概览仪表板" width="100%"> <br> <em>概览仪表板 - 网关状态、实例监控、快捷操作一目了然</em> </p> <details> <summary><b>查看更多截图</b></summary> <p align="center"> <img src="docs/image/1.png" alt="对话界面" width="100%"> <br> <em>对话界面 - 与 AI 助手实时交互</em> </p> <p align="center"> <img src="docs/image/4.png" alt="渠道管理" width="100%"> <br> <em>渠道管理 - WhatsApp、Telegram、Discord 等全平台支持</em> </p> <p align="center"> <img src="docs/image/2.png" alt="配置中心" width="100%"> <br> <em>配置中心 - 完整汉化</em> </p> <p align="center"> <img src="docs/image/3.png" alt="节点配置" width="100%"> <br> <em>节点配置 - 执行审批、安全策略管理</em> </p> <p align="center"> <img src="docs/image/6.png" alt="技能插件" width="100%"> <br> <em>技能插件 - 1Password、Apple Notes 等丰富扩展</em> </p> </details> <p align="right"><a href="#top">回到顶部</a></p>

---

<a id="commands"></a>

常用命令

openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw dashboard          # 打开网页控制台
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

# 网关管理
openclaw gateway run        # 前台运行（挂终端，用于调试）
openclaw gateway start      # 后台守护进程（不挂终端，推荐！）
openclaw gateway stop       # 停止网关
openclaw gateway restart    # 重启网关
openclaw gateway status     # 查看网关状态
openclaw gateway install    # 安装为系统服务（开机自启）

# 常用操作
openclaw update             # 检查并更新 CLI
openclaw doctor             # 诊断问题（自动修复）

Windows 用户注意：如果 gateway install 失败（提示 schtasks 不可用），可使用 gateway start 启动后台进程，或使用 Docker 部署方案。

Dashboard 语言设置：首次打开网页控制台后，前往 Overview 页面底部，将 Language 切换为 简体中文 (Simplified Chinese)，即可显示中文界面。设置后刷新页面生效。

<p align="right"><a href="#top">回到顶部</a></p>

---

<a id="gateway-restart"></a>

网关重启

# 方式 1：使用 gateway 子命令（推荐）
openclaw gateway restart

# 方式 2：先停止再启动
openclaw gateway stop
openclaw gateway start

# 方式 3：守护进程模式（后台运行，不挂终端）
openclaw daemon start       # 启动后台守护
openclaw daemon stop        # 停止守护
openclaw daemon restart    # 重启守护
openclaw daemon status     # 查看状态

# Docker 容器重启
docker restart openclaw

<p align="right"><a href="#top">回到顶部</a></p>

---

<a id="uninstall"></a>

卸载教程

CLI 卸载

# 卸载汉化版
npm uninstall -g @qingchencloud/openclaw-zh

# 如果之前安装过原版，也一并卸载
npm uninstall -g openclaw

数据清理（可选）

# 删除配置和缓存（不可恢复！）
rm -rf ~/.openclaw

# Docker 清理
docker rm -f openclaw                # 删除容器
docker volume rm openclaw-data       # 删除数据卷

守护进程卸载

# macOS
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
rm ~/Library/LaunchAgents/com.openclaw.plist

# Linux (systemd)
sudo systemctl