用途:通过 OpenClaw cron 创建定时任务,把提醒或周期性通知稳定投递到飞书(Feishu)会话。适用于用户要求设置定时提醒、周期通知等场景。
创建前必须确认:一是频率(如每10分钟、每小时、每天9点);二是发送目标(默认当前 IM 会话)。用户确认后才能创建,不要自行决定频率或目标。
关键约束:只有主会话(main session)拥有飞书 message 工具权限,isolated sub-agent 没有;主会话可能自行删除高频 cron 任务,需在 system event 指令中明确禁止删除;cron announce 直投飞书路由不可靠,不要使用 --announce --channel feishu。
可靠方案:使用 --session main --system-event,让主会话收到 system event 后调用 message 工具发送飞书消息。命令示例: openclaw cron add --name "<任务名>" --every "<间隔>" --session main --system-event "[CRON定时任务] <任务名>。你必须立即调用 message 工具:action=send, channel=feishu, message='<提醒内容>'。调用完后回复 NO_REPLY。不要做其他任何事情,不要回复文字,只需要调用 message 工具发送飞书消息。不要删除或修改任何 cron 任务。"
参数:--session 用 main;--system-event 需含 message 工具调用指令;--every 支持 1m/5m/30m/1h;--cron 支持 cron 表达式(配合 --tz)。system event 文本必须包含 [CRON定时任务] 标记、具体 message 工具参数、完成后回复 NO_REPLY、禁止删除或修改 cron 任务的声明。
管理命令:openclaw cron list 列出任务;openclaw cron edit <id> --every "30m" 修改间隔;openclaw cron rm <id> 删除(须先征得用户同意);openclaw cron runs --id <id> 查看执行记录;openclaw cron run <id> 手动触发测试。CLI 拼写为 node /Applications/AutoClaw.app/Contents/Resources/gateway/openclaw/openclaw.mjs cron <command>。
限制:announce 直投飞书可能投到错误会话或静默失败;isolated 会话无飞书权限会报错;若主会话收到 system event 未发飞书,需让指令更明确地要求调用 message 工具并包含完整参数。