更适合中国宝宝体质的OpenClaw部署方案 OpenClaw-CN 本地部署流程分享

本文分享了基于 OpenClaw-CN 项目的 OpenClaw 国内部署方案，OpenClaw-CN 针对国内网络环境和常见配置问题做了优化说明。内容涵盖OpenClaw安装、Gateway 启动、飞书渠道配置等实用技巧，帮助大家快速搭建、运行 OpenClaw 服务，让初学者都能轻松上手。

一、项目简介

项目地址：https://clawd.org.cn

OpenClaw‑CN 是一个由社区开发者基于 OpenClaw 开源项目深度本地化并持续维护的中文版本。该版本将原版的 CLI、Web 控制界面、配置向导、文档和渠道接入等全部完整汉化，并针对国内网络环境进行了依赖构建和镜像优化，帮助中国开发者更容易部署和使用个人 AI 助手。

原版 OpenClaw 是一个开源的自主 AI 助手框架，你可以将它部署到自己的设备或服务器上，通过常用的聊天应用（如 WhatsApp、Telegram、Discord 等）与 AI 模型互动，并自动完成日常任务，如日程管理、邮件自动处理和自动化浏览等。

OpenClaw‑CN 是该项目的中文社区版，由开发者 jiulingyun 维护。它不是官方版本，但与上游保持定期同步，并加入了对飞书渠道和国内网络依赖的优化，使其在国内环境下更顺畅。

二、为什么选择 OpenClaw‑CN

相比官方 OpenClaw，在中国部署会面临以下实际问题：

官方依赖直接从国外源拉取，国内网络较慢甚至失败；
文档和界面主要为英文；
部分国外渠道集成对国内用户价值有限。

而 OpenClaw‑CN 通过：

完整汉化 支持命令行、Web UI、提示文本等全部中文；
依赖本地镜像 预构建 npm 包，淘宝镜像即可快速安装；
已 内置飞书渠道支持，在国内办公环境中更有用；

因此更适合国内开发者使用。

三、环境准备

在开始部署前，请确认以下环境准备就绪：

运行环境
- Node.js ≥ 22（推荐最新 LTS）
- npm、pnpm 或 yarn
- 一个可以访问 npm 镜像源的终端
服务器或电脑
- Linux、macOS 或 Windows（WSL2 推荐）
- 2GB 以上内存（推荐 4GB 以上）

这里我使用 Ubuntu 24.04.4 Desktop 虚拟机来演示本次操作。使用 MINIMAX 接入，现在注册送 Coding Plan Trial (7天) 。本文省略了 Ubuntu 虚拟机的安装，如有需要可以评论区留言。

四、快速配置指南

全局安装并配置飞书渠道

我们直接使用 macOS / Linux 国内一键安装脚本：

curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com

更适合中国宝宝体质的OpenClaw部署方案 OpenClaw-CN 本地部署流程分享

【我理解这很强大且本质上存在风险。继续吗？】这一步直接方向左键选择【Yes】回车，要不也没办法安装。

安装引导模式，选择【快速开始】

【模型/认证提供商】这里我就选择 MiniMax 了，认证方法选择 MiniMax M2.5。

访问 MINIMAX 官网：https://minimaxi.com 注册账户并实名认证。找到【账户管理】-【接口密钥】-【Coding Plan Key】-【重置并复制】。

粘贴到 MiniMax API Key 中【回车】。

【默认模型】保持当前即可。

【选择通道】这里我们选择 feishu（飞书）。

【安装 feishu 插件】这里我们选择使用本地插件路径。

稍等片刻，【选择平台】这里我们选择【飞书（国内版）】。

这里先到飞书开放平台：https://open.feishu.cn 注册并登录后台，创建企业自建应用。

这里设置下【应用名称】【应用描述】【应用图标】后创建。

我们先到【凭证与基础信息】这里，复制 App ID 和 App Secret 到【终端】中。

输入完成后回车，【现在配置技能？】选择【Yes】。

【技能安装的首选节点管理器】选择【npm】，启用钩子，下面三个都按【空格】键勾选上，然后【回车】。

稍等片刻，安装完成！这时会给一个仪表盘的链接，先记下来。

使用如下命令启动 OpenClaw‑CN 的 Gateway 服务：

openclaw-cn gateway --port 18789 --verbose

这时候我们的【网关仪表盘（http://127.0.0.1:18789/?token=xxx）】应该就能正常打开了。

没问题的话现在应该已经可以对话了，不过还没结束。

我们继续配置飞书机器人，【添加应用能力】选择【机器人】添加。

配置机器人名称后保存。

【权限管理】-【批量导入导出权限】粘贴如下内容确认：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}