AI 机器人 OpenClaw 怎么对接到飞书?完整教程来了

导读:为什么要把 OpenClaw 对接到飞书?

OpenClaw 是一个强大的 AI 助理框架,可以帮你自动发布文章、管理网站、处理日常任务。对接到飞书后,你可以:

  • 随时随地通过飞书控制 OpenClaw
  • 实时接收发布通知、任务完成提醒
  • 在飞书群里查看日报、统计数据
  • 用手机就能管理你的 AI 助理

今天这篇教程,从零开始,手把手教你完成对接。

一、准备工作

1. 环境要求

  • 已安装 OpenClaw(参考之前的安装教程)
  • 有飞书账号(个人版/企业版都可以)
  • 能访问飞书开放平台

2. 需要的时间

  • 基础配置:30 分钟
  • 事件订阅:1 小时(需要公网地址)
  • 测试调试:30 分钟

二、创建飞书应用

步骤 1:访问开放平台

  1. 打开 https://open.feishu.cn/app
  2. 用飞书扫码登录
  3. 点击”创建应用”

步骤 2:填写应用信息

  • 应用名称:OpenClaw 助手
  • 应用图标:随便选一个
  • 应用描述:OpenClaw AI 助理飞书集成

步骤 3:获取应用凭证

创建完成后,进入应用管理页面,复制以下信息:

  • App ID:cli_xxxxxxxxxxxxx
  • App Secret:xxxxxxxxxxxxxxxxxxxxx

⚠️ 注意:App Secret 只显示一次,立即复制保存!

三、配置应用权限

步骤 1:添加权限

  1. 点击左侧”权限管理”
  2. 点击”申请权限”
  3. 搜索并添加以下权限:

步骤 2:必需权限列表

im:message          - 发送消息
im:message:send_as_bot - 以机器人身份发送
im:chat             - 访问群聊信息
im:resource         - 访问资源文件

步骤 3:提交申请

点击”提交申请”,大部分权限自动审批,立即生效。

四、配置事件订阅

方案 A:有公网服务器(推荐)

  1. 点击”事件订阅”
  2. 开启”启用事件订阅”
  3. 订阅地址填写:https://your-domain.com/feishu/webhook
  4. 复制 Verification Token
  5. 订阅事件:im.message.receive_v1
  6. 点击”保存”

方案 B:用内网穿透(临时测试)

  1. 安装 ngrok:npm install -g ngrok
  2. 运行:ngrok http 5000
  3. 获得公网地址:https://abc123.ngrok.io
  4. 填写到订阅地址:https://abc123.ngrok.io/feishu/webhook

五、添加机器人到群

步骤 1:创建机器人

  1. 点击左侧”机器人”
  2. 点击”创建机器人”
  3. 填写名称:OpenClaw 助手
  4. 点击”完成”
  5. 复制 Bot ID:ou_xxxxxxxxxxxxx

步骤 2:添加到群

  1. 打开飞书,找一个群(或新建一个)
  2. 群设置 → 机器人 → 添加机器人
  3. 选择”OpenClaw 助手”
  4. 点击添加

六、配置 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 分钟

© 版权声明

相关文章

暂无评论

none
暂无评论...