🦞 什么是 OpenClaw?
OpenClaw[1] 是由 Peter Steinberger (@steipete[2]) 创建的开源个人 AI 助手平台,在 GitHub 上拥有超过 100,000+ Stars。
核心特性
| 特性 | 说明 |
|---|---|
| 🖥️ 运行在你的机器上 | Mac、Windows 或 Linux,数据始终在本地,隐私优先 |
| 💬 任意聊天应用 | WhatsApp、Telegram、Discord、Slack、Signal、iMessage 都能用 |
| 🧠 持久记忆 | 记住你的偏好、上下文,成为专属于你的 AI |
| 🌐 浏览器控制 | 自动浏览网页、填写表单、提取数据 |
| ⚡ 完整系统访问 | 读写文件、运行脚本、执行命令 |
| 🔌 技能插件系统 | 社区技能扩展,甚至可以自己编写新技能 |
它能做什么?
"清理你的收件箱、发送邮件、管理日历、办理航班值机……全部通过你常用的聊天应用完成。"
正如用户评价:
- "这是我第一次感觉自己活在未来。" — @davemorin
- "一切 Siri 本该成为的样子,而且远不止如此。" — @crossiBuilds
- "它正在运行我的公司。" — @therno
- "开源构建了一个比 Apple(3.6万亿美元公司)睡了多年的 Siri 更好的版本。" — @Hesamation
📸 汉化效果预览
⚡ 一键安装汉化版
Windows (PowerShell)
## 下载并执行安装脚本(注意:需要 UTF-8 编码)[Console]::OutputEncoding = [System.Text.Encoding]::UTF8Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1" -Encoding UTF8; powershell -ExecutionPolicy Bypass -File ".\install.ps1"
如果遇到中文乱码问题,请使用以下命令:
```
方法1:直接通过 npm 安装(推荐)npm install -g @qingchencloud/openclaw-zh@latest# 方法2:使用 PowerShell 7+(支持 UTF-8)pwsh -Command "irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1 | iex"
```
Linux / macOS
## 下载并执行安装脚本curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh
💡 使用 jsDelivr CDN 加速 | 🔒 查看脚本源码[5]
📦 其他安装方式
版本选择
我们提供两个版本源,根据需求选择:
| 版本 | npm 标签 | 更新频率 | 适用场景 |
|---|---|---|---|
| 稳定版 | @latest |
手动发布 | 生产环境,经过测试,推荐使用 |
| 最新版 | @nightly |
每小时自动 | 测试新功能,追踪上游最新代码 |
方式 1: npm / pnpm / yarn 安装
## npm 安装(推荐)npm install -g @qingchencloud/openclaw-zh@latest # 稳定版npm install -g @qingchencloud/openclaw-zh@nightly # 最新版# pnpm 安装pnpm add -g @qingchencloud/openclaw-zh@latest # 稳定版pnpm add -g @qingchencloud/openclaw-zh@nightly # 最新版# yarn 安装yarn global add @qingchencloud/openclaw-zh@latest # 稳定版yarn global add @qingchencloud/openclaw-zh@nightly # 最新版
💡 我们发布的是标准 npm 包,npm / pnpm / yarn 都可以安装,选择你习惯的包管理器即可。
方式 2: 手动下载
访问 Releases 页面[7] 下载最新版本。
方式 3: Docker 部署
## 1. 初始化配置(首次运行)docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setupdocker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly 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:nightly openclaw gateway run# 访问 Dashboard: http://localhost:18789
📖 详细 Docker 配置请参考下方 Docker 部署指南[8]
🚀 快速开始
安装完成后:
💡 自动初始化: 使用一键安装脚本时,安装完成后会自动尝试运行初始化配置。 如需跳过,设置环境变量
OPENCLAW_SKIP_SETUP=1即可。
## 启动初始化向导(全中文界面)openclaw onboard# 安装后台守护进程openclaw onboard --install-daemon
首次运行会引导你完成:
- 选择 AI 模型提供商(Claude、GPT、本地模型等)
- 配置 API 密钥
- 设置聊天通道(WhatsApp、Telegram 等)
- 创建你的 AI 助手人格
常用命令
openclaw # 启动 OpenClawopenclaw onboard # 初始化向导openclaw config # 查看/修改配置openclaw skills # 管理技能openclaw --help # 查看帮助
🔄 更新升级
已安装的 OpenClaw 汉化版如何升级?根据你的安装方式选择对应方法:
npm 安装用户
## 升级到最新稳定版npm update -g @qingchencloud/openclaw-zh# 或者重新安装指定版本npm install -g @qingchencloud/openclaw-zh@latest # 稳定版npm install -g @qingchencloud/openclaw-zh@nightly # 最新版
💡 查看当前版本:
openclaw --version
Docker 用户
## 1. 拉取最新镜像docker pull ghcr.io/1186258278/openclaw-zh:nightly # 最新版# 或docker pull ghcr.io/1186258278/openclaw-zh:latest # 稳定版# 2. 停止并删除旧容器docker stop openclaw && docker rm openclaw# 3. 用新镜像启动(配置会自动保留,因为存储在数据卷中)docker run -d --name openclaw -p 18789:18789 \ -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run
💡 数据不会丢失: 配置和数据存储在
openclaw-data卷中,升级镜像不会影响。
Docker Compose 用户
## 1. 拉取最新镜像docker compose pull# 2. 重新创建容器docker compose up -d
一键安装脚本用户
直接重新运行安装脚本即可,会自动升级到最新版:
## Linux/macOScurl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash# Windows PowerShellnpm install -g @qingchencloud/openclaw-zh@latest
版本对比
| 版本类型 | npm 标签 | Docker 标签 | 更新频率 | 推荐场景 |
|---|---|---|---|---|
| 稳定版 | @latest |
:latest |
手动发布 | 生产环境 |
| 最新版 | @nightly |
:nightly |
每小时自动 | 体验新功能 |
✨ 汉化内容
我们提供了深度汉化,覆盖 CLI 命令行 + Dashboard 网页控制台 两大核心界面。
📊 汉化统计
| 指标 | 数量 |
|---|---|
| 📁 翻译文件 | 35+ 个 |
| 📝 翻译规则 | 970+ 条 |
| 🎯 覆盖模块 | 45+ 个 |
🖥️ CLI 命令行 (14 个模块)
| 分类 | 模块 | 说明 |
|---|---|---|
| CLI | 启动横幅 | 标题、版本信息、有趣的标语口号 |
| CLI | 帮助信息 | 命令说明、参数提示、汉化官网链接 |
| 向导 | 初始化引导 | 完整的 onboard 流程 |
| 向导 | 安全警告 | 权限警告、风险确认对话框 |
| 向导 | 完成提示 | 汉化版官网引导 |
| TUI | 等待动画 | 有趣的中文等待短语(如"神游八方中") |
| TUI | 斜杠命令 | /help, /status 等命令说明 |
| 命令 | status | 状态概览、安全审计、通道、会话 |
| 命令 | update | 更新进度、结果显示 |
| 命令 | skills | 技能列表、详情、安装选项 |
| 命令 | channels | 聊天通道、认证提供商列表 |
| 命令 | doctor | 诊断命令、安全审计警告 |
| 命令 | uninstall | 卸载提示、清理选项 |
| 命令 | 认证配置 | API 密钥、模型选择提示 |
🌐 Dashboard 网页控制台 (31 个模块)
| 分类 | 模块 | 说明 |
|---|---|---|
| 主布局 | 顶栏/侧栏 | 品牌标识、健康状态、导航菜单 |
| 主布局 | 资源链接 | 汉化官网、GitHub 仓库链接 |
| 导航 | 顶部标签页 | 对话、概览、渠道、实例、会话等 |
| 对话 | 聊天界面 | 消息输入、发送按钮、工具卡片 |
| 概览 | 系统状态 | 运行时间、活跃会话、模型列表 |
| 会话 | 会话管理 | 会话列表、详情、存档操作 |
| 渠道 | 消息渠道 | WhatsApp、Telegram、Discord 等全部渠道卡片 |
| 技能 | 技能管理 | 已安装、可用技能、详情页 |
| 节点 | 节点管理 | 本地/远程节点、浏览器配置、审批策略 |
| 配置 | 配置页面 | 31 个配置分区完整翻译 |
| 配置 | 表单元素 | 所有字段标签、帮助文本、占位符 |
| 配置 | 动态标签 | 300+ 动态生成的标签翻译映射 |
| 定时任务 | 调度器 | 任务列表、运行状态、操作按钮 |
| 日志 | 日志查看 | 筛选、搜索、导出功能 |
| 调试 | 调试工具 | 快照、手动 RPC、事件日志 |
| 实例 | 实例管理 | 已连接实例、存在信标 |
📋 配置页面完整翻译 (31 个分区)
| 分区 | 中文名 | 分区 | 中文名 |
|---|---|---|---|
| env | 环境 | update | 更新 |
| Agents | 代理 | auth | 身份验证 |
| channels | 渠道 | messages | 消息 |
| commands | 命令 | hooks | 钩子 |
| skills | 技能 | tools | 工具 |
| gateway | 网关 | wiza… |