【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南：一键脚本/Docker/npm 三模式安装+Ubuntu 环境配置+中文汉化界面适配开源版

Ne0inhk

— 12 min read
【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南：一键脚本/Docker/npm 三模式安装+Ubuntu 环境配置+中文汉化界面适配开源版

OpenClaw这是什么？

OpenClaw（曾用名 Clawdbot / Moltbot）是一个开源的个人 AI 助手平台（GitHub 120k+ Stars），可以通过 WhatsApp、Telegram、Discord 等聊天软件与 AI 交互。简单说就是：在你自己的机器上运行一个 AI 助手，通过常用聊天软件跟它对话。

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南
forks项目仓库 ：https://github.com/MaoTouHU/OpenClawChinese

文章目录

原版是全英文的，开源社区伙伴做了一个中文发行版：

特点说明
开箱即用npm 一键安装 / Docker 一键部署，不需要手动打补丁
实时同步每小时自动从官方仓库拉取最新代码并构建
双版本stable（稳定版）和 nightly（最新版）可选
深度汉化CLI + Dashboard 全中文界面

forks项目地址：GitHub - OpenClawChinese: 🦞 OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入 | WhatsApp/Telegram/Discord 多平台 | 每小时自动同步 | CLI + Dashboard 全中文

汉化效果预览

先看看效果，Dashboard 界面全中文：

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

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

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

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

渠道管理 - WhatsApp、Telegram、Discord 等多平台支持：

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

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

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

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

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

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

【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

环境要求

项目要求
Node.js>= 22.12.0（必须）
Docker可选，服务器部署推荐
网络需要能访问 AI 模型 API

检查 Node.js 版本：

node -v # 输出应该是 v22.x.x 或更高

如果版本不够，去 Node.js 官网 下载最新 LTS 版本，或者用 nvm 管理：

# Linux/macOScurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh |bash nvm install22 nvm use 22# Windows 用 nvm-windows# https://github.com/coreybutler/nvm-windows

安装方式

提供三种方式，根据自己情况选择。

方式 A：一键脚本（推荐新手）

最简单的方式，下载执行脚本自动完成安装。

Linux / macOS：

curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.sh &&bash install.sh

Windows PowerShell：

Invoke-WebRequest-Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.ps1"-OutFile "install.ps1";.\install.ps1

脚本会自动：

  1. 检查 Node.js 版本
  2. 安装中文版 npm 包
  3. 尝试运行初始化配置

方式 B：npm 手动安装

如果脚本有问题，可以手动安装：

# 稳定版（推荐）npminstall -g @qingchencloud/openclaw-zh@latest # 或者 nightly 版（每小时同步上游最新代码）npminstall -g @qingchencloud/openclaw-zh@nightly

验证安装：

openclaw --version openclaw --help

如果 --help 输出是中文，说明安装成功。

方式 C：Docker 部署（服务器推荐）

在服务器上运行，或者不想污染本地环境，用 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

启动后访问 http://localhost:18789 打开 Dashboard。

首次配置

安装完成后，需要进行初始化配置。

运行初始化向导

openclaw onboard

这是一个交互式向导，会引导你完成：

  1. 选择 AI 模型：支持 Claude、GPT、本地模型等
  2. 配置 API Key：根据选择的模型输入对应的 API Key
  3. 设置聊天通道：可以连接 WhatsApp、Telegram 等
  4. 创建助手人格：给你的 AI 起个名字，设置性格

整个过程都是中文界面，跟着提示走就行。

安装守护进程（可选）

如果希望 OpenClaw 在后台持续运行：

openclaw onboard --install-daemon

常用命令速查

openclaw # 启动（交互模式） openclaw onboard # 初始化向导 openclaw config # 查看配置 openclaw config set key val # 修改配置 openclaw skills # 管理技能插件 openclaw status # 查看运行状态 openclaw gateway run # 启动网关（Dashboard）

Docker 服务器部署详解

这部分重点讲一下在服务器上部署并远程访问的配置，因为这里坑比较多。

本地访问 vs 远程访问

场景访问地址配置复杂度
本机运行，本机访问http://localhost:18789简单
服务器运行，远程访问http://服务器IP:18789需要额外配置

为什么远程访问需要额外配置？

OpenClaw 的 Dashboard 使用 Web Crypto API 进行设备身份验证，这个 API 在非 HTTPS 环境下只能在 localhost 使用。简单说就是：通过 HTTP 远程访问时，浏览器安全策略会阻止认证。

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

项目提供了一键部署脚本，自动完成环境检测、初始化、配置远程访问：

# 自动生成 Tokencurl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh |bash# 或者指定 Tokencurl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh |bash -s -- --token 你的密码 # 仅本地访问（不配置远程）curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh |bash -s -- --local-only

脚本会自动：

  1. 检查 Docker 环境
  2. 拉取镜像
  3. 创建数据卷
  4. 初始化配置
  5. 配置远程访问（Token 认证）
  6. 启动容器

部署完成后会显示访问地址和 Token。

方式 2：手动配置步骤

如果想手动控制每一步：

# 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# 4. 配置远程访问（允许局域网访问）docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan # 5. 设置访问令牌（重要！远程访问必须）docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的密码 # 6. 启动容器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，点击连接即可。

方式 3：Docker Compose

项目提供了 docker-compose.yml：

# 下载配置文件curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-compose.yml -o 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=${OPENCLAW_GATEWAY_TOKEN:-}restart: unless-stopped command: openclaw gateway run --allow-unconfigured volumes:openclaw-data:name: openclaw-data

首次需要初始化配置：

# 启动容器（首次会自动创建卷）docker-compose up -d # 初始化配置docker-composeexec openclaw openclaw setup docker-composeexec openclaw openclaw config set gateway.mode local# 远程访问配置（可选）docker-composeexec openclaw openclaw config set gateway.bind lan docker-composeexec openclaw openclaw config set gateway.auth.token 你的密码 # 重启生效docker-compose restart

踩坑记录

分享几个实际踩过的坑：

坑 1：挂载路径错误

OpenClaw 容器以 root 用户运行，配置文件在 /root/.openclaw，不是 /home/node/.openclaw。

# 错误（配置不会持久化） -v openclaw-data:/home/node/.openclaw # 正确 -v openclaw-data:/root/.openclaw

坑 2：必须先初始化再启动

容器启动前必须先运行 openclaw setup，否则会报错：

Missing config. Run openclaw setup

使用一键脚本或按照上面的步骤顺序执行就不会遇到这个问题。

坑 3：远程访问报 1008 错误

如果看到这样的错误：

disconnected (1008): control ui requires HTTPS or localhost disconnected (1008): device identity required

这是因为没有配置 Token。浏览器安全策略阻止了非 HTTPS 环境下的设备认证。

解决方法：设置 gateway.auth.token

# 容器已运行的情况下dockerexec openclaw openclaw config set gateway.auth.token 你的密码 docker restart openclaw

然后在 Dashboard 的「网关令牌」输入框填入 Token 连接。

坑 4：allowInsecureAuth 配置不生效

官方文档提到的 gateway.controlUi.allowInsecureAuth: true 配置存在上游 Bug，单独使用不起作用。必须配合 gateway.auth.token 使用。

坑 5：package: 拉取 Docker 镜像…Error response

:package: 拉取 Docker 镜像… Error response from daemon: error from registry: denied denied root@racknerd-bbcd572:~# curl -sL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | grep “IMAGE=” IMAGE=“ghcr.io/qingchencloud/openclaw-zh:latest” root@racknerd-bbcd572:~#
【汉化中文版】OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南

常见问题

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

可能安装了原版。先卸载再安装中文版：

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

Q：Dashboard 打不开？

  1. 确认容器在运行：docker ps
  2. 确认端口没被占用：netstat -tlnp | grep 18789
  3. 查看容器日志：docker logs openclaw

Q：Docker 重启后配置丢失？

检查挂载路径是否正确（应该是 /root/.openclaw），以及是否使用了命名卷而不是匿名卷。

Q：如何更新到最新版？

# npm 安装npm update -g @qingchencloud/openclaw-zh # Dockerdocker pull ghcr.io/1186258278/openclaw-zh:nightly docker stop openclaw &&dockerrm openclaw # 重新启动（配置保留在数据卷中）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：如何彻底卸载？

# 卸载 npm 包npm uninstall -g @qingchencloud/openclaw-zh # 删除配置文件（可选，会删除所有数据）rm -rf ~/.openclaw # Docker 方式docker stop openclaw &&dockerrm openclaw docker volume rm openclaw-data

其他远程访问方案

除了 Token 认证，还有其他方案：

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

常用 Docker 命令

# 查看日志docker logs -f openclaw # 重启服务docker restart openclaw # 停止服务docker stop openclaw # 进入容器dockerexec -it openclaw sh# 查看当前配置dockerexec openclaw cat /root/.openclaw/openclaw.json

版本说明

中文发行版提供两个版本：

版本npm 标签Docker 标签更新频率
稳定版@latest:latest手动发布，经过测试
最新版@nightly:nightly每小时自动同步上游

推荐日常使用稳定版，想体验最新功能用 nightly。

官方发布新功能后，中文版最快 1 小时内可用。

总结

这个中文发行版会每小时自动同步上游更新，功能和官方保持一致，界面是中文的，开箱即用。

如果使用过程中遇到问题，可以在 GitHub 仓库提 Issue。也欢迎有兴趣的佬友参与贡献。

forks项目地址：GitHub - OpenClawChinese: 🦞 OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入 | WhatsApp/Telegram/Discord 多平台 | 每小时自动同步 | CLI + Dashboard 全中文：https://github.com/MaoTouHU/OpenClawChinese

参考资料

汉化作者：https://openclaw.qt.cool/
讨论帖子：https://linux.do/t/topic/1548258

本文基于汉化原作者✍️「晴天」实际搭建经验整理，如有错误欢迎指正。

Read more

Git 入门：第一次将本地项目上传到 GitHub 仓库详细教程

一、背景信息         作为开发者，将本地代码托管到远程仓库（如 GitHub、Gitee 等）是一个基本且重要的技能。这不仅方便代码备份，还能轻松进行版本控制和团队协作。         本文将详细介绍如何将你已经存在的本地项目，第一次完整地上传到 GitHub 上的一个新的空白仓库。这与 git clone（从远程下载仓库）的操作是相反的。         我们将一步步走过 Git 命令的操作流程，并附带一些常见问题的处理和进阶技巧。 二、上传操作 2.1 目标读者         刚开始使用 Git，不熟悉命令行的开发者。         想将本地已有项目托管到 GitHub 的用户。 2.2 前提准备 1. 已安装 Git 并配置好用户信息（git config --global user.name "Your Name&

By Ne0inhk
小白程序员必备：精选9大靠谱开源技术栈，轻松入门大模型开发 & 收藏这份实用指南

小白程序员必备：精选9大靠谱开源技术栈，轻松入门大模型开发 & 收藏这份实用指南

构建 AI 智能体应用市面上有很多工具，本文根据我们的实践落地经验，给大家推荐一份经过筛选的靠谱开源技术栈，包括：开发 & 编排框架、记忆、文档理解、计算机控制、语音功能、测试与评估、监控与可观测性、模拟环境、垂直智能体等9个方向，如下图所示： 下文我们详细剖析之。 构建 AI 智能体技术栈 1、构建 AI 智能体的技术栈总览 * 构建和协调 AI 智能体的框架 如果你是从零开始构建 AI 智能体，就从这里入手。这些工具可以帮助你构建 AI 智能体的逻辑结构——何时做什么以及如何处理工具。你可以将其视为核心大脑，将原始语言模型转变为更具自主性的工具。 * 计算机和浏览器使用 一旦你的 AI 智能体能够规划，它就需要行动。这一类别的工具可以让 AI 智能体像人类一样点击按钮、在字段中输入文字、抓取数据以及控制应用程序或网站。 * 语音

By Ne0inhk

OpenClaw相关的开源AI项目汇总大全：本文涵盖近期所有OpenClaw相关的GitHub高星star热门项目

OpenClaw相关的开源AI项目汇总大全：本文涵盖近期所有OpenClaw相关的GitHub高星star热门项目 💡 导读 GitHub上这些OpenClaw开源项目，Star数为什么能破千？我们扒了13个宝藏仓库后发现… 有人用OpenClaw给钉钉搭了智能助手，有人在飞书里养了个AI女友Clawra，还有人把记忆层memU玩成了第二大脑——而这些全部免费开源！ 2026年OpenClaw热度飙升，但官方文档晦涩、部署门槛高劝退无数人？别慌！本文汇总了OpenClawInstaller、OneClaw、Moltworker等13个硬核开源项目，覆盖：✅ 一键部署工具（零代码上手）✅ 钉钉/企微/飞书/微信全平台接入方案✅ 云端托管+本地Sandbox双模式✅ 记忆层memU、技能库Skills、甚至AI女友Clawra… 收藏这一篇，省掉你100个小时的踩坑时间！ 文章目录 * OpenClaw相关的开源AI项目汇总大全：本文涵盖近期所有OpenClaw相关的GitHub高星star热门项目 * 💡 导读 * 一、OpenClawInstall

By Ne0inhk
在 GitHub 上生成和配置个人访问令牌（PAT），并将其用于 R 环境中的凭证管理和包安装。

在 GitHub 上生成和配置个人访问令牌（PAT），并将其用于 R 环境中的凭证管理和包安装。

在 GitHub 上生成和配置个人访问令牌（PAT），并将其用于 R 环境中的凭证管理和包安装。 1. 生成 GitHub 个人访问令牌（PAT） 1. 访问 GitHub 设置页面打开浏览器，访问 GitHub 的 个人访问令牌 生成页面：GitHub Personal Access Tokens 2. 登录 GitHub 账户如果你尚未登录，请输入 GitHub 的用户名和密码登录。 3. 生成新的个人访问令牌（PAT） * 在 Personal access tokens 页面，点击 Generate new token（生成新令牌）。 * 在打开的页面中，填写以下内容：例如，你可以选择如下权限： * Note:

By Ne0inhk