- name
- feishu-cron-setup
- description
- 设置飞书定时任务投递，确保 cron 任务能稳定地将结果发送到飞书。当需要创建、修复或调试飞书频道的定时任务时使用此技能，特别是当 cron 任务执行成功但消息无法投递到飞书时。
飞书定时任务投递配置
核心问题
症状：cron 任务执行成功（status: ok），但 deliveryStatus: "not-delivered"，错误为 cron announce delivery failed
根因：isolated session 的 cron 任务在飞书频道投递时，必须显式指定 --account 参数
正确的创建命令
openclaw cron add \
--name "<任务名>" \
--cron "<cron表达式>" \
--tz "Asia/Shanghai" \
--session isolated \
--account spy \
--message "<任务提示词>" \
--announce \
--channel feishu \
--to "<飞书用户open_id>" \
--best-effort-deliver关键参数说明
| 参数 | 必须 | 说明 |
|---|---|---|
--session isolated | ✅ | 隔离会话模式 |
--account <id> | ✅ | 飞书账号ID（如 spy、susu、hr 等），对应 openclaw.json 中配置的 accounts |
--announce | ✅ | 开启投递功能 |
--channel feishu | ✅ | 投递渠道为飞书 |
--to <open_id> | ✅ | 飞书用户的 open_id |
--best-effort-deliver | 建议 | 投递失败不影响任务状态 |
查找正确的 account ID
查看 ~/.openclaw/openclaw.json 中的 feishu 配置：
cat ~/.openclaw/openclaw.json | grep -A 20 '"feishu"'找到 accounts 下配置的 key（如 default、spy、susu、hr 等），使用对应账号的 key 作为 --account 参数。
验证投递是否正常
手动触发一次并检查结果：
openclaw cron run <job-id> --expect-final --timeout 90000
# 检查投递状态
openclaw cron runs --id <job-id> | grep -E "delivered|deliveryStatus|deliveryError"成功的标志："delivered": true 和 "deliveryStatus": "delivered"
常见错误排查
| 错误 | 原因 | 解决 |
|---|---|---|
cron announce delivery failed | 缺少 --account | 添加 --account <id> 参数 |
channel not found | 渠道名错误 | 确认飞书插件名为 feishu |
user not found | to 字段格式错误 | 使用 user:open_id 格式，如 user:ou_a894716def92ea8f9a1546f10d61441a |
快速参考
- 飞书用户 open_id：从消息元数据中获取，格式为
ou_xxxxxxxx - 任务执行成功 ≠ 投递成功，两者独立
- 每次创建 isolated 模式的飞书 cron 任务时，都要加
--account <id>