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

Ne0inhk

— 11 min read

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

43-dify案例分享-MCP-Server让工作流秒变第三方可调用服务

43-dify案例分享-MCP-Server让工作流秒变第三方可调用服务

1.前言 之前我们为大家介绍过MCP SSE插件，它能够支持MCP-server在Dify平台上的调用，从而帮助Dify与第三方平台提供的MCP-server进行无缝对接。有些小伙伴提出了疑问：既然Dify可以通过MCP SSE插件调用其他平台的MCP-server，那么Dify的工作流或Chatflow是否也能发布为MCP-server，供其他支持MCP client的工具使用呢？今天，我们将为大家介绍一款Dify插件——mcp-server，它能够实现这一功能，即将Dify的工作流或Chatflow发布为MCP-server，供其他第三方工具调用。 插件名字叫做MCP-server，我们在dify插件市场可以找到这个工具 Mcp-server 是一个由 Dify 社区贡献的 Extension 类型插件。安装后，你可以把任何 Dify 应用转变成符合 MCP 标准的 Server Endpoint，供外部 MCP 客户端直接访问。它的主要功能包括： * **暴露为 MCP 工具：**将 Dify 应用抽象为单一 MCP 工具，供外部 MCP 客户端（如

By Ne0inhk
【大模型系列篇】大模型基建工程：基于 FastAPI 自动构建 SSE MCP 服务器

【大模型系列篇】大模型基建工程：基于 FastAPI 自动构建 SSE MCP 服务器

今天我们将使用FastAPI来构建 MCP 服务器，Anthropic 推出的这个MCP 协议，目的是让 AI 代理和你的应用程序之间的对话变得更顺畅、更清晰。FastAPI 基于 Starlette 和 Uvicorn，采用异步编程模型，可轻松处理高并发请求，尤其适合 MCP 场景下大模型与外部系统的实时交互需求，其性能接近 Node.js 和 Go，在数据库查询、文件操作等 I/O 密集型任务中表现卓越。 开始今天的正题前，我们来回顾下相关的知识内容： 《高性能Python Web服务部署架构解析》、《使用Python开发MCP Server及Inspector工具调试》、《构建智能体MCP客户端：完成大模型与MCP服务端能力集成与最小闭环验证》   FastAPI基础知识 安装依赖 pip install uvicorn, fastapi FastAPI服务代码示例  from fastapi import FastAPI app

By Ne0inhk
【MCP】详细了解MCP协议：和function call的区别何在？如何使用MCP？

【MCP】详细了解MCP协议：和function call的区别何在？如何使用MCP？

本文介绍了MCP大模型上下文协议的的概念，并对比了MCP协议和function call的区别，同时用python sdk为例介绍了mcp的使用方式。 1. 什么是MCP？ 官网：https://modelcontextprotocol.io/introduction 2025年，Anthropic提出了MCP协议。MCP全称为Model Context Protocol，翻译过来是大模型上下文协议。这个协议的主要为AI大模型和外部工具（比如让AI去查询信息，或者让AI操作本地文件）之间的交互提供了一个统一的处理协议。我们常用的USB TypeC接口（USB-C）统一了USB接口的样式，MCP协议就好比AI大模型中的USB-C，统一了大模型与工具的对接方式。 MCP协议采用了C/S架构，也就是服务端、客户端架构，能支持在客户端设备上调用远程Server提供的服务，同时也支持stdio流式传输模式，也就是在客户端本地启动mcp服务端。只需要在配置文件中新增MCP服务端，就能用上这个MCP服务器提供的各种工具，大大提高了大模型使用外部工具的便捷性。 MCP是开源协议，能让所有A

By Ne0inhk
超详细图文教程：用vscode+copilot(代理模式)便捷使用mcp+一个范例：用自然语言进行3d建模

超详细图文教程：用vscode+copilot(代理模式)便捷使用mcp+一个范例：用自然语言进行3d建模

在vscode使用claude mcp吧！ 在vscode更新到最新版本（注意，这是前提）后，内置的copilot可以使用mcp了！！！ 关于mcp（Model Context Protocol 模型上下文协议），可以参考我的上一篇文章： MCP个人理解+示例+集成管理+在python中调用示例，给AI大模型装上双手-ZEEKLOG博客 以下是使用教程： 1.点击左下角的齿轮状设置按钮，点击设置 2.在输入面板输入chat.agent.enabled，勾上勾选框 3.点击Ctrl+shift+P，输入reload，点击重新加载窗口，刷新窗口 4.打开copilot后，在右下角将模式改为代理即可。 5.点击工具按钮，开始安装mcp 先去github找到自己想要添加的mcp服务，以blender MCP为例，打开https://github.com/ahujasid/blender-mcp，可以在readme文档里看到详细的安装过程。可以看到，

By Ne0inhk