OpenClaw 5.7 升级实录:从飞书 Bot 全面瘫痪到完美解决
周六下午三点,我点了个升级按钮,心想:”就更新一下,喝杯咖啡的功夫能有什么事?”
结果——飞书 Bot 直接罢工了!
那一刻我真的有点崩溃。明明上周还好好的啊,怎么一升级就全废了?
冷静下来想想,其实问题出在我自己——我对升级这件事,太天真了。
🌀 前两个小时:完全懵逼
升级后的前两小时,我整个人都是懵的。
feishu_im_user_search_messages
# 返回:awaiting_app_authorization: true, missing_scopes: [“search:message”]
# 返回:awaiting_app_authorization: true, missing_scopes: [“search:message”]
调用 feishu_oauth_batch_auth 后显示”已发送”,但飞书里完全看不到卡片。
连最简单的 feishu_get_user 都偶尔抽风。
真相是:5.7 版本对权限管理做了大调整,原来的授权全部失效。
说白了就是:你之前的授权凭证作废了,得重新走一遍流程。
💡 第三个小时:找到突破口
通过看官方文档和 GitHub Issues,我终于明白问题了。
解决方案很简单:批量授权。
feishu_oauth_batch_auth
执行后会弹出一个授权卡片,里面有51 个权限需要你确认。
⚠️ 这点很重要:必须全部勾选,不能跳过!
授权完成后,验证一下:
feishu_get_user
# 返回成功,说明没问题了
# 返回成功,说明没问题了
🕳️ 第四到六个小时:继续踩坑
你以为授权完就万事大吉了?Too young too simple.
现象: 调用搜索功能时报错,缺少
search:message 权限原因: 这个属于敏感操作,需要单独授权
解决: 在批量授权时确保勾选这些权限
search:message – 搜索消息
im:message – 发送/接收消息
bitable:read/write – 多维表格读写
calendar:read/write – 日程读写
im:message – 发送/接收消息
bitable:read/write – 多维表格读写
calendar:read/write – 日程读写
现象: 命令执行后显示”已发送”,但飞书里啥都没有
原因: 机器人没添加 or 应用未审批
解决: 检查机器人是否添加 + 应用审批状态
现象: 提示当前用户没有权限
原因: 只有管理员才能发起批量授权
解决: 找管理员帮忙 or 联系 IT 部门申请
⚠️ 这个坑真的很容易忽略!很多人卡在这里好几个小时。
现象: 授权完了,发消息还是收不到,报错 “not allowed from this channel”
原因: 5.7 版本新增 allowFrom 配置项,限制 Bot 可在哪些会话使用
解决: 检查配置文件 → 添加配置 → 重启服务
# config.yaml
feishu:
app_id: “your_app_id”
app_secret: “***”
allowFrom:
– chat_id: “oc_xxx” # 群聊 ID
– open_id: “ou_xxx” # 私聊用户 ID
– type: “all” # 或者允许所有会话
feishu:
app_id: “your_app_id”
app_secret: “***”
allowFrom:
– chat_id: “oc_xxx” # 群聊 ID
– open_id: “ou_xxx” # 私聊用户 ID
– type: “all” # 或者允许所有会话
📋 升级检查清单
备份配置文件:
cp config.yaml config.yaml.bak截图保存授权卡片
通知团队成员升级计划
执行
feishu_oauth_batch_auth在飞书中点击授权卡片完成 51 个权限授权
检查并配置 allowFrom(新增!)
验证基础功能是否正常
测试各项飞书功能
🔍 常见问题速查表
| 问题 | 解决方法 |
|---|---|
| 飞书 Bot 不工作 | 重新发送批量授权卡片 |
| 搜索消息报错 | 检查 search:message 权限 |
| 授权卡片收不到 | 确认机器人已添加到会话 |
| 权限不足 | 联系管理员审批 |
| 发消息收不到 | 检查 allowFrom 配置 |
🎁 获取完整资料包
二维码
关注公众号「80 后 AI 笔记」
回复关键词 OpenClaw5.7
包含:配置教程 + Excel 清单 + 解决方案汇总
作者:80 后老炮
发布时间:2026-05-16
标签:#OpenClaw #飞书Bot #避坑指南 #AI 工具
夜雨聆风