{"id":42951646,"url":"https://github.com/1186258278/openclawchinesetranslation","last_synced_at":"2026-06-14T08:01:57.795Z","repository":{"id":335535811,"uuid":"1145977416","full_name":"1186258278/OpenClawChineseTranslation","owner":"1186258278","description":"🦞 OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入 | WhatsApp/Telegram/Discord 多平台 | 每小时自动同步 | CLI + Dashboard 全中文 | 全流程搭建教程，以及排错指南！","archived":false,"fork":false,"pushed_at":"2026-06-13T09:54:35.000Z","size":5382,"stargazers_count":3804,"open_issues_count":52,"forks_count":479,"subscribers_count":18,"default_branch":"main","last_synced_at":"2026-06-13T10:09:10.798Z","etag":null,"topics":["ai-agent","ai-assistant","chatbot","chinese","claude-ai","clawd","clawdbot","discord","llm","lobster","localization","moltbot","nodejs","open-source","openclaw","telegram","tool-calling","whatsapp","zh-cn"],"latest_commit_sha":null,"homepage":"https://openclaw.qt.cool","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1186258278.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-30T13:12:57.000Z","updated_at":"2026-06-13T09:03:43.000Z","dependencies_parsed_at":"2026-04-22T07:02:33.077Z","dependency_job_id":null,"html_url":"https://github.com/1186258278/OpenClawChineseTranslation","commit_stats":null,"previous_names":["1186258278/openclawchinesetranslation"],"tags_count":86,"template":false,"template_full_name":null,"purl":"pkg:github/1186258278/OpenClawChineseTranslation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1186258278%2FOpenClawChineseTranslation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1186258278%2FOpenClawChineseTranslation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1186258278%2FOpenClawChineseTranslation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1186258278%2FOpenClawChineseTranslation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1186258278","download_url":"https://codeload.github.com/1186258278/OpenClawChineseTranslation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1186258278%2FOpenClawChineseTranslation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34313515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","ai-assistant","chatbot","chinese","claude-ai","clawd","clawdbot","discord","llm","lobster","localization","moltbot","nodejs","open-source","openclaw","telegram","tool-calling","whatsapp","zh-cn"],"created_at":"2026-01-30T21:13:03.085Z","updated_at":"2026-06-14T08:01:57.788Z","avatar_url":"https://github.com/1186258278.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca id=\"top\"\u003e\u003c/a\u003e\n\n# OpenClaw 汉化发行版\n\n[![Release](https://img.shields.io/github/v/release/1186258278/OpenClawChineseTranslation?label=稳定版)](https://github.com/1186258278/OpenClawChineseTranslation/releases)\n[![npm](https://img.shields.io/npm/v/@qingchencloud/openclaw-zh?label=npm)](https://www.npmjs.com/package/@qingchencloud/openclaw-zh)\n[![Nightly Build](https://github.com/1186258278/OpenClawChineseTranslation/actions/workflows/nightly.yml/badge.svg)](https://github.com/1186258278/OpenClawChineseTranslation/actions/workflows/nightly.yml)\n[![Platform](https://img.shields.io/badge/平台-Windows%20|%20macOS%20|%20Linux-blue)](https://github.com/1186258278/OpenClawChineseTranslation/releases)\n[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\n\u003e **每小时自动同步** [OpenClaw](https://github.com/openclaw/openclaw) 官方更新，汉化版延迟 \u003c 1 小时！\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://openclaw.qt.cool/\"\u003e\u003cimg src=\"https://img.shields.io/badge/🔥_汉化官网-openclaw.qt.cool-dc2626?style=for-the-badge\" alt=\"汉化官网\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ca id=\"toc\"\u003e\u003c/a\u003e\n\n\u003e 🦀 **[ClawPanel](https://github.com/qingchencloud/clawpanel)** — 内置 AI 助手的可视化管理面板 | 📱 **[ClawApp](https://github.com/qingchencloud/clawapp)** — 手机端聊天客户端 | [查看生态工具 →](#ecosystem)\n\n\n## 目录\n\n[什么是 OpenClaw？](#what-is-openclaw) ·\n[🎁 免费AI接口](#free-ai) ·\n[4 步上手](#quickstart) ·\n[汉化效果预览](#preview) ·\n[常用命令](#commands) ·\n[网关重启](#gateway-restart) ·\n[卸载教程](#uninstall) ·\n[更新升级](#upgrade) ·\n[Docker 部署](#docker) ·\n[其他安装方式](#other-install) ·\n[手机端 ClawApp](#mobile) ·\n[常见问题](#faq) ·\n[插件扩展](#plugins) ·\n[社区交流](#community) ·\n[相关链接](#links) ·\n[参与贡献](#contributing) ·\n[关于](#about)\n\n**子文档导航：**\n\n- **[安装指南](docs/INSTALL_GUIDE.md)** — [前提条件](docs/INSTALL_GUIDE.md#prerequisites) · [安装](docs/INSTALL_GUIDE.md#phase1-install) · [初始化配置](docs/INSTALL_GUIDE.md#phase2-config) · [验证运行](docs/INSTALL_GUIDE.md#phase3-verify) · [进阶配置](docs/INSTALL_GUIDE.md#phase4-advanced) · [模型配置](docs/INSTALL_GUIDE.md#model-config) · [守护进程](docs/INSTALL_GUIDE.md#daemon)\n- **[Docker 部署指南](docs/DOCKER_GUIDE.md)** — [一键部署](docs/DOCKER_GUIDE.md#quick-deploy) · [本地启动](docs/DOCKER_GUIDE.md#local-start) · [远程部署](docs/DOCKER_GUIDE.md#remote-deploy) · [Token 认证](docs/DOCKER_GUIDE.md#remote-access) · [Nginx 反代](docs/DOCKER_GUIDE.md#nginx-https) · [Docker Compose](docs/DOCKER_GUIDE.md#docker-compose) · [错误排查](docs/DOCKER_GUIDE.md#troubleshoot)\n- **[常见问题](docs/FAQ.md)** — [安装问题](docs/FAQ.md#install-issues) · [启动问题](docs/FAQ.md#startup-issues) · [Dashboard 连不上](docs/FAQ.md#dashboard-issues) · [内网/远程访问](docs/FAQ.md#network-issues) · [模型和对话](docs/FAQ.md#model-issues) · [其他问题](docs/FAQ.md#other-issues)\n- **[贡献指南](docs/CONTRIBUTING.md)** — [环境准备](docs/CONTRIBUTING.md#setup) · [项目结构](docs/CONTRIBUTING.md#structure) · [添加新翻译](docs/CONTRIBUTING.md#add-translation) · [提交 PR](docs/CONTRIBUTING.md#submit-pr)\n- **[翻译规范](docs/TRANSLATION_GUIDE.md)** — [术语表](docs/TRANSLATION_GUIDE.md#glossary) · [翻译原则](docs/TRANSLATION_GUIDE.md#principles) · [风格指南](docs/TRANSLATION_GUIDE.md#style-guide)\n\n---\n\n\u003ca id=\"what-is-openclaw\"\u003e\u003c/a\u003e\n\n## 什么是 OpenClaw？\n\n[OpenClaw](https://openclaw.ai/) 是 GitHub 195,000+ Stars 的**开源个人 AI 助手平台**。它运行在你的电脑上，通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。\n\n**本项目 = OpenClaw + 全中文界面**，CLI 命令行和 Dashboard 网页控制台均已深度汉化。\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"free-ai\"\u003e\u003c/a\u003e\n\n## 🎁 免费 AI 接口\n\n\u003e **内部公益平台，免费使用主流 AI 模型！** 签到领额度，邀请得更多，持续免费用 AI！\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://gpt.qt.cool/\"\u003e\u003cimg src=\"https://img.shields.io/badge/🚀_免费AI接口-gpt.qt.cool-10b981?style=for-the-badge\" alt=\"免费AI接口\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**平台亮点：**\n\n- **� 签到领免费额度** — 每日签到 + 邀请好友，持续获取免费使用额度\n- **💰 不满意可退** — 用着不爽随时退款，零风险体验\n- **⚡ 兼容 OpenAI 接口** — 无缝对接 OpenClaw，即开即用\n- **🔒 内部公益项目** — 长期维护，安全稳定\n\n**配合 OpenClaw 使用：**\n\n在 [gpt.qt.cool](https://gpt.qt.cool/) 注册并签到领取免费额度，获取 API Key 后，初始化 OpenClaw 时选择 **OpenAI Compatible** 提供商，填入地址和 Key 即可使用。\n\n\u003e 💡 **小贴士**：每日签到 + 邀请好友即可持续获取免费额度，搭配 OpenClaw 等于拥有一个免费私人 AI 助手！\n\n[立即使用 →](https://gpt.qt.cool/)\n\n\u003ca id=\"partners\"\u003e\u003c/a\u003e\n\n### 合作伙伴\n\n**胜算云** - 国内 AI API 聚合平台，新用户注册送额度，充值尊享 7 折优惠！\n\n[注册账号 →](https://www.shengsuanyun.com/?from=CH_4BVI0BM2)\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"ecosystem\"\u003e\u003c/a\u003e\n\n## 🔥 生态工具\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003e🦀 \u003ca href=\"https://github.com/qingchencloud/clawpanel\"\u003eClawPanel\u003c/a\u003e\u003c/h3\u003e\n      \u003cp\u003e\u003cstrong\u003e内置 AI 助手\u003c/strong\u003e的 OpenClaw 可视化管理面板\u003c/p\u003e\n      \u003cul\u003e\n        \u003cli\u003e🤖 AI 助手 — 8 大工具 + 4 种模式，自动诊断配置\u003c/li\u003e\n        \u003cli\u003e🖼️ 图片识别 — 粘贴截图，AI 一眼看懂\u003c/li\u003e\n        \u003cli\u003e⚡ 一键安装 — 自动检测环境，无需终端\u003c/li\u003e\n        \u003cli\u003e🎛️ 可视化管理 — 模型、Gateway、Agent\u003c/li\u003e\n      \u003c/ul\u003e\n      \u003cp\u003e\n        \u003ca href=\"https://github.com/qingchencloud/clawpanel/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/qingchencloud/clawpanel?style=flat-square\u0026color=6366f1\u0026label=latest\" alt=\"Release\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://claw.qt.cool/\"\u003e\u003cimg src=\"https://img.shields.io/badge/site-claw.qt.cool-8b5cf6?style=flat-square\" alt=\"Site\"\u003e\u003c/a\u003e\n      \u003c/p\u003e\n      \u003cdetails\u003e\n        \u003csummary\u003e📸 预览截图（点击展开）\u003c/summary\u003e\n        \u003cbr\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/ai-assistant-demo.gif\" width=\"100%\" alt=\"ClawPanel AI Demo\"\u003e\n        \u003cbr\u003e\u003cbr\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/00.png\" width=\"100%\" alt=\"ClawPanel AI\"\u003e\n        \u003cbr\u003e\u003cbr\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/13.png\" width=\"100%\" alt=\"ClawPanel Vision\"\u003e\n        \u003cbr\u003e\u003cbr\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/qingchencloud/clawpanel/main/docs/01.png\" width=\"100%\" alt=\"ClawPanel Dashboard\"\u003e\n      \u003c/details\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003e📱 \u003ca href=\"https://github.com/qingchencloud/clawapp\"\u003eClawApp\u003c/a\u003e\u003c/h3\u003e\n      \u003cp\u003e用手机浏览器和 OpenClaw AI 智能体聊天\u003c/p\u003e\n      \u003cul\u003e\n        \u003cli\u003e💬 流式聊天 — WebSocket 实时对话\u003c/li\u003e\n        \u003cli\u003e📷 图片收发 — 拍照上传，AI 图片回复\u003c/li\u003e\n        \u003cli\u003e🔧 工具调用 — 实时状态显示\u003c/li\u003e\n        \u003cli\u003e📱 PWA + APK — 添加到主屏幕\u003c/li\u003e\n      \u003c/ul\u003e\n      \u003cp\u003e\n        \u003ca href=\"https://github.com/qingchencloud/clawapp/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/qingchencloud/clawapp?style=flat-square\u0026color=10b981\u0026label=latest\" alt=\"Release\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://clawapp.qt.cool/\"\u003e\u003cimg src=\"https://img.shields.io/badge/site-clawapp.qt.cool-10b981?style=flat-square\" alt=\"Site\"\u003e\u003c/a\u003e\n      \u003c/p\u003e\n      \u003cdetails\u003e\n        \u003csummary\u003e📸 预览截图（点击展开）\u003c/summary\u003e\n        \u003cbr\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/qingchencloud/clawapp/main/docs/image/chat-response.png\" width=\"280\" alt=\"ClawApp Chat\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/qingchencloud/clawapp/main/docs/image/login-page.png\" width=\"280\" alt=\"ClawApp Login\"\u003e\n      \u003c/details\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"quickstart\"\u003e\u003c/a\u003e\n\n## 4 步上手\n\n\u003e **前提条件**：需要 **Node.js \u003e= 22.19.0**（[下载 Node.js](https://nodejs.org/)）\n\u003e\n\u003e 检查版本：`node -v`\n\n### 第 1 步：安装\n\n```bash\nnpm install -g @qingchencloud/openclaw-zh@latest\n```\n\n### 第 2 步：初始化（推荐守护进程模式）\n\n```bash\nopenclaw onboard --install-daemon\n```\n\n初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道\n\n### 第 3 步：启动网关\n\n```bash\nopenclaw gateway\n```\n\n### 第 4 步：打开控制台\n\n```bash\nopenclaw dashboard\n```\n\n浏览器会自动打开全中文的 Dashboard 控制台。完成！\n\n\u003e 想了解每一步的详细说明？查看 **[详细安装指南](docs/INSTALL_GUIDE.md)**（包含 Node.js 安装、模型配置、守护进程、内网访问等）\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"preview\"\u003e\u003c/a\u003e\n\n## 汉化效果预览\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/image/5.png\" alt=\"概览仪表板\" width=\"100%\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003e概览仪表板 - 网关状态、实例监控、快捷操作一目了然\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e查看更多截图\u003c/b\u003e\u003c/summary\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/image/1.png\" alt=\"对话界面\" width=\"100%\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003e对话界面 - 与 AI 助手实时交互\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/image/4.png\" alt=\"渠道管理\" width=\"100%\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003e渠道管理 - WhatsApp、Telegram、Discord 等全平台支持\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/image/2.png\" alt=\"配置中心\" width=\"100%\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003e配置中心 - 完整汉化\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/image/3.png\" alt=\"节点配置\" width=\"100%\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003e节点配置 - 执行审批、安全策略管理\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/image/6.png\" alt=\"技能插件\" width=\"100%\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003e技能插件 - 1Password、Apple Notes 等丰富扩展\u003c/em\u003e\n\u003c/p\u003e\n\n\u003c/details\u003e\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"commands\"\u003e\u003c/a\u003e\n\n## 常用命令\n\n```bash\nopenclaw                    # 启动 OpenClaw\nopenclaw onboard            # 初始化向导\nopenclaw dashboard          # 打开网页控制台\nopenclaw config             # 查看/修改配置\nopenclaw skills             # 管理技能\nopenclaw --help             # 查看帮助\n\n# 网关管理\nopenclaw gateway run        # 前台运行（挂终端，用于调试）\nopenclaw gateway start      # 后台守护进程（不挂终端，推荐！）\nopenclaw gateway stop       # 停止网关\nopenclaw gateway restart    # 重启网关\nopenclaw gateway status     # 查看网关状态\nopenclaw gateway install    # 安装为系统服务（开机自启）\n\n# 常用操作\nopenclaw update             # 检查并更新 CLI\nopenclaw doctor             # 诊断问题（自动修复）\n```\n\n\u003e **Windows 用户注意**：如果 `gateway install` 失败（提示 schtasks 不可用），可使用 `gateway start` 启动后台进程，或使用 Docker 部署方案。\n\n\u003e **Dashboard 语言设置**：首次打开网页控制台后，前往 **Overview** 页面底部，将 **Language** 切换为 **简体中文 (Simplified Chinese)**，即可显示中文界面。设置后刷新页面生效。\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"gateway-restart\"\u003e\u003c/a\u003e\n\n## 网关重启\n\n```bash\n# 方式 1：使用 gateway 子命令（推荐）\nopenclaw gateway restart\n\n# 方式 2：先停止再启动\nopenclaw gateway stop\nopenclaw gateway start\n\n# 方式 3：守护进程模式（后台运行，不挂终端）\nopenclaw daemon start       # 启动后台守护\nopenclaw daemon stop        # 停止守护\nopenclaw daemon restart    # 重启守护\nopenclaw daemon status     # 查看状态\n\n# Docker 容器重启\ndocker restart openclaw\n```\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"uninstall\"\u003e\u003c/a\u003e\n\n## 卸载教程\n\n### CLI 卸载\n\n```bash\n# 卸载汉化版\nnpm uninstall -g @qingchencloud/openclaw-zh\n\n# 如果之前安装过原版，也一并卸载\nnpm uninstall -g openclaw\n```\n\n### 数据清理（可选）\n\n```bash\n# 删除配置和缓存（不可恢复！）\nrm -rf ~/.openclaw\n\n# Docker 清理\ndocker rm -f openclaw                # 删除容器\ndocker volume rm openclaw-data       # 删除数据卷\n```\n\n### 守护进程卸载\n\n```bash\n# macOS\nlaunchctl unload ~/Library/LaunchAgents/com.openclaw.plist\nrm ~/Library/LaunchAgents/com.openclaw.plist\n\n# Linux (systemd)\nsudo systemctl stop openclaw\nsudo systemctl disable openclaw\nsudo rm /etc/systemd/system/openclaw.service\nsudo systemctl daemon-reload\n```\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"upgrade\"\u003e\u003c/a\u003e\n\n## 更新升级\n\n```bash\nnpm update -g @qingchencloud/openclaw-zh\n```\n\n\u003e 查看当前版本：`openclaw --version`\n\n| 版本 | 安装命令 | 说明 |\n|------|----------|------|\n| **稳定版** | `npm install -g @qingchencloud/openclaw-zh@latest` | 经过测试，推荐使用 |\n| **最新版** | `npm install -g @qingchencloud/openclaw-zh@nightly` | 每小时同步上游，体验新功能 |\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"docker\"\u003e\u003c/a\u003e\n\n## Docker 部署（国内推荐）\n\n\u003e **国内用户强烈推荐使用 Docker Hub 镜像**，拉取速度快，无需翻墙！\n\n| 镜像源 | 拉取命令 | 适用 |\n|--------|----------|------|\n| **Docker Hub（国内推荐）** | `docker pull 1186258278/openclaw-zh:latest` | 国内用户 |\n| GitHub Container Registry | `docker pull ghcr.io/1186258278/openclaw-zh:latest` | 海外用户 |\n\n### 一键部署（最简单）\n\n```bash\n# Linux/macOS — 加 --china 自动使用国内镜像\ncurl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash -s -- --china\n```\n\n```powershell\n# Windows PowerShell — 加 -China 自动使用国内镜像\nirm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex\n# 或: .\\docker-deploy.ps1 -China\n```\n\n### 手动 Docker 部署\n\n```bash\n# 国内用户使用 Docker Hub 镜像\nIMAGE=1186258278/openclaw-zh:latest\n# 海外用户使用: IMAGE=ghcr.io/1186258278/openclaw-zh:latest\n\n# 1. 初始化（首次运行）\n# Docker 需要交互式运行来配置 AI 模型和 API 密钥\ndocker run --rm -it -v openclaw-data:/root/.openclaw $IMAGE openclaw onboard\n\n# 按向导完成：选择模型 → 配置 API 密钥 → 设置聊天通道\n\n# 2. 配置网关模式\ndocker run --rm -v openclaw-data:/root/.openclaw $IMAGE openclaw config set gateway.mode local\n\n# 3. 启动（守护进程模式，容器会一直运行）\ndocker run -d --name openclaw -p 18789:18789 \\\n  -v openclaw-data:/root/.openclaw --restart unless-stopped \\\n  $IMAGE openclaw gateway run\n```\n\n**参数说明：**\n- `-d`: 后台运行（守护进程模式）\n- `--name openclaw`: 给容器取名，方便管理\n- `-p 18789:18789`: 端口映射\n- `--restart unless-stopped`: 除非手动停止，否则一直运行\n- `openclaw gateway run`: 启动网关（容器启动命令）\n\n访问：`http://localhost:18789`\n\n\u003e 完整指南（远程部署、Nginx 反代、Docker Compose、内网访问等）请查看 **[Docker 部署指南](docs/DOCKER_GUIDE.md)**\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"other-install\"\u003e\u003c/a\u003e\n\n## 其他安装方式\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e一键安装脚本（npm）\u003c/b\u003e\u003c/summary\u003e\n\n**Linux / macOS：**\n```bash\ncurl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh \u0026\u0026 bash install.sh\n```\n\n**Windows PowerShell：**\n```powershell\n[Console]::OutputEncoding = [System.Text.Encoding]::UTF8\nInvoke-WebRequest -Uri \"https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1\" -OutFile \"install.ps1\" -Encoding UTF8; powershell -ExecutionPolicy Bypass -File \".\\install.ps1\"\n```\n\n\u003e 如遇中文乱码，直接用 npm 安装：`npm install -g @qingchencloud/openclaw-zh@latest`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003enpm 国内加速安装\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# 使用 npmmirror 镜像源（国内推荐）\nnpm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com\n\n# 或全局设置镜像源后再安装\nnpm config set registry https://registry.npmmirror.com\nnpm install -g @qingchencloud/openclaw-zh@latest\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003epnpm / yarn 安装\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# pnpm\npnpm add -g @qingchencloud/openclaw-zh@latest\n\n# yarn\nyarn global add @qingchencloud/openclaw-zh@latest\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGit 克隆加速\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# 方案 1: 使用 GitHub 代理\ngit clone https://ghproxy.net/https://github.com/1186258278/OpenClawChineseTranslation.git\n\n# 方案 2: 无需 git，直接用 npx 运行\nnpx @qingchencloud/openclaw-zh@latest\n```\n\n\u003c/details\u003e\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"mobile\"\u003e\u003c/a\u003e\n\n## 手机端 — ClawApp\n\n\u003e **想用手机和 AI 智能体聊天？** [ClawApp](https://github.com/qingchencloud/clawapp) 是 OpenClaw 的移动端 H5 聊天客户端，打开浏览器就能用，不需要装 App。\n\nOpenClaw Gateway 默认只监听本机（`127.0.0.1:18789`），手机无法直接连接。ClawApp 通过 WebSocket 代理解决了这个问题：\n\n```\n手机浏览器（任意网络）\n    ↓ WebSocket (WS / WSS)\nClawApp 代理服务端（端口 3210）\n    ↓ WebSocket (localhost)\nOpenClaw Gateway（端口 18789）\n```\n\n**核心特性**：实时流式聊天 · 图片发送 · Markdown 渲染 + 代码高亮 · 快捷指令 · 会话管理 · 暗色/亮色主题 · 中英文切换 · PWA 支持 · Android APK\n\n**快速部署**（Docker 一键启动）：\n\n```bash\ngit clone https://github.com/qingchencloud/clawapp.git\ncd clawapp\n\n# 创建 .env，填入你的 Token\necho 'PROXY_TOKEN=设置一个连接密码' \u003e .env\necho 'OPENCLAW_GATEWAY_TOKEN=你的gateway-token' \u003e\u003e .env\n\ndocker compose up -d --build\n```\n\n手机浏览器打开 `http://你的电脑IP:3210` 即可使用。\n\n\u003e 详细文档（外网访问、Cloudflare Tunnel、Nginx 反代等）请查看 **[ClawApp 项目主页](https://github.com/qingchencloud/clawapp)** | **[产品官网](https://clawapp.qt.cool/)**\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"faq\"\u003e\u003c/a\u003e\n\n## 常见问题\n\n### Top 3 高频问题\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003e❶ 安装卡住 / 下载慢\u003c/b\u003e\u003c/summary\u003e\n\n**原因**：npm 默认从国外源下载，国内网络可能很慢。\n\n**解决**：加 `--registry` 参数使用国内镜像源，或直接用 Docker 部署：\n```bash\n# 方案 1：npm 加镜像源\nnpm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com\n\n# 方案 2：用 Docker（国内最快）\ndocker pull 1186258278/openclaw-zh:latest\n```\n\n\u003e [详细说明 →](docs/FAQ.md#install-slow)\n\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003e❷ 安装后还是英文界面\u003c/b\u003e\u003c/summary\u003e\n\n**原因**：系统上还残留了英文原版 `openclaw`，它的优先级高于汉化版。\n\n**解决**：先卸载原版，再重装汉化版：\n```bash\nnpm uninstall -g openclaw\nnpm install -g @qingchencloud/openclaw-zh@latest\n```\n\n验证：`openclaw --version` 输出应包含 `-zh` 后缀。\n\n\u003e [详细说明 →](docs/FAQ.md#still-english)\n\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003e❸ 打开 Dashboard 报 `pairing required` 或 `token mismatch`\u003c/b\u003e\u003c/summary\u003e\n\n**原因**：OpenClaw 的安全机制要求设备配对或 Token 验证。\n\n**解决**：\n\n```bash\n# token mismatch —— 用 dashboard 命令自动带 Token 打开：\nopenclaw dashboard\n\n# pairing required —— 批准设备：\nopenclaw devices list           # 查看待批准设备 ID\nopenclaw devices approve \u003cID\u003e   # 批准该设备\n\n# Docker 用户如果无法运行 CLI，可以一键关闭设备认证：\ndocker run --rm -v openclaw-data:/root/.openclaw \\\n  1186258278/openclaw-zh:latest \\\n  openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true\n# 然后重启容器\n```\n\n\u003e [token mismatch 详细说明 →](docs/FAQ.md#token-mismatch) | [pairing required 详细说明 →](docs/FAQ.md#pairing-required)\n\n\u003c/details\u003e\n\n### 其他常见问题\n\n| 问题 | 快速解决 | 详情 |\n|------|----------|------|\n| **安装报 `Permission denied (publickey)`** | `git config --global url.\"https://github.com/\".insteadOf ssh://git@github.com/` | [查看 →](docs/FAQ.md#permission-denied) |\n| **远程 / 内网访问不了** | `openclaw config set gateway.bind lan` 然后重启 | [查看 →](docs/FAQ.md#lan-access) |\n| **镜像源版本落后** | 去掉 `--registry` 参数直接安装，或等待镜像同步（已自动触发） | [#32](https://github.com/1186258278/OpenClawChineseTranslation/issues/32) |\n| **`Missing config`** | 运行 `openclaw onboard` 初始化配置 | [查看 →](docs/FAQ.md#missing-config) |\n| **`Missing workspace template`** | 升级到最新版即可：`npm install -g @qingchencloud/openclaw-zh@latest` | [查看 →](docs/FAQ.md#missing-workspace-template-agentsmd) |\n| **Ollama 无响应** | 检查 baseURL 是否为 `http://localhost:11434/v1` | [查看 →](docs/FAQ.md#ollama-no-response) |\n| **Docker 容器启动后退出** | 确保启动命令包含 `openclaw gateway run` | [查看 →](docs/DOCKER_GUIDE.md#troubleshoot) |\n| **Docker 打不开 Dashboard** | 设置 `gateway.bind lan` 监听所有网卡 | [查看 →](docs/DOCKER_GUIDE.md#troubleshoot) |\n\n\u003e **[完整排查手册 (25+ 个问题)](docs/FAQ.md)** | **[Docker 问题排查](docs/DOCKER_GUIDE.md#troubleshoot)**\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"plugins\"\u003e\u003c/a\u003e\n\n## 插件扩展\n\n```bash\n# 安装更新检测插件\nnpm install -g @qingchencloud/openclaw-updater\n```\n\n访问 [插件市场](https://openclaw.qt.cool/) 获取更多插件。\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"community\"\u003e\u003c/a\u003e\n\n## 社区交流\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/U9AttmsNHh\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-加入社区-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white\" alt=\"Discord\"\u003e\u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://yb.tencent.com/gp/i/LsvIw7mdR7Lb\"\u003e\u003cimg src=\"https://img.shields.io/badge/元宝派-加入圈子-FF6A00?style=for-the-badge\u0026logo=tencent-qq\u0026logoColor=white\" alt=\"元宝派\"\u003e\u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://qt.cool/c/OpenClaw\"\u003e\u003cimg src=\"https://img.shields.io/badge/QQ群-加入交流-12B7F5?style=for-the-badge\u0026logo=tencent-qq\u0026logoColor=white\" alt=\"QQ群\"\u003e\u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://qt.cool/c/OpenClawWx\"\u003e\u003cimg src=\"https://img.shields.io/badge/微信群-加入交流-07C160?style=for-the-badge\u0026logo=wechat\u0026logoColor=white\" alt=\"微信群\"\u003e\u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://qt.cool/c/OpenClawDY\"\u003e\u003cimg src=\"https://img.shields.io/badge/抖音群-加入交流-000000?style=for-the-badge\u0026logo=tiktok\u0026logoColor=white\" alt=\"抖音群\"\u003e\u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://qt.cool/c/feishu\"\u003e\u003cimg src=\"https://img.shields.io/badge/飞书群-加入交流-3370FF?style=for-the-badge\u0026logo=lark\u0026logoColor=white\" alt=\"飞书群\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n### QQ 交流群\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://qt.cool/c/OpenClaw\"\u003e\n    \u003cimg src=\"docs/image/OpenClaw-QQ.png\" alt=\"QQ交流群\" width=\"200px\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003e扫码或 \u003ca href=\"https://qt.cool/c/OpenClaw\"\u003e点击链接\u003c/a\u003e 加入 | 2000 人大群，满员自动切换\u003c/em\u003e\n\u003c/p\u003e\n\n### 微信交流群\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://qt.cool/c/OpenClawWx\"\u003e\n    \u003cimg src=\"docs/image/OpenClawWx.png\" alt=\"微信交流群\" width=\"200px\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003e扫码或 \u003ca href=\"https://qt.cool/c/OpenClawWx\"\u003e点击链接\u003c/a\u003e 加入 | 碰到问题也可以直接在群内反馈\u003c/em\u003e\n\u003c/p\u003e\n\n### 抖音交流群\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://qt.cool/c/OpenClawDY\"\u003e\n    \u003cimg src=\"https://qt.cool/c/OpenClawDY/qr.png\" alt=\"抖音交流群\" width=\"200px\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003e扫码或 \u003ca href=\"https://qt.cool/c/OpenClawDY\"\u003e点击链接\u003c/a\u003e 加入 | 拍视频、看教程、交流心得\u003c/em\u003e\n\u003c/p\u003e\n\n### 飞书交流群\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://qt.cool/c/feishu\"\u003e\n    \u003cimg src=\"https://qt.cool/c/feishu/qr.png\" alt=\"飞书交流群\" width=\"200px\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003e扫码或 \u003ca href=\"https://qt.cool/c/feishu\"\u003e点击链接\u003c/a\u003e 加入 | 飞书群聊，高效协作交流\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"links\"\u003e\u003c/a\u003e\n\n## 相关链接\n\n| 汉化版 | 上游项目 |\n|--------|----------|\n| [汉化官网](https://openclaw.qt.cool/) | [OpenClaw 官网](https://openclaw.ai/) |\n| [npm 包](https://www.npmjs.com/package/@qingchencloud/openclaw-zh) | [OpenClaw GitHub](https://github.com/openclaw/openclaw) |\n| [GitHub 仓库](https://github.com/1186258278/OpenClawChineseTranslation) | [ClawHub 技能市场](https://clawhub.dev/) |\n| [GitHub Pages](https://1186258278.github.io/OpenClawChineseTranslation/) | [Discord 社区](https://discord.gg/U9AttmsNHh) |\n| [📱 ClawApp 手机端](https://github.com/qingchencloud/clawapp) | [ClawApp 产品官网](https://clawapp.qt.cool/) |\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"contributing\"\u003e\u003c/a\u003e\n\n## 参与贡献\n\n- [报告问题](https://github.com/1186258278/OpenClawChineseTranslation/issues) | [改进翻译](docs/CONTRIBUTING.md) | [翻译规范](docs/TRANSLATION_GUIDE.md) | 给项目点个 Star\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003ca id=\"about\"\u003e\u003c/a\u003e\n\n## 关于\n\n**武汉晴辰天下网络科技有限公司** 出品 | [qingchencloud.com](https://qingchencloud.com/) | [MIT License](LICENSE)\n\n© 武汉晴辰天下网络科技有限公司 | [鄂ICP备2025164966号](https://beian.miit.gov.cn/)\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- AI Translation Tools: Claude, Copilot, Codex, Devin, Amazon Q, CodeRabbit --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1186258278%2Fopenclawchinesetranslation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1186258278%2Fopenclawchinesetranslation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1186258278%2Fopenclawchinesetranslation/lists"}