导读:为什么要把 OpenClaw 对接到飞书?
OpenClaw 是一个强大的 AI 助理框架,可以帮你自动发布文章、管理网站、处理日常任务。对接到飞书后,你可以:
- 随时随地通过飞书控制 OpenClaw
- 实时接收发布通知、任务完成提醒
- 在飞书群里查看日报、统计数据
- 用手机就能管理你的 AI 助理
今天这篇教程,从零开始,手把手教你完成对接。
一、准备工作
1. 环境要求
- 已安装 OpenClaw(参考之前的安装教程)
- 有飞书账号(个人版/企业版都可以)
- 能访问飞书开放平台
2. 需要的时间
- 基础配置:30 分钟
- 事件订阅:1 小时(需要公网地址)
- 测试调试:30 分钟
二、创建飞书应用
步骤 1:访问开放平台
- 打开 https://open.feishu.cn/app
- 用飞书扫码登录
- 点击”创建应用”
步骤 2:填写应用信息
- 应用名称:OpenClaw 助手
- 应用图标:随便选一个
- 应用描述:OpenClaw AI 助理飞书集成
步骤 3:获取应用凭证
创建完成后,进入应用管理页面,复制以下信息:
- App ID:cli_xxxxxxxxxxxxx
- App Secret:xxxxxxxxxxxxxxxxxxxxx
⚠️ 注意:App Secret 只显示一次,立即复制保存!
三、配置应用权限
步骤 1:添加权限
- 点击左侧”权限管理”
- 点击”申请权限”
- 搜索并添加以下权限:
步骤 2:必需权限列表
im:message - 发送消息
im:message:send_as_bot - 以机器人身份发送
im:chat - 访问群聊信息
im:resource - 访问资源文件
步骤 3:提交申请
点击”提交申请”,大部分权限自动审批,立即生效。
四、配置事件订阅
方案 A:有公网服务器(推荐)
- 点击”事件订阅”
- 开启”启用事件订阅”
- 订阅地址填写:
https://your-domain.com/feishu/webhook - 复制 Verification Token
- 订阅事件:im.message.receive_v1
- 点击”保存”
方案 B:用内网穿透(临时测试)
- 安装 ngrok:
npm install -g ngrok - 运行:
ngrok http 5000 - 获得公网地址:
https://abc123.ngrok.io - 填写到订阅地址:
https://abc123.ngrok.io/feishu/webhook
五、添加机器人到群
步骤 1:创建机器人
- 点击左侧”机器人”
- 点击”创建机器人”
- 填写名称:OpenClaw 助手
- 点击”完成”
- 复制 Bot ID:ou_xxxxxxxxxxxxx
步骤 2:添加到群
- 打开飞书,找一个群(或新建一个)
- 群设置 → 机器人 → 添加机器人
- 选择”OpenClaw 助手”
- 点击添加
六、配置 OpenClaw 脚本
步骤 1:创建配置文件
在 OpenClaw 脚本目录创建 feishu-app-config.json:
{
"app_id": "cli_xxxxxxxxxxxxx",
"app_secret": "xxxxxxxxxxxxxxxxxxxxx",
"verification_token": "xxxxxxxxxxxxxxxxxxxxx",
"bot_id": "ou_xxxxxxxxxxxxx",
"webhook_url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx"
}
步骤 2:安装依赖
pip install flask requests
步骤 3:运行监听服务
py C:\Users\21221\.openclaw\workspace\scripts\feishu-event-server.py
七、测试对接
测试 1:发送消息
在群里发:”发布文章:AI 绘图教程”
预期结果:机器人回复”正在发布…”,然后发布成功通知
测试 2:接收通知
手动发布一篇文章
预期结果:飞书收到发布通知
测试 3:查看日报
等到 19:50
预期结果:飞书收到日报统计
八、常见问题解答
问题 1:事件订阅验证失败?
建议:检查 Verification Token 是否复制正确,确认订阅地址能访问。
问题 2:机器人收不到消息?
建议:检查是否添加到群里,权限是否开启。
问题 3:通知发不出去?
建议:检查 Webhook 地址是否正确,App Secret 是否有效。
问题 4:内网穿透地址变了?
建议:ngrok 每次重启地址会变,重新配置订阅地址,或用固定域名。
九、进阶配置
1. 自定义指令
可以配置更多飞书指令:
/publish AI 绘图教程 - 发布文章
/status - 查看系统状态
/stats today - 查看今日统计
/help - 查看帮助
2. 多群支持
一个机器人可以添加到多个群,每个群都能接收通知。
3. 消息格式美化
用飞书卡片消息,比纯文本更美观:
{
"msg_type": "interactive",
"card": {
"header": {"title": "📝 新文章发布"},
"elements": [...]
}
}
十、安全建议
- App Secret 妥善保管,不要提交到代码仓库
- 生产环境用 HTTPS,不要用 HTTP
- 配置 IP 白名单,限制访问来源
- 定期更新 App Secret
- 监控异常访问日志
总结
OpenClaw 对接飞书,可以让你随时随地管理 AI 助理。按照这个教程,一步步来,1-2 小时就能完成。
对接完成后,体验会提升一个档次:手机就能发布文章,实时接收通知,群里查看数据。
有问题欢迎评论区交流,看到都会回复!
分类:AI 教学 | 关键词:OpenClaw 对接飞书 | 阅读时间:约 20 分钟
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...