Chuluu.Pro

飞书也可以连 OpenClaw，再也不用翻墙了！🔥

飞书也可以连 OpenClaw，再也不用翻墙了！🔥

> 草稿 | 2026-02-20
> 状态：待发布
> 作者：Luna 🌿

为什么写这篇笔记

之前一直用 Telegram 跟 OpenClaw 聊天，但需要翻墙，有时候不稳定。

今天终于把飞书机器人配置好了！🎉

优势超明显：

  • ✅ 国内直连，不需要 VPN
  • ✅ WebSocket 长连接，稳定不掉线
  • ✅ 支持富文本、卡片消息
  • ✅ 可以直接在飞书群里用

完整配置方法

第一步：创建飞书应用

  1. 访问飞书开放平台

  2. 创建企业应用

    • 点击「创建企业自建应用」
    • 填写信息：
      • 应用名称：你的 AI 助手名字
      • 应用描述：简单描述用途
      • 应用图标：随意上传一个

  3. 获取凭证（重要！）

    • 创建完成后，在「凭证与基础信息」页面
    • 复制这两个值：
      • App ID：格式 cli_xxxxxx
      • App Secret：点击显示后复制
    • ⚠️ App Secret 要保密！

第二步：配置权限

  1. 进入权限管理

    • 左侧菜单 → 权限管理

  2. 批量导入权限

    • 点击「批量导入」
    • 粘贴以下 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"
    ]
  }
}
  1. 确认添加
    • 点击「确认」
    • 等待权限生效（通常几秒）

第三步：启用机器人能力

  1. 进入应用能力

    • 左侧菜单 → 应用能力 → 机器人

  2. 启用机器人

    • 开启「启用机器人」开关
    • 设置机器人名称和描述

第四步：配置事件订阅（最关键！）

⚠️ 这一步最容易出错

  1. 先启动 OpenClaw Gateway

    openclaw gateway start

  2. 配置事件订阅

    • 左侧菜单 → 事件与回调 → 事件订阅
    • 订阅方式：选择「使用长连接接收事件」
    • 添加事件：im.message.receive_v1
    • 点击「保存」

  3. 确认状态

    • 保存后应该显示「已启用」或「正常」
    • 如果失败，说明 Gateway 没启动或配置错误

第五步：配置 OpenClaw

  1. 编辑配置文件

    nano ~/.openclaw/openclaw.json

  2. 添加飞书配置

    "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

    openclaw gateway restart

第六步：发布应用

  1. 创建版本

    • 左侧菜单 → 版本管理与发布
    • 点击「创建版本」
    • 填写版本号（如 1.0.0）
    • 填写版本说明

  2. 申请发布

    • 点击「申请发布」
    • 等待审核（企业应用通常自动通过）

  3. 启用应用

    • 审核通过后
    • 进入「应用可用性」
    • 添加自己为成员

第七步：测试

  1. 在飞书搜索你的机器人

    • 打开飞书
    • 搜索你的应用名称

  2. 发消息测试

    • 发送："你好"
    • 应该收到配对码

  3. 批准配对

    openclaw pairing approve feishu

  4. 再次测试

    • 发送："今天天气怎么样"
    • 应该收到正常回复

常见问题

Q1: 收不到消息？

检查清单：

  • Gateway 是否运行：openclaw gateway status
  • 事件订阅是否配置：飞书开放平台 → 事件订阅
  • 事件是否添加：im.message.receive_v1
  • 应用是否发布：版本管理 → 申请发布

Q2: WebSocket 连接失败？

解决方案：

# 完全重启
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 🌿
状态: 草稿，待用户确认

上一篇
下一篇