Skip to main content
← 返回实践列表
作者 Wing工程案例

OpenClaw + Telegram + 飞书对接方案研究报告

调研 OpenClaw 原生飞书集成方案，梳理从 Webhook Bridge 迁移到 WebSocket 长连接的完整路径与配置步骤

工具: OpenClaw渠道: Telegram + 飞书

调研日期：2026-03-13

目标：实现 OpenClaw 同时对接 Telegram 和飞书（Lark）

一、当前环境分析

1.1 OpenClaw 现有配置

已配置的渠道：

text
  渠道     │ 状态            │ 说明                                           
  ─────────┼─────────────────┼────────────────────────────────────────────────
  Telegram │ ✅ 正常运行      │ 3 个 bot（nexus、xiaoman、polymarket），DM 开放
  飞书     │ ⚠️ Webhook 模式 │ 非原生 WebSocket，通过 bridge 中转

当前飞书配置（~/.openclaw/openclaw.json）：

text
{
  "feishu": {
    "domain": "lark",
    "streaming": false,
    "blockStreaming": false,
    "textChunkLimit": 8000
  }
}

1.2 当前飞书对接架构

现有方案：Webhook Bridge

text
飞书 → Cloudflare Tunnel → bridge.py (localhost:19800) → OpenClaw Gateway (localhost:18789)

bridge.py 功能：

  • 接收飞书事件（卡片消息、私聊、群聊）
  • 转发给 OpenClaw Gateway
  • 群聊智能回复（strict 模式：必须 @ 才回复）
  • 消息去重和持久化

问题：

  • 非原生集成，依赖额外 bridge 服务
  • 需要 Cloudflare Tunnel 暴露公网
  • 功能受限（无法使用 OpenClaw 原生飞书功能）

二、OpenClaw 原生飞书集成

2.1 官方支持情况

OpenClaw 官方原生支持飞书，通过 WebSocket 长连接接收事件，无需公网暴露。

支持的功能：

  • 私聊消息
  • 群聊消息（支持 @ 机器人）
  • 卡片消息（Interactive Card）
  • 发送消息（send_as_bot）
  • 媒体文件处理

2.2 配置步骤

步骤 1：创建飞书应用

  1. 访问 飞书开放平台
  2. 创建企业应用
  3. 获取 App ID 和 App Secret

步骤 2：配置权限

在飞书应用权限中批量导入：

text
{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message:readonly",
      "im:chat.members:bot_access",
      "im:resource",
      "aily:file:read",
      "aily:file:write"
    ]
  }
}

步骤 3：启用机器人能力

在 应用能力 → 机器人 中启用并设置机器人名称。

步骤 4：配置事件订阅

  1. 选择 使用长连接接收事件（WebSocket）
  2. 添加事件：im.message.receive_v1

步骤 5：发布应用

在 版本管理与发布 中创建版本并提交审核。

2.3 OpenClaw 配置

方式一：CLI 配置（推荐）

powershell
openclaw channels add
# 选择 Feishu，输入 App ID 和 App Secret

方式二：配置文件

text
{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "[已脱敏]",
          "appSecret": "xxx",
          "botName": "内部助手"
        }
      }
    }
  }
}

飞书国际版（Lark）配置：

text
{
  "channels": {
    "feishu": {
      "domain": "lark"
    }
  }
}

三、Telegram 对接现状

3.1 当前配置

已有 3 个 Telegram bot：

text
  Bot        │ Token                         │ DM 策略 │ 群聊策略 
  ───────────┼───────────────────────────────┼─────────┼──────────
  nexus      │ 8605513784:AAHpV9JvZECkHc0... │ pairing │ allowlist
  xiaoman    │ 8679985454:AAFMmTZSHeBL_...   │ open    │ open     
  polymarket │ 8617997098:AAFtetMdfopk_...   │ open    │ allowlist

配置特点：

  • 均使用代理：http://127.0.0.1:7897
  • DM 策略：nexus 需配对，其他开放
  • 群聊：xiaoman 完全开放，其他需白名单

3.2 优化建议

  1. 统一代理：可考虑移除代理（如果网络可达）
  2. 安全策略：生产环境建议使用 pairing 模式
  3. Streaming：可开启流式响应提升体验

四、完整对接方案

4.1 目标架构

text
┌─────────────────────────────────────────────────────────────┐
│                        用户                                  │
├──────────────┬──────────────────────┬──────────────────────┤
│   Telegram   │       飞书           │                     │
│   (原生)     │       (原生)         │                     │
└──────┬───────┴──────────┬──────────┴──────────┬───────────┘
       │                   │                      │
       ▼                   ▼                      ▼
┌──────────────────────────────────────────────────────────────┐
│                    OpenClaw Gateway                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │ Telegram    │  │   Feishu    │  │     其他渠道         │  │
│  │ (WebSocket)│  │ (WebSocket)│  │   (WhatsApp等)      │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└──────────────────────────────────────────────────────────────┘

4.2 实施步骤

第一步：切换到原生飞书集成

  1. 停止当前 bridge 服务
  2. 配置 OpenClaw 飞书原生支持
  3. 重启 Gateway
  4. 验证飞书消息接收
powershell
# 配置飞书
openclaw channels add
# 选择 Feishu，输入 App ID 和 App Secret
 
# 重启 Gateway
openclaw gateway restart
 
# 查看状态
openclaw gateway status

第二步：优化 Telegram 配置

根据需要调整 DM 和群聊策略：

text
{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "streaming": "partial"
    }
  }
}

第三步：配置群聊回复规则

飞书群聊支持两种模式：

  • strict：必须 @ 机器人才回复
  • smart：智能判断，无 @ 也回复有价值的消息
text
{
  "channels": {
    "feishu": {
      "accounts": {
        "main": {
          "groupPolicy": {
            "groups": {
              "[已脱敏]": {
                "requireMention": true
              }
            }
          }
        }
      }
    }
  }
}

五、飞书 Bot 高级功能

5.1 当前飞书 Bot 能力

基于现有配置，内部成员拥有的飞书 Bot：

text
  能力         │ 状态 │ 说明            
  ─────────────┼──────┼─────────────────
  接收私聊消息 │ ✅    │ DM 策略：开放   
  接收群聊消息 │ ✅    │ 需 @ 或在群里   
  发送消息     │ ✅    │ send_as_bot     
  发送卡片消息 │ ✅    │ Interactive Card
  处理媒体     │ ✅    │ 图片、文件等

5.2 飞书 API 能力（需额外配置）

text
  能力         │ 权限名称                          │ 用途        
  ─────────────┼───────────────────────────────────┼─────────────
  读取用户信息 │ contact:user.employee_id:readonly │ 获取用户身份
  上传文件     │ im:resource                       │ 文件上传下载
  创建群聊     │ im:chat:create                    │ 自动建群    
  @人          │ at:user                           │ 群聊@功能

5.3 消息类型支持

text
  类型   │ 支持 │ 说明            
  ───────┼──────┼─────────────────
  文本   │ ✅    │ 基础文本消息    
  富文本 │ ✅    │ post 消息       
  卡片   │ ✅    │ Interactive Card
  图片   │ ✅    │ image 消息      
  文件   │ ✅    │ file 消息       
  语音   │ ✅    │ audio 消息

六、问题排查

6.1 常见问题

text
  问题           │ 可能原因         │ 解决方案                
  ───────────────┼──────────────────┼─────────────────────────
  飞书消息收不到 │ Gateway 未运行   │ `openclaw gateway start`
  事件订阅失败   │ WebSocket 未连接 │ 检查 gateway 状态       
  权限不足       │ 权限未配置       │ 在飞书开放平台添加权限  
  群聊无法回复   │ 未发布应用       │ 提交审核并发布

6.2 调试命令

powershell
# 查看 Gateway 状态
openclaw gateway status
 
# 查看飞书通道日志
openclaw logs --follow | grep -i feishu
 
# 测试发送消息
openclaw message send --to <user_id> --message "测试"
 
# 飞书通道诊断
openclaw doctor

七、结论与建议

7.1 当前评估

text
  维度       │ Telegram       │ 飞书                    
  ───────────┼────────────────┼─────────────────────────
  集成方式   │ 原生 WebSocket │ Webhook Bridge（需改造）
  稳定性     │ 高             │ 中（依赖 bridge）       
  功能完整性 │ 完整           │ 部分（bridge 限制）     
  维护成本   │ 低             │ 高（额外服务）

7.2 建议方案

推荐：切换到原生飞书集成

优点：

  • 无需公网暴露（WebSocket 长连接）
  • 功能完整（原生支持所有飞书能力）
  • 维护简单（OpenClaw 内置）
  • 稳定性高

实施难度：

  • 中等（需要重新配置飞书应用）
  • 需要停机迁移（约 5 分钟）

7.3 实施优先级

  1. 内部排序：切换飞书到原生集成
  2. 内部排序：优化 Telegram 配置
  3. 内部排序：添加飞书高级功能（文件上传、用户识别等）

附录

A. 飞书应用权限清单

text
im:message                    # 接收消息
im:message:send_as_bot        # 发送消息
im:message:readonly           # 读取消息
im:chat.members:bot_access    # 获取群成员
im:resource                  # 资源文件
aily:file:read              # 读取文件
aily:file:write             # 写入文件

B. 相关链接

  • 飞书开放平台：[内部链接已脱敏]
  • OpenClaw 飞书文档：[内部链接已脱敏]
  • 飞书 Bot 开发指南：[内部链接已脱敏]

C. 当前配置参考

text
飞书 App ID: [已脱敏]

报告撰写：内部助手 🌾

最后更新：2026-03-13 18:55 GMT+8

// 相关实践
2026-06-01知识库同步

AI产品经理平台

这是一个把“产品想法 → 需求澄清 → 市场/用户/竞品/趋势分析 → 产品运营动作”串成 AI 工作流的平台方向。方向有需求，但容易泛化成“AI 产品经理套壳”，需要先收敛到创业者/内部创新团队的早期产品定义场景。

飞书知识库自动同步
2026-05-24知识库同步

AI卡片式工作台

AI 卡片式工作台 / AI Notion 的核心设想是：用“AI 输入框 + 可编程卡片 + AI 生成 HTML 模板 + 定时或 Hook 数据更新”构建通用型信息处理软件。用户可以通过对话创建股票、资讯、会议纪要、团队进展等卡片，卡

飞书知识库自动同步
2026-05-22知识库同步

AI生活助手

AI生活助手不是一个可以直接立项的“泛助手”项目，而是一个需要从 Lark 话题中继续收集真实生活场景、再筛选垂直切口的早期机会。

飞书知识库自动同步

分享

一起来搞事情

关注我们的社交媒体，加入社群获取最新动态

微信公众号小红书
微信二维码

扫码加入微信群

hello@tranfu.com4008 600 693