大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



本文将教你如何把 OpenClaw-CN 搞上你的机器。严格按照官方文档核实，确保每一步都准确无误——至少比隔壁老王的教程靠谱。

---

OpenClaw 是一个私有化部署的 AI 智能助手，让你能在各种聊天平台（飞书、Telegram、Signal、WhatsApp 等）里跟 AI 对话。

中文社区版特点：

• 🇨🇳 完整中文化 — CLI、Web 控制界面、配置向导全部汉化，不用再看谷歌翻译的脸色
• 🏠 本地优先 — 数据存储在你自己的设备上，隐私可控（别让你的 AI 聊天记录被卖到暗网）
• 📱 多渠道支持 — WhatsApp、Telegram、Slack、Discord、Signal、iMessage、微信（开发中，别催）
• 🔧 技能扩展 — 内置技能 + 自定义工作区技能，想让它干啥就干啥
• 🚀 国内优化 — 所有依赖包已构建为 npm 包，淘宝镜像源可直接下载，告别 GitHub 超时

重要声明： 本教程介绍的是 OpenClaw 中文社区版（openclaw-cn），非官方版本。目的是让国内用户快速接入，更适配国内网络环境。如果你是原版死忠粉，出门左转去 GitHub 搜 openclaw/openclaw。

OpenClaw 主界面预览

看，这就是你要安装的东西。界面是不是很清爽？比某些收费软件好看多了。

---

在开始安装之前，了解一下 OpenClaw 的架构，免得你装完了还不知道它是怎么工作的。

整体架构

OpenClaw 采用网关（Gateway）架构，简单来说就是：

核心组件：

1. Gateway（网关） — 大脑中枢，负责：
   • 接收来自各个聊天平台的消息
   • 调用 AI 模型生成回复
   • 管理会话和上下文
   • 调用技能和插件
2. Channels（渠道） — 消息通道，支持：
   • 飞书、Telegram、WhatsApp、Slack、Discord、Signal、iMessage 等
   • 每个渠道可以配置多个账号
3. Agents（智能体） — AI 核心，负责：
   • 调用各种 AI 模型（OpenAI、Anthropic、智谱、DeepSeek 等）
   • 处理对话上下文和记忆
   • 执行技能和工具调用
4. Workspace（工作区） — 本地数据，包括：
   • 配置文件（）
   • 记忆文件（）
   • 技能和插件
   • 日志文件
5. Skills（技能） — 扩展能力，比如：
   • GitHub 集成
   • 日历管理
   • 邮件处理
   • 智能家居控制

为什么要用网关架构？

• ✅ 统一接口 — 一个网关连接所有聊天平台，不用每个平台都单独配置
• ✅ 本地控制 — 数据在你自己手里，不用担心被卖到广告公司
• ✅ 灵活扩展 — 想加新功能就装技能，想换模型就改配置
• ✅ 隐私安全 — 默认本地运行，不经过第三方服务器

群组消息处理流程

如果你打算在群里用 OpenClaw，了解一下它是怎么处理群组消息的：

看不懂图？没关系，我来解释：

1. 群组消息 → 收到群里有人说话
2. 群组策略检查 → 这个群是否启用 OpenClaw？
   • ：直接丢弃，不处理
   • ：所有人都能用
   • ：只有白名单里的人能用
3. 白名单检查 → 这个人在不在白名单里？
   • 不在：丢弃消息
   • 在：继续处理
4. 提及检查 → 需要 @机器人 才回复吗？
   • 不需要：存储上下文，但不回复
   • 需要：调用 AI 生成回复
5. 回复 → 发送回复到群里

为什么这么设计？

• 避免机器人被群里的闲聊刷屏（省 API 费用）
• 权限控制，不是谁都能用
• 上下文管理，记住之前的对话

---

官方推荐的一键安装

最简单的方式（适合懒人）：

这个脚本会自动：

1. ✅ 检测并安装 Node.js（如果未安装，省得你自己折腾）
2. ✅ 安装 Git（如果需要）
3. ✅ 处理权限问题（别再问我为什么 sudo 不行了）
4. ✅ 安装 openclaw-cn
5. ✅ 自动运行配置向导

适用场景：

• macOS 或 Linux 系统
• 首次安装，没有 Node.js 环境
• 希望自动处理所有依赖
• 你懒得手动配置

友情提示： 如果你连 curl 都没有，那建议先学习一下 Linux 基础。这不是嘲讽，是真的。

国内用户加速：

如果 curl 速度慢（虽然已经很快了），可以先配置镜像源：

---

系统要求

支持的操作系统：

• macOS 12+（Apple Silicon 或 Intel，都行，别问 M1/M2 支不支持）
• Linux（Ubuntu、Debian、CentOS 等主流发行版）
• Windows 10/11（通过 WSL2，原生支持？你想多了）

必需软件：

• Node.js ≥ 22（⚠️ 这是硬性要求，别拿 Node 18 来碰瓷，也别问我为什么 16 不行）
• npm 或 pnpm（pnpm 更快，但 npm 更稳定，你自己选）
• Git（某些功能需要，比如技能安装）

检查你的环境

如果版本低于 22，或者提示 ，说明你需要安装或升级 Node.js。别想着用系统自带的包管理器，版本老得像 90 年代的产物。

安装 Node.js

方式一：使用 nvm（推荐，至少比系统包管理器靠谱）

方式二：官方安装包

访问 Node.js 官网 下载 LTS 版本（≥22）。记得选 LTS，别选 Current，除非你喜欢当小白鼠。

方式三：使用一键脚本（如果你不想看上面的废话）

如果不想手动安装，直接用官方一键安装脚本：

看见没？又绕回来了。所以为什么不一开始就用这个？

安装 OpenClaw-CN

使用 npm：

使用 pnpm：

国内用户加速：

常见坑：

• ❌ 如果报错 ，说明权限不够：

• ❌ 如果提示 Node 版本过低，先升级 Node.js（别问我怎么升，看上面）
• ❌ 如果安装卡住不动，换镜像源（看上面）

验证安装

如果输出版本号（如 ），恭喜你，安装成功！ 如果提示 ，那你可能需要重新读一遍上面的步骤。

---

如果你需要修改源码或参与开发，可以从源码构建。普通人请跳过这一节。

---

运行配置向导

这个命令会：

1. 引导你完成基础配置
2. 选择你的聊天平台（飞书、Telegram 等）
3. 配置 AI 模型（OpenAI、Anthropic、国产大模型等）
4. 安装守护进程（让 OpenClaw 在后台运行）

友情提示： 仔细读每一行提示，别一路回车下去，否则你会得到一个默认配置的 OpenClaw，然后发现啥也干不了，又回来骂教程写得不好。

兼容性： 旧版本 命令仍然可用，作为别名指向 。所以你不用改脚本。

---

启动网关

检查状态

如果看到一堆绿色的状态指示，恭喜你，你成功了！ 如果看到一堆红色的错误，对不起，你还得继续往下看。

查看日志

如果遇到问题，先看日志，别无脑报 bug。90% 的问题都是配置错误或权限问题。

---

配置文件位置

配置文件在 （Linux/macOS）或 （Windows）。

注意： 不是 ，也不是 ，是 。别问我为什么，问开发者去。

最小配置示例

就这几行？ 是的，最小配置就这么简单。别一上来就搞复杂的配置，先跑起来再说。

完整配置示例

重要： API 密钥别泄露！别把 openclaw.json 发到 GitHub 上，别告诉你的前女友，别写在便利贴上贴在显示器上。

---

创建飞书应用

步骤1：访问飞书开放平台

访问 飞书开放平台，登录你的飞书账号。

步骤2：创建应用

选择”创建企业自建应用”，填写应用名称（比如”我的AI助手”，别用”智能助手”这种烂大街的名字），选择应用类型（建议选择”机器人”）。

步骤3：获取应用凭证

进入应用详情页，找到”凭证与基础信息”，记下 和 。

友情提示： App Secret 只显示一次，记得复制保存。别到时候找不到又来问我。

步骤4：配置权限

进入”权限管理”，开启以下权限：

• （接收和发送消息）
• （群组消息）
• （读取用户信息）

别问我为什么需要这些权限，你自己想想 AI 怎么接收消息。

步骤5：启用机器人能力

在”机器人能力”中，启用机器人功能。

步骤6：设置事件订阅

在”事件订阅”中：

1. 填写你的服务器地址（必须是公网可访问的 URL）
2. 启用 事件

重要： 事件订阅地址必须可以通过公网访问，别用 localhost。如果你不知道什么是公网地址，那建议先学习网络基础。

在 OpenClaw 中配置

方式一：通过配置向导

方式二：手动编辑配置文件

编辑 ：

常见坑：

• ❌ 事件订阅地址必须可以通过公网访问，别用 localhost
• ❌ 权限要开启，否则你的机器人啥也收不到
• ❌ 记得在飞书群里添加机器人，否则它是个孤家寡人
• ❌ App ID 和 App Secret 别填反了（别笑，真有人这么干）

重启网关

配置完成后，重启网关使配置生效：

---

---

问题1：一键安装脚本报错

可能原因：

• 没有 curl 命令
• 权限不够
• 网络问题

解决方案：

问题2：Node.js 版本过低

错误提示： 或类似错误

原因： 你没仔细看教程，用了 Node 18 或更低版本

解决方案：

问题3：npm 安装权限错误

错误提示：

原因： 你没有管理员权限

解决方案：

问题4：飞书收不到消息

检查清单：

1. ✅ 飞书应用权限是否开启？
2. ✅ 事件订阅是否配置？
3. ✅ 机器人是否在群里？
4. ✅ 配置文件中的 和 是否正确？
5. ✅ 网关是否正常运行？

排查步骤：

终极解决方案： 重启大法好（先试这个）

问题5：配置修改不生效

原因： 配置文件格式错误，或者忘记重启 OpenClaw

解决方案：

1. 检查 JSON 格式是否正确（用 JSON Linter）
2. 重启网关：

问题6：提示

原因： openclaw-cn 未安装或未在 PATH 中

解决方案：

---

1. 配置多个 AI 模型

2. 配置工作区

工作区在 ，可以自定义：

• — AI 的性格和行为准则（别写太奇怪的东西）
• — 用户信息
• — 长期记忆
• — 自定义命令

3. 安装技能

---

使用 PM2 守护进程

使用 Systemd（Linux）

创建服务文件：

写入内容：

启动服务：

---

API 密钥管理

• ✅ 使用环境变量存储敏感信息
• ✅ 定期更换 API 密钥
• ❌ 不要把密钥提交到 Git 仓库
• ❌ 不要把密钥告诉你的前女友

网络安全

• ✅ 使用 HTTPS（Nginx/Caddy 反向代理）
• ✅ 配置防火墙，只开放必要端口
• ✅ 限制管理接口的访问 IP

访问控制

• ✅ 设置管理员白名单
• ✅ 定期审查访问日志
• ✅ 及时更新到最新版本

---

官方资源

• 官网： clawd.org.cn
• 文档： clawd.org.cn/docs
• GitHub： github.com/jiulingyun/…
• 问题反馈： GitHub Issues

技能市场

• ClawHub：各种现成的技能，拿来即用

OpenClaw-CN 是个强大的工具，安装过程也很简单。如果你按照这个教程一步步来，应该能在 10 分钟内搞定。

推荐安装流程（记不住就收藏）：