手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

🦞 OpenClaw 到底是啥？

OpenClaw 就是那个由大佬 Peter Steinberger (@steipete) 开发的开源个人 AI 助理。这项目在 GitHub 上火得一塌糊涂，星星数都破 100,000 了。

核心亮点

特性 它是干嘛的
🖥️ 就在你电脑上跑 不管是 Mac、Windows 还是 Linux，数据都在本地，隐私绝对安全
💬 聊天软件通吃 WhatsApp、Telegram、Discord、Slack、Signal 甚至 iMessage 都能连
🧠 记性超好 它能记住你的习惯和上下文，变成真正懂你的 AI
🌐 还能操控浏览器 自动帮你上网翻页、填表单、抓取数据
⚡ 系统权限拉满 读写文件、跑脚本、敲命令，它都能干
🔌 技能随便装 除了社区现成的插件，你还能自己写新技能给它装上

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

它能帮你干嘛？

“清空收件箱、发邮件、排日程、甚至给航班值机……所有这些杂事，你在常用的聊天软件里吩咐一声就行。”

看看用过的人怎么说：

  • “头一次感觉自己真的活在未来。” — @davemorin
  • “Siri 本该有的样子，而且比那强多了。” — @crossiBuilds
  • “它现在基本上在帮我管公司。” — @therno
  • “苹果（市值3.6万亿那家）让 Siri 睡了大觉，结果开源社区搞出了个碾压它的版本。” — @Hesamation

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

📸 汉化效果瞅一眼

对话界面

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

⚡ 一键安装汉化版

Windows 用户 (PowerShell)

# 下载并执行安装脚本（注意：需要 UTF-8 编码）
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
Invoke-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

💡 脚本用了 CDN 加速，想看源码自己去搜一下就行。

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

📦 其他安装姿势

版本怎么选

我们也提供了两个版本源，看你需求：

版本 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 页面下载最新版也是可以的。
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

方法 3: Docker 部署

# 1. 初始化配置（第一次跑要用）
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
docker 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 部署指南。

🚀 怎么开始玩

装好之后：

💡 自动初始化: 用一键脚本安装的话，通常会自动带你跑初始化。要是想跳过，设个环境变量 OPENCLAW_SKIP_SETUP=1 就行。

# 启动初始化向导（全中文界面）
openclaw onboard

# 安装后台守护进程
openclaw onboard --install-daemon

第一次运行它会带你走一遍流程：

  1. 挑 AI 模型（Claude、GPT 或者本地模型都行）
  2. 填 API Key
  3. 选聊天软件（WhatsApp、Telegram 之类）
  4. 捏一个 AI 助手的人设

常用指令

openclaw                    # 启动程序
openclaw onboard            # 重新跑初始化
openclaw config             # 改配置
openclaw skills             # 管理技能
openclaw --help             # 救命，我不懂怎么用

🔄 怎么更新

汉化版怎么升级？看你当初怎么装的：
手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

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

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

一键脚本用户

重新跑一遍安装脚本就行，自动给你升到最新：

# Linux/macOS
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash

# Windows PowerShell
npm 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 Key 填写提示

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

🌐 Dashboard 网页控制台 (31 个模块)

分类 模块 细节
主布局 顶栏/侧栏 Logo、健康状态、菜单导航
主布局 资源链接 汉化官网、GitHub 链接
导航 顶部标签页 对话、概览、渠道、实例等等
对话 聊天界面 输入框、发送键、工具卡片
概览 系统状态 运行时间、模型列表、活跃会话
会话 会话管理 列表、详情、归档
渠道 消息渠道 WhatsApp、TG、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 插件

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

注意：你跟 AI 具体聊的内容取决于你用的模型，那个不归汉化管。

🔄 自动同步更新

  • 每小时 都会去瞄一眼官方仓库有没有动静
  • 自动 汉化、打包、测试
  • 同步发布 到 npm 和 GitHub Releases

版本号长这样：{官方版本}-zh.{日期}，比如 2026.1.29-zh.20260130

🔌 插件扩展

汉化版也能装 npm 插件，让 AI 更能打。我们也提供了一些官方插件。

插件市场

去看看有什么好用的插件：

怎么装插件

# 全局安装插件
npm install -g @qingchencloud/插件包名

# 比如装个更新检测插件
npm install -g @qingchencloud/openclaw-updater

装完重启一下 OpenClaw 就行。

有啥插件可用

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

💡 更多插件还在路上，记得常去 插件市场 看看。

更新检测插件

装了这个，它会：

  • 启动时自动查有没有新版
  • 你可以敲 /update 手动查
  • 敲 /version 看当前版本
# 安装
npm install -g @qingchencloud/openclaw-updater

# 使用
# 启动 OpenClaw 后自动检测
# 或者手动发个命令 /update

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

🐳 Docker 部署指南

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

自动初始化、配好远程访问、启动容器，一条龙服务：

# Linux / macOS
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash

# Windows PowerShell
irm 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 setup

docker 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 local

docker 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 → 进网页输 Token 就能连上。

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

远程访问大坑预警 ⚠️

如果你不是用 localhost 访问（比如用 IP），浏览器会因为安全原因卡住设备验证（Web Crypto API 必须要 secure context）。
✅ 最稳的解决办法：设 Token

# 1. 在服务器上设 Token
docker exec openclaw openclaw config set gateway.auth.token YOUR_TOKEN
docker restart openclaw

# 2. 浏览器打开
http://服务器IP:18789/overview

# 3. 在「网关令牌」那里填 YOUR_TOKEN，点连接

💡 解释：设了 gateway.auth.token 之后，就算浏览器提示不安全，只要 Token 对了就能连。
几种方案对比：
| 方案 | 咋弄 | 适合谁 |
| :— | :— | :— |
| 设 Token ⭐ | 配个 gateway.auth.token，网页输码 | 内网用最方便 |
| SSH 转发 | ssh -L 把端口映到本地 | 安全性最高 |
| Tailscale | 用 Tailscale Serve | 跨网访问 |
| Nginx + SSL | 反代 + HTTPS 证书 | 生产环境 |
⚠️ 别踩坑：不要只设 gateway.controlUi.allowInsecureAuth: true，那个有 Bug，必须要配合 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

或者你自己手写一个：

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# 在这填你的Token
    restart:unless-stopped
    # 远程访问要用下面这个命令（得先初始化过）
    # command: openclaw gateway run

volumes:
openclaw-data:

自己构建镜像

想魔改或者自己编译最新版的：

# 1. 克隆汉化项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd OpenClawChineseTranslation

# 2. 克隆上游源码
git clone https://github.com/openclaw/openclaw.git openclaw

# 3. 打汉化补丁
npm run cli -- apply

# 4. 构建镜像
cd openclaw
docker build -t openclaw-zh:local .

# 5. 跑起来
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw openclaw-zh:local

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

常用 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 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.git
cd OpenClawChineseTranslation

# 2. 克隆上游源码
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. 编译安装
cd openclaw
pnpm install
pnpm run build

# 7. 全局安装
npm install -g .

# 8. 验证
openclaw --version
openclaw --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）

自定义翻译

  1. 找文件：确认你要改哪个源文件
  2. 写规则：在 translations/ 目录对应的 JSON 文件里写 
    {
  "file": "src/path/to/file.ts",
  "description": "文件说明",
  "replacements": {
    "\"English Text\"": "\"中文翻译\""
  }
}
  3. 注册：在 translations/config.json 里加上这个文件
  4. 测试： 
    npm run cli -- apply --dry-run --verbose
npm run cli -- apply
npm run cli -- verify
  5. 提交：改好了记得提 PR！

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

🛠️ 开发者 / 贡献指南

想一起来完善汉化吗？

# 1. 克隆项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd OpenClawChineseTranslation

# 2. 克隆上游
git clone https://github.com/openclaw/openclaw.git openclaw

# 3. 搞起
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/                # 命令行界面翻译
│   │   ├── banner.json     # 启动画面
│   │   ├── tagline.json    # 标语
│   │   └── help.json       # 帮助文档
│   ├── wizard/             # 向导相关
│   │   ├── onboarding.json # 初始化流程
│   │   ├── security.json   # 安全提示
│   │   └── finalize.json   # 结束语
│   ├── tui/                # 终端界面
│   │   ├── waiting.json    # 加载动画
│   │   └── commands.json   # 斜杠命令
│   ├── commands/           # 各个具体命令
│   │   ├── status.json     # status
│   │   ├── update.json     # update
│   │   ├── skills.json     # skills
│   │   └── ...             # 其他
│   └── dashboard/          # 网页后台 UI (20+ 个文件)
│       ├── navigation.json # 菜单
│       ├── app-render.json # 主界面
│       ├── chat.json       # 聊天窗
│       ├── config.json     # 设置页
│       ├── schema.json     # 架构
│       ├── config-form-*.json  # 表单细节
│       ├── channels-*.json # 渠道配置
│       └── ...             # 其他模块
├── docs/                   # 文档
├── .github/workflows/      # 自动构建脚本
├── install.sh              # Mac/Linux 脚本
└── install.ps1             # Windows 脚本

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

怎么加新翻译

  1. 在 translations/ 下面建个新的 JSON
  2. 在 translations/config.json 里注册一下
  3. npm run cli -- apply --dry-run 看看对不对
  4. npm run cli -- verify 验一下
  5. 提 PR 给我们

详细的可以看 贡献指南 和 翻译规范。

项目地址

https://github.com/1186258278/OpenClawChineseTranslation/blob/main/README.md

手把手教你一键部署OpenClaw（Clawdbot），2分钟搞定！

# linux # AIGC
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区