# 飞书也可以连 OpenClaw，再也不用翻墙了！🔥
> **草稿** | 2026-02-20
> 状态：待发布
> 作者：Luna 🌿
—
## 为什么写这篇笔记
之前一直用 Telegram 跟 OpenClaw 聊天，但需要翻墙，有时候不稳定。
今天终于把飞书机器人配置好了！🎉
**优势超明显**：
– ✅ 国内直连，不需要 VPN
– ✅ WebSocket 长连接，稳定不掉线
– ✅ 支持富文本、卡片消息
– ✅ 可以直接在飞书群里用
—
## 完整配置方法
### 第一步：创建飞书应用
1. **访问飞书开放平台**
– 打开：https://open.feishu.cn/app
– 登录你的飞书账号
2. **创建企业应用**
– 点击「创建企业自建应用」
– 填写信息：
– 应用名称：你的 AI 助手名字
– 应用描述：简单描述用途
– 应用图标：随意上传一个
3. **获取凭证**（重要！）
– 创建完成后，在「凭证与基础信息」页面
– 复制这两个值：
– **App ID**：格式 `cli_xxxxxx`
– **App Secret**：点击显示后复制
– ⚠️ **App Secret 要保密！**
—
### 第二步：配置权限
1. **进入权限管理**
– 左侧菜单 → 权限管理
2. **批量导入权限**
– 点击「批量导入」
– 粘贴以下 JSON：
“`json
{
“scopes”: {
“tenant”: [
“im:message”,
“im:message:readonly”,
“im:message:send_as_bot”,
“im:message.p2p_msg:readonly”,
“im:message.group_at_msg:readonly”,
“im:chat.members:bot_access”
]
}
}
“`
3. **确认添加**
– 点击「确认」
– 等待权限生效（通常几秒）
—
### 第三步：启用机器人能力
1. **进入应用能力**
– 左侧菜单 → 应用能力 → 机器人
2. **启用机器人**
– 开启「启用机器人」开关
– 设置机器人名称和描述
—
### 第四步：配置事件订阅（最关键！）
⚠️ **这一步最容易出错**
1. **先启动 OpenClaw Gateway**
“`bash
openclaw gateway start
“`
2. **配置事件订阅**
– 左侧菜单 → 事件与回调 → 事件订阅
– 订阅方式：选择「**使用长连接接收事件**」
– 添加事件：`im.message.receive_v1`
– 点击「保存」
3. **确认状态**
– 保存后应该显示「已启用」或「正常」
– 如果失败，说明 Gateway 没启动或配置错误
—
### 第五步：配置 OpenClaw
1. **编辑配置文件**
“`bash
nano ~/.openclaw/openclaw.json
“`
2. **添加飞书配置**
“`json
“channels”: {
“feishu”: {
“enabled”: true,
“name”: “你的AI助手名称”,
“dmPolicy”: “pairing”,
“groupPolicy”: “open”,
“connectionMode”: “websocket”,
“accounts”: {
“main”: {
“appId”: “cli_你的AppID”,
“appSecret”: “你的AppSecret”,
“botName”: “你的AI助手名称”
}
}
}
}
“`
3. **关键配置说明**
– `dmPolicy: “pairing”` – 需要配对码（推荐）
– `connectionMode: “websocket”` – 使用长连接
– ⚠️ **不要设置代理**（飞书国内直连）
4. **重启 Gateway**
“`bash
openclaw gateway restart
“`
—
### 第六步：发布应用
1. **创建版本**
– 左侧菜单 → 版本管理与发布
– 点击「创建版本」
– 填写版本号（如 1.0.0）
– 填写版本说明
2. **申请发布**
– 点击「申请发布」
– 等待审核（企业应用通常自动通过）
3. **启用应用**
– 审核通过后
– 进入「应用可用性」
– 添加自己为成员
—
### 第七步：测试
1. **在飞书搜索你的机器人**
– 打开飞书
– 搜索你的应用名称
2. **发消息测试**
– 发送：”你好”
– 应该收到配对码
3. **批准配对**
“`bash
openclaw pairing approve feishu
“`
4. **再次测试**
– 发送：”今天天气怎么样”
– 应该收到正常回复
—
## 常见问题
### Q1: 收不到消息？
**检查清单**：
– [ ] Gateway 是否运行：`openclaw gateway status`
– [ ] 事件订阅是否配置：飞书开放平台 → 事件订阅
– [ ] 事件是否添加：`im.message.receive_v1`
– [ ] 应用是否发布：版本管理 → 申请发布
### Q2: WebSocket 连接失败？
**解决方案**：
“`bash
# 完全重启
openclaw gateway stop
sleep 5
openclaw gateway start
# 查看日志
openclaw logs –follow
“`
### Q3: 代理配置问题？
**关键发现**：
– ❌ Mini 设置了代理：`http://127.0.0.1:1087` → 失败
– ✅ Air 没有设置代理 → 成功
**结论**：飞书在国内应该直连，不需要代理！
如果你的网络环境需要代理：
1. 移除 feishu 配置里的 proxy 字段
2. 或者在 NO_PROXY 添加：`*.feishu.cn,*.larksuite.com`
—
## 对比：飞书 vs Telegram
| 项目 | 飞书 | Telegram |
|——|——|———-|
| **网络** | 国内直连 | 需要翻墙 |
| **稳定性** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| **富文本** | ✅ 支持卡片、按钮 | ❌ 简单格式 |
| **文件** | ✅ 大文件、云存储 | ⚠️ 有限制 |
| **隐私** | 企业级 | ⭐⭐⭐⭐⭐ |
| **国际化** | 主要国内 | ⭐⭐⭐⭐⭐ |
**我的选择**：
– 🇨🇳 国内日常用飞书（稳定、功能全）
– 🌍 国际旅行用 Telegram（隐私、通用）
—
## 意外收获
配置飞书的同时，我还顺便搞定了：
### 1. 多设备协作系统
– MacBook Air + Mac Mini 通过 iCloud 协作
– 收件夹机制，自动检查消息
– 完整的配置文档，方便复用
### 2. RAG 项目升级
– 从临时目录迁移到正式项目
– 两台设备共同维护
– 通过 iCloud 同步，随时协作
### 3. Telegram 群组通信
– 之前只能私聊，现在支持群组了
– 配置：`groupPolicy: “open”`
– 把机器人拉进群，@它就能用
—
## 技术要点总结
### 必须配置的
1. ✅ 创建飞书应用
2. ✅ 配置权限（批量导入 JSON）
3. ✅ 启用机器人能力
4. ✅ 配置事件订阅（长连接 + 事件）
5. ✅ OpenClaw 配置（无代理）
6. ✅ 发布应用
### 容易出错的
1. ⚠️ 事件订阅未保存或未生效
2. ⚠️ 设置了代理（应该直连）
3. ⚠️ 应用未发布
4. ⚠️ Gateway 未启动
### 调试技巧
1. 🔍 查看日志：`openclaw logs –follow`
2. 🔍 对比配置：成功的 vs 失败的
3. 🔍 逐步验证：一次改一个配置
—
## 最后
现在我有三个渠道可以找到 AI 助手：
– 📱 Telegram（国际通用）
– 💼 飞书（国内稳定）
– 💬 iMessage（本地群组）
随时随地都能用，超方便！
**核心收获**：
– 技术问题有时候就是卡在一个小细节
– 对比成功和失败的配置，找出差异点
– 逐步验证，不要一次性改太多
—
## 标签
#AI助手 #飞书机器人 #生产力工具 #Mac #效率提升 #科技 #OpenClaw
—
## 发布标识
🤖 由我的 AI 助手 Luna 🌿 整理发布
—
## 配图建议
1. 飞书机器人对话截图
2. 配置流程图（可选）
3. Mac 设备照片（可选）
4. AI 助手头像
—
**创建时间**: 2026-02-20
**作者**: Luna 🌿
**状态**: 草稿，待用户确认