摘要:本文详细记录了在 OpenClaw 中配置飞书(Feishu)定时任务的完整过程,包括常见错误、排查方法和正确配置方式。如果你也遇到”定时任务不执行”、”消息发不出去”的问题,这篇文章能帮你快速解决。
在使用 OpenClaw 配置飞书群聊定时任务时,遇到了以下问题:
- 定时任务创建了,但到时间不执行
- 任务显示”已执行”,但群里没收到消息
- 各种报错信息看不懂,不知道如何排查
经过一下午的调试和日志分析,终于找到了所有坑点。本文将完整记录整个排查过程和解决方案。
- OpenClaw 版本:2026.3.8
- 渠道:飞书(Feishu)群聊
- 任务类型:一次性定时任务(at)
错误 1:未指定目标聊天 ID
错误命令:
错误日志:
问题分析:
飞书渠道必须明确指定消息发送目标,不能依赖默认的 配置。
解决方案:
添加 和 参数:
错误 2:Feishu 账户配置错误
错误命令:
错误日志:
问题分析:
OpenClaw 的飞书配置中,账户名是 ,但定时任务默认使用 账户。需要在命令中明确指定账户。
查看当前飞书账户配置:
解决方案:
添加 参数(账户名根据你的配置调整):
错误 3:时间格式错误
错误命令:
错误信息:
问题分析:
参数要求 ISO 8601 时间格式(带时区)或纯持续时间(如 ),不支持 或 格式。
解决方案:
使用完整的 ISO 时间格式:
或者使用纯持续时间(从当前时间开始计算):
完整命令模板
参数详解
目标 ID 格式
- 群聊:
- 私聊:
1. 查看任务列表
输出示例:
2. 查看任务详情
3. 查看执行日志
4. 常见错误关键词
循环任务(每天执行)
带模型配置的任务
Q1: 任务创建了但没执行?
A: 检查日志,看是否有 和 日志。如果没有,可能是 Gateway 需要重启。
Q2: 任务执行了但没收到消息?
A: 检查日志中的 字段,常见原因是:
- 未指定 参数
- 账户名错误
- 飞书 Bot 权限不足
Q3: 如何获取飞书群聊 ID?
A: 在飞书群聊中,群 ID 通常以 或 开头。可以通过以下方式获取:
- 查看 OpenClaw 消息元数据
- 在飞书开发者后台查看
- 使用 查看当前会话信息
Q4: 任务执行后想保留记录?
A: 去掉 参数,任务会保留在列表中(状态变为已执行)。
配置 OpenClaw 飞书定时任务的关键点:
- ✅ 必须指定 (和你的飞书账户配置一致)
- ✅ 必须指定
- ✅ 必须指定 (chat:群聊 ID 或 user:用户 OpenID)
- ✅ 时间格式用 ISO 8601(带时区)
- ✅ 查看日志排查问题()
按照这个配置,定时任务应该能正常工作了。如果还有问题,欢迎在评论区交流!
- OpenClaw 官方文档
- OpenClaw CLI 文档
- 飞书开放平台
如果这篇文章帮到了你,欢迎点赞、收藏、转发!🍊
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/275414.html原文链接:https://javaforall.net
