飞书 Cron Announce 定时推送
核心要点
成功关键：--session isolated + --announce + --channel feishu + --to + --tz Asia/Shanghai
标准命令模板
openclaw cron add \
--name "<任务名>" \
--cron "<cron表达式>" \
--tz "Asia/Shanghai" \
--session isolated \
--message "<提示词：让 AI 检查什么并生成简短结论>" \
--announce \
--channel feishu \
--to "<飞书用户 open_id>" \
--best-effort-deliver
参数说明
| 参数 | 必须 | 说明 |
|---|
--session isolated | ✅ | 隔离会话，announce 必须用 isolated |
--tz "Asia/Shanghai" | ✅ | 指定时区，避免 UTC 偏移 |
--announce | ✅ | 开启结果投递 |
--channel feishu | ✅ | 投递渠道为飞书 |
--to "<open_id>" | ✅ | 飞书用户 open_id（格式：ou_xxx） |
--best-effort-deliver | 建议 | 投递失败不影响任务状态 |
--account default | ⚠️ | 多账号时必须指定；单账号可不写 |
--cron | ✅ | 标准 cron 表达式（0 * * * * = 每小时整点） |
常见错误
| 错误 | 原因 | 解决 |
|---|
deliveryStatus: "not-delivered" | 多账号未指定 --account | 添加 --account default |
channel not found | 渠道名错误 | 确认用 feishu |
user not found | open_id 格式错误 | 用 ou_ 开头的用户 ID |
验证命令
# 手动触发
openclaw cron run <job-id>
# 检查结果
openclaw cron runs --id <job-id>
# 成功标志
"delivered": true
"deliveryStatus": "delivered"
快速参考
- 飞书 open_id：从消息元数据获取，格式
ou_xxx
- cron 表达式：
0 * * * * 每小时整点，0 9 * * * 每天 9 点
- 任务执行成功 ≠ 投递成功，两者独立