装完 OpenClaw(社区也叫养龙虾),向导一般都能走完,接下来常见的情况是 Gateway 挂着、模型能聊,但不知道每天让它干啥。定时能力在官方叫 Automations,CLI 是 openclaw automations,openclaw cron 是同一套别名,见 定时任务。调度跑在 Gateway 进程里,Gateway 没跑,到点也不会触发。任务会持久化,重启一般不丢;具体字段看文档最新说明。
安装就不多写了,下面主要说国内开发者常用的几类任务。命令只写官方文档里出现过的用法,完整参数看 openclaw automations --help 或文档。
三种执行方式
官方把执行方式分成几类(同一页有张表):
- 主会话
main:适合提醒、系统事件,相当于到点叫你一声。 - 隔离
isolated:每次新会话,适合日报、巡检、后台杂务,不会混进聊天上下文。 - 自定义
session:xxx:跨次保留上下文,适合每天接着昨天的站会摘要往下写这种。
调度类型常见是 --at 一次性、--every 固定间隔、--cron 表达式(可加 --tz)。按国内作息直接写 --tz Asia/Shanghai,不用再按主机时区去换算。投递可用 --announce 丢到聊天渠道,或 webhook / 不投递。飞书渠道见 Feishu:大陆飞书域、WebSocket 长连接那套,装好之后定时结果才能稳定发到群或私聊。
国内开发者常挂的几类任务
1. 早报 / 日报(飞书)
工作日早上:拉日历、待办、昨夜 CI / Issue 摘要,整理成中文丢飞书。官方示例里有早上 brief + --session isolated + --announce 的形态,渠道换成 feishu、--to 写成飞书侧要求的 user: / chat: 形式即可(目标 ID 按你机器人那边实际看到的填)。提示词里写死「用中文回复;URL、代码、产品名保持原文」,文档明确说定时任务不会按渠道自动猜语言。别让它写三千字综述,半页要点就够看了,也省 Token。
2. 仓库巡检
每晚或每工作日:对本机已 clone 的几个仓跑 git status / 未推送分支 / 失败的 CI 摘要(有 gh 权限再碰 GitHub)。这种适合用 isolated,免得带着白天闲聊的上下文去乱改。只读巡检为主;要自动提 PR、合并,先把权限和审批边界想清楚,别一上来给全盘 shell。仓库路径写进提示词或工作区约定,别让它满盘乱翻。
3. 配置 / 工作区备份提醒或备份脚本
--command 载荷可以在 Gateway 主机上跑确定性脚本、不走模型(这是管理员配好的自动化,不是让模型随便 exec)。适合:打包 ~/.openclaw 里该备份的部分、同步到你自己的盘、检查备份是否过期。敏感文件别往公开群 announce 全文;失败了走 failure 通知,别让它悄悄挂掉。具体该拷哪些目录,看你的部署方式,再对照官方「配置与状态位置」那页。
4. 周报合并
周日或周五下午:用 session:weekly 一类自定义会话,让它读本周几次日报摘要再压成周报。这种要接着上次往下写的活,就别每天新开 isolated 会话了。记得在提示词里写清「承接上次周报未完成项」,否则它容易当成第一次写。
5. 轻量健康检查
every 15m / every 1h:磁盘、关键容器、队列深度这类,更适合用 --command 脚本;只有异常才 announce,正常输出 NO_REPLY 类静默(文档有静默约定)。别让模型每十五分钟写一大段,费 Token 又刷屏。
任务挂上之后,用 openclaw cron list、openclaw cron runs --id <job-id>(或 automations 同名子命令)看状态和运行记录,出问题先别急着重装。到点没反应,先看 Gateway 是否在线、cron.enabled / OPENCLAW_SKIP_CRON、时区是否设错。同一宿主机别叠一堆整点任务,官方对整点 cron 还有错峰;真要卡点再用文档里的 --exact。
国内 API / Key 的注意事项
OpenClaw 支持多家提供商,目录见 提供商。国内常用官方插件路径包括 DeepSeek、Qwen(含中国区 Coding Plan / Standard 的 onboard 选项,例如文档里的 qwen-api-key-cn、qwen-standard-api-key-cn)。
几条注意事项:
- Key 只从厂商开放平台官方控制台申请,按对方服务条款和实名/计费要求使用;别用来路不明的「共享 Key」「批发额度」。
- 中国区 / 国际区 endpoint 别混用;Qwen 文档按计划类型和区域列了不同 auth-choice 与地址,选错会鉴权失败或走到不该走的线路。
- Key 放环境变量或文档推荐的本地配置(如
DEEPSEEK_API_KEY、QWEN_API_KEY,守护进程还要让 Gateway 进程读得到),不要写进群公告、不要贴公开仓库、不要塞进定时任务的 message 明文。 - 定时任务会周期性烧 Token:日报用小模型、巡检能
--command就别上大模型;设超时和失败告警,避免挂了还在空转。 - 飞书应用权限、机器人可见范围按飞书开放平台申请,只开用得到的能力。
模型名、默认推荐、停用日期都会变,用之前翻一下官方文档。大家都挂了哪些任务?方便的话贴一下 cron list 脱敏后的名字和周期,我也参考参考。