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

【汉化中文版】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

昇腾 (Ascend) NPU 实战指南:在 GitCode Notebook 中玩转 CodeLlama

昇腾 (Ascend) NPU 实战指南:在 GitCode Notebook 中玩转 CodeLlama

1.前言 随着大模型技术在软件开发领域的深入应用,越来越多的开发者开始尝试在本地或云端环境部署代码生成模型。华为昇腾(Ascend)计算产业随着 CANN 软件栈的不断成熟,已成为运行各类开源 LLM 的重要算力底座。 本文将以 CodeLlama 这一广受欢迎的代码生成模型为核心,结合 GitCode Notebook 提供的在线开发环境,讲解如何在本地或服务器的昇腾 NPU 环境中完成从依赖配置、模型加载到代码生成的完整流程。文章将通过结构化的流程讲解与可操作的示例代码,引导你在昇腾生态中顺利完成 CodeLlama 的部署与运行。 接下来我们就开始进行动手实践吧。 GitCode官网:https://gitcode.com/。 2.GitCode Notebook 环境准备 GitCode 是面向中国开发者的一站式代码协作与模型应用平台,集成了开源仓库托管、在线运行环境、模型中心等能力。其中的 GitCode Notebook 提供了无需本地配置的云端交互式开发环境,支持直接在浏览器中编写、运行和调试代码,非常适合进行大模型试验与算子验证。 进入Gitcode官网

By Ne0inhk
Git 到底是干啥的?零基础小白听完都懂了并且轻松驾驭它

Git 到底是干啥的?零基础小白听完都懂了并且轻松驾驭它

git,通俗的来说就是一种用来多人文件版本合作的工具,但是对一些非程序员的项目小白或者没有程序基础的但是想要入行做程序员的人来说,完完全全理解起来稍微有点困难。这篇文章不像很多文章一样是枯涩的码字教学。现在,我们就用最通俗易懂的方式,让你从零基础理解他,并且使用他。这种教学方法不是把你当白痴的教学方法,反而是让你快速入门深刻理解它,并记住它的教学方法。因为可能说得比较详细,篇幅较长,还得请你耐心的把他看完。 一、git的作用 1、git的版本控制 文件永远不会只有一个版本,这句话我们似乎用亲身经历证明过。你是否有过以下经历👇 📘论文会有“终稿v1、终稿v2、终稿最终版”、 ✍设计稿会有“改版A、改版B、改版C”、 🧺甚至自己写的文章也会来回改十几遍。 🥚更不用说单独只通过一个本地夹操刀一个大型项目了 突然有一天你觉得你的论文、设计稿、文章、项目某一个节点开始脱离了原本的方向或者发生了一些错误,但是你已经对其进行多处修改了,单独再修改不仅费事废经历,还容易发生遗漏。 你或许信誓旦旦的告诉我,你可以这样做。。。👇 论文_最终v1.docx 论文_

By Ne0inhk
【保姆级喂饭教程】Git图形化客户端Sourcetree安装及使用教程

【保姆级喂饭教程】Git图形化客户端Sourcetree安装及使用教程

目录 * 前言 * 一、SourceTree简介 * 二、安装教程 * 三、使用教程 * 1. Local(本地仓库) * 2. Remote(远程仓库) * 3. Clone(克隆仓库) * 4. Add(添加仓库) * 5. Create(创建仓库) * 6. Git Flow * 四、评价总结 * 后记 * 参考文献 前言 在查找Git Flow实现工具的时候,看到了SourceTree,支持Git Flow、GitHub Flow等多种Git工作流,安装简单学习一下。 一、SourceTree简介 Git的GUI客户端有很多,SourceTree是其中比较优秀和流行的一个,如下图: https://git-scm.com/downloads/guis SourceTree是一款免费的Git图形化客户端,

By Ne0inhk
GitHub 7大爆款Skills开源项目:Anthropic官方Skill Creator元技能+Superpowers 27k星任务拆解+Code Review自动代码审查

GitHub 7大爆款Skills开源项目:Anthropic官方Skill Creator元技能+Superpowers 27k星任务拆解+Code Review自动代码审查

Claude Agent Skills工具箱|GitHub 7大开源项目:Anthropic Skill Creator+Superpowers+Code Review+Context Engineering,AI元技能开发与上下文优化指南 技术背景:为什么Claude Skills是2025年AI Agent开发的必选项 随着Anthropic Claude在大模型领域的持续领跑,其Skills(技能)生态已成为AI Agent工程化落地的关键基础设施。与传统Prompt工程不同,Skills通过结构化的SKILL.md文件,将AI能力封装为可复用、可共享、可迭代的模块化组件,实现从"对话式交互"到"任务式执行"的范式转变。 当前,GitHub开源社区已涌现大量高质量的Claude Skills项目,涵盖元技能开发、代码审查自动化、上下文工程优化等核心场景。本文系统梳理7大高星开源项目,附完整技术解析与安全实践指南。 文章目录 * Claude Agent

By Ne0inhk