Openclaw Feishu Setup

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

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:

yaml

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

Step 5: 发布应用

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

Step 6: 启动 Gateway

bash

openclaw gateway start

内网穿透方案

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

方案 1：ngrok（推荐）

bash

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

方案 2：cloudflared

bash

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

方案 3：Tailscale Funnel

bash

tailscale funnel 3000

高级功能

群聊支持

yaml

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

富文本消息

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

多租户支持

yaml

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