OpenClaw 飞书 Setup
15 分钟配置飞书机器人作为 OpenClaw 消息渠道。
为什么选飞书？
- 企业首选：字节跳动出品，国内企业广泛使用
- 功能强大：消息、文档、日历、会议一体化
- 开放平台：丰富的 API 和机器人能力
- 免费版够用：小团队免费使用
快速配置
Step 1: 创建飞书应用
- 访问 https://open.feishu.cn/app
- 点击 "创建企业自建应用"
- 设置名称（如 "AI 助手"）
- 保存 App ID 和 App Secret
Step 2: 配置权限
在应用管理 > 权限管理中，开启：
im:message- 获取与发送单聊、群组消息im:message:send_as_bot- 以应用身份发消息
Step 3: 配置事件订阅
- 在 "事件订阅" 页面启用
- 配置 OpenClaw Gateway 的公网地址（需要内网穿透或云服务器）
- 订阅事件：
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: 发布应用
- 在飞书开放平台提交审核
- 审核通过后，添加到企业可用范围
- 在飞书中搜索你的应用，开始对话
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 模型：按使用量计费
安全建议
- 不要公开 App Secret
- 启用消息加密（encryptKey）
- 定期轮换密钥
- 限制应用可用范围
需要帮助？
- 微信：yanghu_ai
- Telegram: @yanghu_openclaw
- 飞书配置服务：¥99（远程协助）
Version: 1.0.0 Created: 2026-03-21