可在OpenClaw中通过四种方式实现定时触发技能:一、利用Skill生命周期钩子启动asyncio协程循环;二、使用openclaw-cron插件解析crontab格式配置;三、配合系统cron调用Skill暴露的HTTP Webhook;四、在Skill状态机中嵌入时间窗口判断逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在OpenClaw中实现定时触发技能执行,而非依赖传统系统级cron服务,则可通过OpenClaw内置的Skill机制构建轻量、可移植的定时任务逻辑。以下是实现该目标的具体操作路径:
一、基于Skill生命周期钩子注入定时逻辑
OpenClaw的Skill对象支持on_start、on_stop等生命周期回调,可在on_start中启动一个独立协程,利用asyncio.sleep循环控制执行间隔,避免阻塞主事件循环。该方式不依赖外部调度器,完全由Skill自身管理。
1、在Skill类的__init__方法中声明一个私有属性用于存储定时任务任务对象,例如self._cron_task = None。
2、重写on_start异步方法,在其中调用asyncio.create_task(self._run_cron_loop())启动后台循环。
3、定义私有异步方法_run_cron_loop,在其中使用while True配合await asyncio.sleep(60)实现每分钟检查一次触发条件。
4、在循环体内调用self.execute_skill_action()执行预设技能动作,并确保每次执行前校验self.is_enabled为True。
二、使用OpenClawcron插件注册周期性Skill调用
OpenClawcron是专为OpenClaw设计的轻量级定时扩展,允许以JSON配置声明技能ID、执行表达式(如"*/5 * * * *")及参数载荷,由插件统一解析并分发调用。该方式将调度逻辑与技能逻辑解耦,便于多技能复用同一调度器。
1、确认已安装openclaw-cron插件,通过pip install openclaw-cron完成部署。
2、在OpenClaw配置目录下创建cron.json文件,内容包含数组形式的job定义,每个job含skill_id、schedule、payload字段。
3、在skill_id字段中填入目标Skill的唯一标识符,例如"weather_notifier"。
4、在schedule字段中使用标准crontab语法,如"0 */2 * * *"表示每两小时整点触发。
5、启动OpenClaw时加载该插件,插件自动读取cron.json并注册对应异步任务。
三、通过外部HTTP Webhook触发Skill并搭配系统cron调用
当OpenClaw运行于固定主机且具备HTTP接口能力时,可启用Skill内置的Webhook路由,再由系统级crond定期curl该端点。该方案利用操作系统原生调度可靠性,同时保持Skill内部逻辑纯净无定时耦合。
1、在Skill中启用webhook支持,设置route_path为"/trigger/daily-backup",method为"POST"。
2、确保OpenClaw已开启HTTP服务并在config.yaml中配置host: "0.0.0.0"和port: 8080。
抓取并分析 OpenClaw JSONL 会话日志,重建并回填代理记忆文件。适用于:(1) 模型切换后记忆不完整,(2) 验证记忆覆盖度,(3) 重建丢失记忆,(4) 通过 cron/heartbeat 自动同步每日记忆。支持简单提取及基于 LLM 的叙事摘要,并自动清理敏感信息。
3、编写shell脚本curl -X POST http://localhost:8080/trigger/daily-backup,保存为/opt/openclaw/daily.sh。
4、使用crontab -e添加条目:0 2 * * * /opt/openclaw/daily.sh,表示每日凌晨2点执行。
5、赋予脚本执行权限:chmod +x /opt/openclaw/daily.sh。
四、利用Skill状态机在特定时间窗口内激活执行
部分技能需在业务时间范围内运行(如工作日9:00–18:00),此时可将时间判断逻辑嵌入Skill状态机transition条件中。每次事件循环检查当前时间是否匹配窗口,仅在有效时段内允许进入“ready_to_execute”状态并触发动作。
1、在Skill类中定义_time_window_start = time(9, 0)和_time_window_end = time(18, 0)两个time对象。
2、在on_event或自定义轮询方法中调用datetime.now().time()获取当前时间。
3、使用if current_time >= self._time_window_start and current_time
4、满足条件时调用self.transition("ready_to_execute"),并在对应状态处理函数中执行核心逻辑。
5、为防止高频轮询,可在判定失败后await asyncio.sleep(300),即每5分钟检查一次。
五、通过Redis有序集合实现分布式延迟队列式调度
在集群化OpenClaw部署场景下,多个实例需共享统一调度视图。借助Redis的ZADD与ZPOPMIN命令,可将技能执行任务以时间戳为score存入有序集合,由各节点竞争消费,确保同一任务仅被一个实例执行。
1、在Skill初始化阶段连接Redis客户端,地址取自环境变量REDIS_URL。
2、定义_schedule_in_redis(skill_id: str, delay_seconds: int, payload: dict)方法,计算执行时间戳为int(time.time()) + delay_seconds。
3、调用redis.zadd("openclaw:cron:queue", {json.dumps(payload): execution_timestamp})写入任务。
4、启动后台协程持续执行redis.zpopmin("openclaw:cron:queue", count=1),若返回非空则解析并调用对应skill_id的handle_scheduled_event方法。
5、在handle_scheduled_event中验证payload签名与时效性,必须校验timestamp字段距当前时间偏差不超过30秒,防止重放攻击。

















