openclawai支持三种定时任务配置方式：一、内置cron调度器，通过编辑config/scheduler.yaml并执行reload命令启用；二、系统级cron调用openclaw-cli，需配置path与api token；三、webhook+第三方平台，需启用api并配置密钥与json参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望OpenClawAI在指定时间自动运行模型推理、数据处理或批量预测等任务，则需要通过其内置的计划任务机制进行配置。以下是设置OpenClawAI定时执行模型任务的具体操作步骤：
一、使用OpenClawAI内置调度器配置Cron任务
OpenClawAI提供基于Linux Cron语法的轻量级调度模块，支持在服务端直接定义周期性任务，无需额外部署调度服务。该方式适用于部署在Linux服务器上的OpenClawAI实例，且要求后台服务以systemd或supervisord方式常驻运行。
1、登录OpenClawAI所在服务器，进入其安装目录下的config/子目录。
2、编辑scheduler.yaml文件，添加如下结构的任务定义：
3、在jobs:列表下新增一个任务项，包含name、cron（如"0 2 * * *表示每日凌晨2点）、model_id（对应已注册模型的唯一标识）及input_source（如"dataset:batch_2024_q3"）。
4、保存文件后，执行openclaw-cli scheduler reload命令使配置生效。
5、通过openclaw-cli scheduler list验证任务是否已加载并显示为active状态。
二、通过外部Cron调用OpenClawAI CLI触发任务
当OpenClawAI未启用内置调度器，或需与现有运维体系集成时，可利用系统级Cron定期调用其命令行接口。该方法不依赖OpenClawAI内部调度模块，兼容所有部署形态（Docker、裸机、K8s Job等）。
1、确保openclaw-cli已加入系统PATH，并可通过非交互方式完成身份认证（例如预置~/.openclaw/config.json含有效API Token）。
2、运行crontab -e进入编辑模式。
将 iPhone 的 Apple Health 数据同步到 OpenClaw。只需扫描一次二维码，无需手动配置。支持 Mac、Linux 和 VPS。
3、添加一行标准Cron表达式，例如：30 4 * * 1-5 /usr/local/bin/openclaw-cli run --model-id cls-resnet50-v2 --input-path /data/incoming/weekly --output-dir /data/output/daily。
4、保存退出后，系统将在每周一至周五凌晨4:30自动执行该模型任务。
5、检查/var/log/syslog或自定义日志路径中由openclaw-cli输出的Task submitted with job_id:记录，确认触发成功。
三、借助Webhook + 第三方调度平台实现远程定时触发
对于无法直连OpenClawAI服务端的场景（如隔离网络、云函数环境），可通过暴露的HTTP Webhook端点接收外部调度平台的POST请求，从而间接启动模型任务。此方式要求OpenClawAI已启用Web API且webhook.enabled: true。
1、在OpenClawAI配置中启用Webhook服务，并记录/api/v1/webhook/task-trigger端点URL及预设密钥webhook.secret。
2、登录第三方调度平台（如Apache Airflow、n8n、腾讯云SCF定时触发器），新建一个HTTP节点。
3、设置请求方法为POST，URL填写上述Webhook地址，Header中加入X-Webhook-Secret: <strong><font color="green">您的密钥值</font></strong>。
4、在Body中以JSON格式提交任务参数，包括{"model_id": "det-yolov8n", "input_ref": "s3://bucket/raw-images/", "priority": 5}。
5、保存调度规则并启用，平台将按设定周期向OpenClawAI发送携带认证信息的触发请求。
