ClawHub

Openclaw Feishu Setup

Communication
#消息#飞书

Configure Feishu as an OpenClaw messaging channel in 15 minutes, enabling single and group chat with event subscription and secure API integration.

Install

openclaw skills install @yang1002378395-cmyk/openclaw-feishu-setup

OpenClaw 飞书 Setup

15 分钟配置飞书机器人作为 OpenClaw 消息渠道。

为什么选飞书？

  • 企业首选：字节跳动出品，国内企业广泛使用
  • 功能强大：消息、文档、日历、会议一体化
  • 开放平台：丰富的 API 和机器人能力
  • 免费版够用：小团队免费使用

快速配置

Step 1: 创建飞书应用

  1. 访问 https://open.feishu.cn/app
  2. 点击 "创建企业自建应用"
  3. 设置名称（如 "AI 助手"）
  4. 保存 App ID 和 App Secret

Step 2: 配置权限

在应用管理 > 权限管理中，开启：

  • im:message - 获取与发送单聊、群组消息
  • im:message:send_as_bot - 以应用身份发消息

Step 3: 配置事件订阅

  1. 在 "事件订阅" 页面启用
  2. 配置 OpenClaw Gateway 的公网地址（需要内网穿透或云服务器）
  3. 订阅事件：
    • im.message.receive_v1 - 接收消息

Step 4: 配置 OpenClaw

编辑 ~/.openclaw/config.yaml:

plugins:
  entries:
    - plugin: openclaw-feishu
      config:
        appId: "cli_xxxxxxxxxx"
        appSecret: "xxxxxxxxxxxxxx"
        encryptKey: "xxxx"  # 可选，用于消息加密
        verificationToken: "xxxx"  # 可选，用于验证

Step 5: 发布应用

  1. 在飞书开放平台提交审核
  2. 审核通过后，添加到企业可用范围
  3. 在飞书中搜索你的应用，开始对话

Step 6: 启动 Gateway

openclaw gateway start

内网穿透方案

如果没有公网 IP，可以用：

方案 1：ngrok（推荐）

ngrok http 3000
# 将生成的 https://xxx.ngrok.io 配置到事件订阅

方案 2：cloudflared

cloudflared tunnel --url http://localhost:3000

方案 3：Tailscale Funnel

tailscale funnel 3000

高级功能

群聊支持

plugins:
  entries:
    - plugin: openclaw-feishu
      config:
        appId: "xxx"
        appSecret: "xxx"
        enableGroupChat: true
        groupTriggerPrefix: "@AI助手"  # 群聊触发前缀

富文本消息

OpenClaw 自动将 Markdown 转换为飞书富文本卡片。

多租户支持

tenants:
  - appId: "cli_xxx1"
    appSecret: "xxx1"
  - appId: "cli_xxx2"
    appSecret: "xxx2"

常见问题

Q: 提示 "app not found"

A: 检查 App ID 是否正确，应用是否已发布

Q: 收不到消息

A: 检查事件订阅是否配置正确，Gateway 是否运行

Q: 提示 "permission denied"

A: 确保已开启 im:message 相关权限

Q: 如何在群聊中使用？

A: 配置 enableGroupChat: true，并设置触发前缀

成本

  • 飞书开放平台：完全免费
  • OpenClaw Gateway：本地运行，无费用
  • AI 模型：按使用量计费

安全建议

  1. 不要公开 App Secret
  2. 启用消息加密（encryptKey）
  3. 定期轮换密钥
  4. 限制应用可用范围

需要帮助？

  • 微信：yanghu_ai
  • Telegram: @yanghu_openclaw
  • 飞书配置服务：¥99（远程协助）

Version: 1.0.0 Created: 2026-03-21

More in Communication