项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3793
使用教程
环境要求
- Node.js >= 22.19.0(用 node -v 检查)
- npm 包管理器(随 Node.js 一起安装)
- Docker 方式需已安装 Docker(可选)
- 国内网络建议使用 npm 镜像源或 Docker Hub 镜像
安装与启动步骤
-
1检查 Node 版本
打开终端执行命令,确认输出不低于 22.19.0,否则先到 nodejs.org 下载安装新版 Node.js。
node -v -
2卸载英文原版
如果之前装过英文原版 openclaw,必须先卸载,否则它会优先于汉化版导致界面仍是英文。
npm uninstall -g openclaw -
3安装汉化版
全局安装汉化版。国内速度慢可加 --registry 使用 npmmirror 镜像源,也可用 npx 免安装运行。
npm install -g @qingchencloud/openclaw-zh@latest npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com npx @qingchencloud/openclaw-zh@latest -
4启动网关
运行网关让助手开始工作,首次运行会引导你选择模型、配置 API 密钥和聊天通道,按向导填写即可。
openclaw gateway -
5后台守护运行
想让网关在后台常驻、不占用终端,改用 daemon 命令,可用 status 查看运行状态。
openclaw daemon start openclaw daemon status openclaw daemon stop -
6Docker 部署
国内推荐用 Docker Hub 镜像。首次需交互式运行 onboard 完成模型与密钥配置,再启动容器。
docker pull 1186258278/openclaw-zh:latest docker run --rm -it -v openclaw-data:/root/.openclaw 1186258278/openclaw-zh:latest openclaw onboard docker run --rm -v openclaw-data:/root/.openclaw 1186258278/openclaw-zh:latest openclaw config set gateway.mode local docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped 1186258278/openclaw-zh:latest openclaw gateway run
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
gateway.mode | 是 | 设置网关运行模式,Docker 部署时需设为 local。 | local |
gateway.controlUi.dangerouslyDisableDevi | 否 | 关闭设备认证,解决 Dashboard 报 pairing required 或 token mismatch。 | true |
如何确认成功
执行 openclaw --version,输出中应包含 -zh 后缀;Docker 方式浏览器打开 http://localhost:18789 能看到 Dashboard。
常见问题
Q:安装后界面还是英文怎么办?
A:通常是系统里还残留英文原版 openclaw,它优先级更高。先执行 npm uninstall -g openclaw 卸载原版,再重装汉化版。
Q:npm 安装太慢或超时怎么办?
A:改用国内镜像:npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com,或直接使用 Docker Hub 镜像。
Q:打开 Dashboard 报 pairing required 或 token mismatch?
A:这是安全机制触发的设备配对或 Token 校验。Docker 用户可执行 config set 命令将 gateway.controlUi.dangerouslyDisableDeviceAuth 设为 true 关闭设备认证。
Q:安装脚本出现中文乱码?
A:直接用 npm 安装即可:npm install -g @qingchencloud/openclaw-zh@latest,绕开脚本的编码问题。
注意事项
- 汉化版每小时自动同步上游官方更新,若功能异常可先升级到最新版。
- 卸载时执行 rm -rf ~/.openclaw 会删除全部配置和缓存,且不可恢复,请先备份。
- Docker 方式会持久化数据卷 openclaw-data,删除容器不会丢配置,除非手动删除数据卷。
- 首次运行需要交互式配置 AI 模型和 API 密钥,请准备好对应平台的密钥。
核心亮点
- 全中文界面和文档,大幅降低非英语用户使用门槛
- 每小时自动同步上游,功能更新及时
- 覆盖 WhatsApp/Telegram/Discord 多平台,场景灵活
不足之处
- 依赖上游项目稳定性,上游变动可能影响汉化版
- 文档/社区待观察
适用场景
- 中文用户搭建个人 AI 助理,日常问答和任务处理
- 在 Telegram/Discord 群组中部署 AI 机器人,提供中文互动
- 开发者学习开源 AI 助手架构,并基于汉化版二次开发
替代项目
OpenClaw (原版)、LangChain、AutoGPT
同类项目推荐
ViNote
开源
丢个视频链接,自动转写、总结、生成笔记还能追问
ViNote(视记AI)|DeepSeek Harness SDK 驱动的开源视频知识 Agent。以工具编排、SQLite ···
trainable-agents
开源
微调专属角色扮演大模型,让AI化身历史人物
Code and datasets for "Character-LLM: A Trainable Agent for Role-Playing"
agentic-context-engine
开源
让AI智能体从经验中学习,越用越聪明
Make your agents learn from experience. Now available as a hosted solution at kayba.···
ava-whatsapp-agent-course
开源
把 WhatsApp 变成你的 AI 语音管家,聊天就能指挥干活
Meet Ava, the WhatsApp Agent
AnyModelBot
开源
一个入口接入70+模型,还能替你操作电脑
Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your ···
product-architect
开源
31个AI智能体帮你从零到IPO,产品开发全自动
The most comprehensive open-source product development system. 80 AI agents. 36 fram···
Awesome-Adaptation-of-Agentic-AI
开源
一网打尽智能体AI适应研究,快速跟上领域前沿
Repo for "Adaptation of Agentic AI"
refact
开源
让 AI 自主搞定开发任务,从写代码到跑测试一条龙
AI Agent that handles engineering tasks end-to-end: integrates with developers’ too···
aft
开源
给编码智能体装上 IDE 和操作系统,让代码操作更精准高效
Give your agent a proper IDE and OS. The sensorimotor cortex for coding agents (Open···
