OpenClaw汉化版

v2026.1.31-zh.2

🦞 OpenClaw（Clawd |Moltbot ） 汉化版 - 开源 AI 助手「龙虾爪」中文版 | WhatsApp/Telegram/Discord 多平台 | 每小时同步上游 | CLI + Dashboard 全中文

119 Stars
16 Forks
🌟 开源产品 分类
打开官网

项目文档

OpenClaw 汉化发行版

Release
npm
Nightly Build
Test Scripts
Platform
License

🔄 实时同步官方更新

特性 说明
⏰ 每小时同步 CI/CD 自动从上游 OpenClaw 拉取最新代码
🚀 自动构建发布 同步后立即构建 npm 包 + Docker 镜像，无需等待
📦 双版本可选 nightly（最新功能）/ stable（稳定版）

💡 延迟 < 1 小时：官方发布新功能后，汉化版最快 1 小时内可用！

官方网站    GitHub Pages

📑 快速导航

🚀 快速上手 📦 部署方式 🔧 使用维护 💡 帮助
什么是 OpenClaw 一键安装 快速开始 常见问题
汉化效果预览 npm 安装 更新升级 参与贡献
汉化内容 Docker 部署 手动汉化安装 关于我们

🦞 什么是 OpenClaw？ ↑ 返回目录

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

核心特性

特性 说明
🖥️ 运行在你的机器上 Mac、Windows 或 Linux，数据始终在本地，隐私优先
💬 任意聊天应用 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 都能用
🧠 持久记忆 记住你的偏好、上下文，成为专属于你的 AI
🌐 浏览器控制 自动浏览网页、填写表单、提取数据
⚡ 完整系统访问 读写文件、运行脚本、执行命令
🔌 技能插件系统 社区技能扩展，甚至可以自己编写新技能

它能做什么？

"清理你的收件箱、发送邮件、管理日历、办理航班值机……全部通过你常用的聊天应用完成。"

正如用户评价：

  • "这是我第一次感觉自己活在未来。" — @davemorin
  • "一切 Siri 本该成为的样子，而且远不止如此。" — @crossiBuilds
  • "它正在运行我的公司。" — @therno
  • "开源构建了一个比 Apple（3.6万亿美元公司）睡了多年的 Siri 更好的版本。" — @Hesamation

📸 汉化效果预览 ↑ 返回目录

概览仪表板
📊 概览仪表板 - 网关状态、实例监控、快捷操作一目了然

🖼️ 查看更多截图

对话界面
💬 对话界面 - 与 AI 助手实时交互

渠道管理
📱 渠道管理 - WhatsApp、Telegram、Discord 等全平台支持

配置中心
⚙️ 配置中心 - 30+ 配置项完整汉化

节点配置
🖥️ 节点配置 - 执行审批、安全策略管理

技能插件
🔌 技能插件 - 1Password、Apple Notes 等丰富扩展

⚡ 一键安装汉化版 ↑ 返回目录

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

💡 使用 jsDelivr CDN 加速 | 🔒 查看脚本源码

📦 其他安装方式 ↑ 返回目录

版本选择

我们提供两个版本源，根据需求选择：

版本 npm 标签 更新频率 适用场景
稳定版 @latest 手动发布 生产环境，经过测试，推荐使用
最新版 @nightly 每小时自动 测试新功能，追踪上游最新代码

方式 1: npm 安装

# 稳定版（推荐）
npm install -g @qingchencloud/openclaw-zh@latest

# 最新版（每小时更新，追踪上游）
npm install -g @qingchencloud/openclaw-zh@nightly

方式 2: 手动下载

访问 Releases 页面 下载最新版本。

方式 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 密钥
  3. 设置聊天通道（WhatsApp、Telegram 等）
  4. 创建你的 AI 助手人格

常用命令

openclaw                    # 启动 OpenClaw
openclaw 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/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 密钥、模型选择提示

🌐 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

🐳 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 → 在 Dashboard 输入 token 连接

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

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

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

# 1. 设置访问令牌（在服务器上执行）
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 后，即使通过远程 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），单独使用不起作用，必须配合 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 run

volumes:
  openclaw-data:

自行构建 Docker 镜像

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

# 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. 构建 Docker 镜像
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

常用 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

🔧 手动汉化安装 ↑ 返回目录

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

完整流程

# 1. 克隆汉化项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd 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. 构建 OpenClaw
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：欢迎贡献你的翻译！

🛠️ 开发者 / 贡献者指南 ↑ 返回目录

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

# 1. 克隆本项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd 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 安装脚本

添加新翻译

  1. 在 translations/ 目录下创建或编辑 JSON 文件
  2. 在 translations/config.json 中注册新文件
  3. 运行 npm run cli -- apply --dry-run 预览
  4. 运行 npm run cli -- verify 验证
  5. 提交 PR

详见 贡献指南 和 翻译规范

❓ 常见问题 ↑ 返回目录

Q: 安装后运行还是英文？

先卸载原版，再安装汉化版：

npm uninstall -g openclaw
npm install -g @qingchencloud/openclaw-zh@latest

Q: 如何更新到最新版？

npm update -g @qingchencloud/openclaw-zh

Q: 需要什么环境？

  • Node.js >= 22.12.0
  • 网络连接（用于 API 调用）

Q: 与 AI 对话是中文吗？

对话语言取决于你使用的 AI 模型，与本汉化项目无关。Claude、GPT 等模型都支持中文对话。

Q: 如何切换回原版？

npm uninstall -g @qingchencloud/openclaw-zh
npm install -g openclaw

Q: 如何彻底卸载？

Windows (PowerShell):

# 卸载汉化版
npm uninstall -g @qingchencloud/openclaw-zh

# 卸载原版（如果也安装了）
npm uninstall -g openclaw

# 清理配置文件（可选，会删除所有数据）
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

# 验证卸载
openclaw --version  # 应提示命令不存在

Linux / macOS:

# 卸载汉化版
npm uninstall -g @qingchencloud/openclaw-zh

# 卸载原版（如果也安装了）
npm uninstall -g openclaw

# 清理配置文件（可选，会删除所有数据）
rm -rf ~/.openclaw

# 验证卸载
openclaw --version  # 应提示命令不存在

⚠️ 注意：npm uninstall openclaw 不会卸载汉化版，必须使用完整包名 @qingchencloud/openclaw-zh

Q: Dashboard 如何访问？

启动 OpenClaw 后，访问 http://localhost:18789 即可打开网页控制台（全中文界面）。

Q: Dashboard 显示 gateway token mismatch 怎么办？

这是 Token 认证失败。你需要使用 带 token 的 URL 访问 Dashboard。

解决方法（推荐）：

# 使用命令自动打开带 token 的 Dashboard
openclaw dashboard

# Docker 环境下，先获取 token URL
docker exec openclaw openclaw dashboard --print-url
# 输出类似：http://localhost:18789?token=abc123...
# 复制这个 URL 到浏览器打开

手动方法：

  1. 查看你的 gateway token：

    openclaw config get gateway.token
# 或 Docker 环境
docker exec openclaw openclaw config get gateway.token

  2. 在浏览器 URL 后添加 ?token=你的token：

    http://localhost:18789?token=你的token值

💡 提示：直接访问 http://localhost:18789 不带 token 会导致此错误。推荐始终使用 openclaw dashboard 命令打开。

Q: Dashboard 连接显示 pairing required 怎么办？

这是 OpenClaw 的设备配对安全机制。每个浏览器首次连接 Gateway 时，需要管理员批准配对请求。

解决步骤：

# 1. 查看待配对的设备列表
docker exec openclaw openclaw devices list --password '你的网关密码'
# 会显示 Pending (待批准) 和 Paired (已配对) 两个表格

# 2. 复制 Pending 表格中的 Request ID，批准配对
docker exec openclaw openclaw devices approve <Request-ID>

# 3. 在 Dashboard 页面点击"连接"按钮，即可成功连接

示例：

# 查看设备列表
$ docker exec openclaw openclaw devices list --password 'mytoken123'
Pending (1)
┌──────────────────────────────────────┬─────────────┬──────────┐
│ Request                              │ Device      │ Role     │
├──────────────────────────────────────┼─────────────┼──────────┤
│ 693d5641-e67f-4fa5-a096-25551ac5fe4b │ f1e3aa21... │ operator │
└──────────────────────────────────────┴─────────────┴──────────┘

# 批准配对请求
$ docker exec openclaw openclaw devices approve 693d5641-e67f-4fa5-a096-25551ac5fe4b
Approved f1e3aa21...

💡 提示：刷新页面、换浏览器、清除缓存或使用无痕模式都会产生新的设备 ID，需要重新批准配对。

Q: Docker 拉取镜像提示 denied？

清理 Docker 登录缓存后重试：

docker logout ghcr.io
docker pull ghcr.io/1186258278/openclaw-zh:nightly

Q: Docker 容器一直重启？

通常是没有初始化配置。先查看日志：

docker logs openclaw

如果提示 Missing config 或 gateway.mode，按以下步骤重新配置：

# 停止并删除容器
docker stop openclaw && docker rm openclaw

# 初始化配置
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

# 重新启动
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

Q: 远程访问 Dashboard 连不上？

通过 HTTP 远程访问时，需要设置 Token 认证：

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

然后打开 http://服务器IP:18789，在「网关令牌」输入框填入 token，点击「连接」即可。

Q: npm 安装后内网其他电脑无法访问？

问题：在服务器上用 npm 安装 OpenClaw，内网其他电脑访问 http://服务器IP:18789 失败。

原因：默认情况下 Gateway 只监听 127.0.0.1（本机），需要配置为监听所有网络接口。

解决步骤：

# 1. 配置 Gateway 绑定到局域网
openclaw config set gateway.bind lan

# 2. 设置访问令牌（必须，否则内网访问会被拒绝）
openclaw config set gateway.auth.token '你的密码'

# 3. 安装后台守护进程（可选，让 OpenClaw 开机自启）
openclaw onboard --install-daemon

# 4. 重启 Gateway 生效
openclaw gateway restart

访问方式：http://服务器IP:18789，在「网关令牌」输入你设置的密码。

💡 提示：如果还是无法访问，检查服务器防火墙是否放行 18789 端口：

# Ubuntu/Debian
sudo ufw allow 18789

# CentOS/RHEL
sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload

🔗 相关链接 ↑ 返回目录

汉化版入口

链接 说明
🔥 openclaw.qt.cool 汉化版官网（推荐）
📦 GitHub Pages 备用下载页
📚 npm 包 npm 安装源
💻 GitHub 仓库 源代码

上游项目

链接 说明
OpenClaw 官网 原版官方网站
OpenClaw GitHub 上游仓库
OpenClaw Discord 官方社区
ClawHub 技能市场

🤝 参与贡献 ↑ 返回目录

我们欢迎各种形式的贡献：

📜 许可证 ↑ 返回目录

本项目基于 MIT License 开源。

OpenClaw 原项目由 Peter Steinberger 创建，版权归原作者所有。

🏢 关于我们 ↑ 返回目录

武汉晴辰天下网络科技有限公司 出品
🌐 官网 https://qingchencloud.com/
🔗 导航 https://qt.cool/
📧 联系 通过官网联系我们

主营业务：程序定制、软件开发等

© 武汉晴辰天下网络科技有限公司 | 鄂ICP备2025164966号