摘要:本文详细记录了在 OpenClaw 中配置飞书(Feishu)定时任务的完整过程,包括常见错误、排查方法和正确配置方式。如果你也遇到”定时任务不执行”、”消息发不出去”的问题,这篇文章能帮你快速解决。
在使用 OpenClaw 配置飞书群聊定时任务时,遇到了以下问题:
- 定时任务创建了,但到时间不执行
- 任务显示"已执行",但群里没收到消息
- 各种报错信息看不懂,不知道如何排查
经过一下午的调试和日志分析,终于找到了所有坑点。本文将完整记录整个排查过程和解决方案。
- OpenClaw 版本:2026.3.8
- 渠道:飞书(Feishu)群聊
- 任务类型:一次性定时任务(at)
错误命令:
openclaw cron add --name "提醒" --at "2026-03-12T17:13:00+08:00" --message "该上厕所了"
错误日志:
问题分析: 飞书渠道必须明确指定消息发送目标,不能依赖默认的 "channel": "last" 配置。
解决方案: 添加 --channel feishu 和 --to 参数:
--channel feishu --to "chat:群聊ID"
错误命令:
openclaw cron add --name "提醒" --at "2026-03-12T17:30:00+08:00" --channel feishu --to "chat:oc_xxx" --message "该吃冰淇淋了"
错误日志:
{ "error": "Error: Feishu account "default" not configured", "reason": "permanent error" }
问题分析: OpenClaw 的飞书配置中,账户名是 "main",但定时任务默认使用 "default" 账户。需要在命令中明确指定账户。
查看当前飞书账户配置:
# 查看 openclaw.json 中的 channels.feishu.accounts 配置 cat ~/.openclaw/openclaw.json | grep -A 20 '"feishu"'
解决方案: 添加 --account main 参数(账户名根据你的配置调整):
--account main
错误命令:
openclaw cron add --at "+1m" ... openclaw cron add --at "17:30" ...
错误信息:
Error: Invalid --at; use ISO time or duration like 20m
问题分析: --at 参数要求 ISO 8601 时间格式(带时区)或纯持续时间(如 20m),不支持 +1m 或 HH:MM 格式。
解决方案: 使用完整的 ISO 时间格式:
--at "2026-03-12T17:30:00+08:00"
或者使用纯持续时间(从当前时间开始计算):
--at "20m" # 20 分钟后
openclaw cron add --name "任务名称" --at "2026-03-12T17:40:00+08:00" --account main --channel feishu --to "chat:oc_1f179c606f60946f0a411a786b2df6a1" --message "🍦 该吃冰淇淋啦!享受甜蜜时刻~" --delete-after-run
--name ✅ 任务名称
"吃冰淇淋提醒"
--at ✅ 执行时间(ISO 格式)
"2026-03-12T17:40:00+08:00"
--account ✅ 飞书账户名
main(根据配置)
--channel ✅ 渠道类型
feishu
--to ✅ 目标 ID
chat:群聊 ID 或
user:用户 OpenID
--message ✅ 消息内容
"提醒内容"
--delete-after-run ⭕ 执行后自动删除 (一次性任务推荐)
- 群聊:
chat:oc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx - 私聊:
user:ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
openclaw cron list
输出示例:
ID Name Schedule Next Status 799a799c-ebaa-4460-b821-ca19 吃冰淇淋提醒 at 2026-03-12 09:30Z in 3m idle
cat ~/.openclaw/cron/jobs.json
# 查看最近的 cron 相关日志 tail -100 /tmp/openclaw/openclaw-2026-03-12.log | grep -i cron # 查看特定任务的日志 tail -100 /tmp/openclaw/openclaw-2026-03-12.log | grep "任务 ID"
# 搜索错误日志 grep -E "Delivering to Feishu|Feishu account.*not configured|cron.*error" /tmp/openclaw/*.log
openclaw cron add --name "每日晨报" --cron "0 8 * * *" --account main --channel feishu --to "chat:oc_xxx" --message "☀️ 早上好!新的一天开始啦~" --tz "Asia/Shanghai"
openclaw cron add --name "AI 日报" --at "2026-03-12T18:00:00+08:00" --account main --channel feishu --to "chat:oc_xxx" --message "请帮我总结一下今天的 AI 热点新闻" --model "bailian/qwen3.5-plus" --delete-after-run
A: 检查日志,看是否有 cron: job added 和 cron: timer armed 日志。如果没有,可能是 Gateway 需要重启。
A: 检查日志中的 error 字段,常见原因是:
- 未指定
–to参数 –account账户名错误- 飞书 Bot 权限不足
A: 在飞书群聊中,群 ID 通常以 oc_ 或 chat: 开头。可以通过以下方式获取:
- 查看 OpenClaw 消息元数据
- 在飞书开发者后台查看
- 使用
openclaw status查看当前会话信息
A: 去掉 –delete-after-run 参数,任务会保留在列表中(状态变为已执行)。
配置 OpenClaw 飞书定时任务的关键点:
- ✅ 必须指定
–account(和你的飞书账户配置一致) - ✅ 必须指定
–channel feishu - ✅ 必须指定
–to(chat:群聊 ID 或 user:用户 OpenID) - ✅ 时间格式用 ISO 8601(带时区)
- ✅ 查看日志排查问题(
/tmp/openclaw/*.log)
按照这个配置,定时任务应该能正常工作了。如果还有问题,欢迎在评论区交流!
- OpenClaw 官方文档
- OpenClaw CLI 文档
- 飞书开放平台
如果这篇文章帮到了你,欢迎点赞、收藏、转发!🍊
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/275006.html