OpenClaw：开源AI助手平台，让你的聊天应用秒变超级助手！

OpenClaw[1] 是由 Peter Steinberger (@steipete[2]) 创建的**开源个人 AI 助手平台**，在 GitHub 上拥有超过 **100,000+ Stars**。

python零基础入门小白

571人浏览 · 2026-03-08 18:45:42

python零基础入门小白 · 2026-03-08 18:45:42 发布

🦞 什么是 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	网关	wizard	设置向导
meta	元数据	diagnostics	诊断
logging	日志	browser	浏览器
ui	界面	models	模型
nodeHost	节点主机	bindings	绑定
broadcast	广播	audio	音频
media	媒体	approvals	审批
session	会话	cron	定时任务
web	网页	discovery	发现
canvasHost	画布主机	talk	语音
plugins	插件

注意：与 AI 的对话内容取决于你使用的模型，不在汉化范围内。

🔄 自动同步更新

每小时 检测 OpenClaw 官方仓库更新
自动应用汉化、构建、测试
同时发布 npm 包 + GitHub Releases

版本格式：{官方版本}-zh.{日期}，如 2026.1.29-zh.20260130

🔌 插件扩展

OpenClaw 汉化版支持通过 npm 插件扩展功能。我们提供了官方插件，让你的 AI 助手更加强大！

插件市场

访问我们的插件市场查看所有可用插件：

如何安装插件

# 全局安装插件npm install -g @qingchencloud/插件包名# 例如安装更新检测插件npm install -g @qingchencloud/openclaw-updater

安装后重启 OpenClaw 即可使用插件提供的功能。

可用插件列表

插件	功能	安装命令
更新检测	自动检测汉化版更新，一键升级	`npm i -g @qingchencloud/openclaw-updater`

💡 更多插件正在开发中，敬请期待！访问插件市场[14] 获取最新插件。

更新检测插件

安装后，插件会：

启动时自动检测是否有新版本
提供 /update 命令手动检查更新
提供 /version 命令查看当前版本

# 安装npm install -g @qingchencloud/openclaw-updater# 使用# 启动 OpenClaw 后，插件会自动检测更新# 或使用命令 /update 手动检查

🐳 Docker 部署指南

方式 1：一键部署脚本（推荐）

自动完成初始化、配置远程访问、启动容器：

# Linux / macOScurl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash# Windows PowerShellirm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex

方式 2：快速启动（本地访问）

适用于在本机运行并通过 localhost 访问：

# 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

访问：http://localhost:18789

方式 3：服务器部署（远程访问）

部署到服务器并从其他设备访问时，需要额外配置。

手动配置步骤：

# 1. 创建数据卷docker volume create openclaw-data# 2. 初始化配置docker run --rm -v openclaw-data:/root/.openclaw \  ghcr.io/1186258278/openclaw-zh:nightly openclaw setup# 3. 配置远程访问参数docker run --rm -v openclaw-data:/root/.openclaw \  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode localdocker run --rm -v openclaw-data:/root/.openclaw \  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan# 4. 设置访问令牌（推荐）docker run --rm -v openclaw-data:/root/.openclaw \  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token your-secure-token# 5. 启动容器docker run -d \  --name openclaw \  -p 18789:18789 \  -v openclaw-data:/root/.openclaw \  --restart unless-stopped \  ghcr.io/1186258278/openclaw-zh:nightly \  openclaw gateway run

访问：http://服务器IP:18789 → 在 Dashboard 输入 token 连接

远程访问注意事项 ⚠️ 重要

通过 HTTP 从非 localhost 访问时，浏览器会阻止设备身份验证（Web Crypto API 需要 secure context）。

✅ 推荐解决方案：设置 Token 认证

# 1. 设置访问令牌（在服务器上执行）docker exec openclaw openclaw config set gateway.auth.token YOUR_TOKENdocker restart openclaw# 2. 在浏览器访问远程地址http://服务器IP:18789/overview# 3. 在「网关令牌」输入框填入 YOUR_TOKEN，点击「连接」

💡 说明：设置 gateway.auth.token 后，即使通过远程 HTTP 访问，只要在 Dashboard 输入正确的 token 就能连接成功。

其他解决方案对比：

方案	说明	适用场景
设置 Token ⭐	设置 `gateway.auth.token`，Dashboard 输入 token	内网（最简单）
SSH 端口转发	`ssh -L 18789:127.0.0.1:18789 user@server`	更安全
Tailscale Serve	自动 HTTPS 访问	跨网络访问
Nginx + HTTPS	配置 SSL 证书反向代理	生产环境

⚠️ 注意：gateway.controlUi.allowInsecureAuth: true 配置存在已知上游 Bug（#1679[16]），单独使用不起作用，必须配合 gateway.auth.token 使用。

使用 Docker Compose

项目提供了开箱即用的 docker-compose.yml：

# 下载配置文件curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-compose.yml -o docker-compose.yml# 启动（首次会自动初始化）docker-compose up -d

或手动创建 docker-compose.yml：

version: '3.8'services:openclaw:    image:ghcr.io/1186258278/openclaw-zh:nightly    container_name:openclaw    ports:      -"18789:18789"    volumes:      -openclaw-data:/root/.openclaw    environment:      -OPENCLAW_GATEWAY_TOKEN=your-secure-token# 设置访问令牌    restart:unless-stopped    # 远程访问时使用以下命令（需先手动初始化配置）    # command: openclaw gateway runvolumes:openclaw-data:

自行构建 Docker 镜像

如果需要自定义或使用最新代码：

# 1. 克隆汉化项目git clone https://github.com/1186258278/OpenClawChineseTranslation.gitcd OpenClawChineseTranslation# 2. 克隆上游源码git clone https://github.com/openclaw/openclaw.git openclaw# 3. 应用汉化npm run cli -- apply# 4. 构建 Docker 镜像cd openclawdocker build -t openclaw-zh:local .# 5. 运行docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw openclaw-zh:local

常用 Docker 命令

# 查看日志docker logs -f openclaw# 停止容器docker stop openclaw# 重启容器docker restart openclaw# 进入容器docker exec -it openclaw sh# 删除容器docker stop openclaw && docker rm openclaw# 查看配置docker run --rm -v openclaw-data:/root/.openclaw alpine cat /root/.openclaw/openclaw.json

Docker 空间清理

Docker 镜像和容器会占用大量磁盘空间，建议定期清理：

# 查看 Docker 空间占用docker system df# 清理已停止的容器docker container prune -f# 清理未使用的镜像docker image prune -f# 清理构建缓存docker builder prune -f# 一键清理所有未使用资源（镜像、容器、网络、缓存）docker system prune -a# 连同未使用的数据卷一起清理（⚠️ 会删除数据，谨慎使用）docker system prune -a --volumes

💡 提示：OpenClaw 镜像约 4GB，如果有多个旧版本镜像堆积，建议用 docker image prune -a 清理。

🔧 手动汉化安装

适用于想要自定义翻译、测试最新代码或参与贡献的用户。

完整流程

# 1. 克隆汉化项目git clone https://github.com/1186258278/OpenClawChineseTranslation.gitcd OpenClawChineseTranslation# 2. 克隆上游 OpenClaw 源码git clone https://github.com/openclaw/openclaw.git openclaw# 3. 查看汉化状态npm run cli -- status# 4. 应用汉化补丁npm run cli -- apply# 5. 验证汉化结果npm run cli -- verify# 6. 构建 OpenClawcd openclawpnpm installpnpm run build# 7. 全局安装npm install -g .# 8. 验证安装openclaw --versionopenclaw --help

汉化 CLI 完整命令

命令	说明
`npm run cli -- status`	查看当前汉化状态
`npm run cli -- apply`	应用汉化补丁
`npm run cli -- apply --dry-run`	预览汉化（不实际修改）
`npm run cli -- apply --verbose`	详细输出汉化过程
`npm run cli -- verify`	验证汉化结果
`npm run cli -- restore`	恢复原版（使用 git checkout）

自定义翻译

找到目标文件：确定需要翻译的源文件位置

创建翻译规则：在 translations/ 对应目录创建 JSON 文件

{  "file": "src/path/to/file.ts",  "description": "文件说明",  "replacements": {    "\"English Text\"": "\"中文翻译\""  }}

注册翻译文件：在 translations/config.json 中添加

测试：

npm run cli -- apply --dry-run --verbosenpm run cli -- applynpm run cli -- verify

提交 PR：欢迎贡献你的翻译！

🛠️ 开发者 / 贡献者指南

如果你想参与翻译或本地开发：

# 1. 克隆本项目git clone https://github.com/1186258278/OpenClawChineseTranslation.gitcd OpenClawChineseTranslation# 2. 克隆上游 OpenClaw 源码git clone https://github.com/openclaw/openclaw.git openclaw# 3. 使用汉化 CLI 工具npm run cli -- status           # 查看状态npm run cli -- apply --dry-run  # 预览汉化（不修改）npm run cli -- apply            # 应用汉化npm run cli -- verify           # 验证结果npm run cli -- restore          # 恢复原版

项目结构

OpenClawChineseTranslation/├── cli/                    # 汉化 CLI 工具│   ├── index.mjs           # 入口│   ├── commands/           # 命令实现│   └── utils/              # 工具函数（i18n 引擎）├── translations/           # 翻译配置（JSON 格式）│   ├── config.json         # 主配置（加载所有翻译文件）│   ├── cli/                # CLI 界面翻译│   │   ├── banner.json     # 启动横幅│   │   ├── tagline.json    # 有趣标语│   │   └── help.json       # 帮助信息│   ├── wizard/             # 向导翻译│   │   ├── onboarding.json # 初始化向导│   │   ├── security.json   # 安全警告│   │   └── finalize.json   # 完成提示│   ├── tui/                # TUI 界面翻译│   │   ├── waiting.json    # 等待动画│   │   └── commands.json   # 斜杠命令│   ├── commands/           # 命令翻译│   │   ├── status.json     # status 命令│   │   ├── update.json     # update 命令│   │   ├── skills.json     # skills 命令│   │   └── ...             # 更多命令│   └── dashboard/          # Dashboard UI 翻译 (20+ 文件)│       ├── navigation.json # 导航菜单│       ├── app-render.json # 主布局│       ├── chat.json       # 聊天界面│       ├── config.json     # 配置页面│       ├── schema.json     # 配置 schema│       ├── config-form-*.json  # 表单元素│       ├── channels-*.json # 各渠道翻译│       └── ...             # 更多模块├── docs/                   # 文档├── .github/workflows/      # 自动化工作流├── install.sh              # Linux/macOS 安装脚本└── install.ps1             # Windows 安装脚本