定时任务可以让智能体按照设定时间自动处理重复工作,例如每天生成简报、定期查询信息或按时发送提醒。创建前需要确定四件事:做什么、由哪个智能体执行、什么时候执行,以及结果发送到哪里。
定时任务到达执行时间时,需要PlugClaw正在运行。如果当时PlugClaw没有运行,这次任务不会直接丢失;等PlugClaw下次启动并恢复运行后,会补执行之前错过的任务。例如,原计划上午 9 点生成简报,但PlugClaw到 10 点才开始运行,这份简报会在恢复运行后执行,只是实际完成时间会晚于原计划。
因此,对执行时间要求较高的提醒或推送任务,应尽量让PlugClaw在计划时间保持运行。重新启动PlugClaw后,也可以留意是否有补执行的任务,避免把延迟收到的结果误认为新的计划任务。
任务执行的结果可以只保留在PlugClaw内,也可以发送到已经配置好的外部频道。使用外部投递前,需要先完成对应频道的配置。选择外部频道时,还要指定发送账号和接收目标。
开始前,请按照查看和控制网关中的说明确认网关已经连接,并确认执行任务的智能体可以正常回复。如果要把结果发到外部通道,还需提前完成对应频道和账号的配置。

任务页面会汇总任务总数、运行中、已暂停和失败的数量。首次使用时会显示“暂无定时任务”。





预设时间无法满足需要,并且已经确认Cron表达式写法正确时,可以切换到“使用自定义Cron”,输入想要的定时任务频率。


需要推送到外部时,选择“发送到外部通道”,再依次选择通道、发送账号和接收目标。如果页面中没有可选的通道或发送账号,说明对应频道尚未配置。可以先离开当前创建流程,前往频道配置完成所需通道的配置;确认频道可以正常收发消息后,再回来创建定时任务。发送账号是代表PlugClaw发出消息的账号,例如配置微信频道后出现的微信ClawBot;接收目标是最终收到结果的联系人或会话,例如你的微信。
如果已经选好发送账号,但列表中还没有接收目标,通常是因为你还没有和这个配置好的Bot产生过会话。先在对应的平台中主动给Bot发一条消息,例如在微信中给微信ClawBot发一句“你好”;Bot收到消息后,再回到定时任务页面选择接收目标,就能找到对应的联系人或会话。


创建后,任务应出现在列表中,并计入“运行中”或“已暂停”。第一次到达执行时间后,请检查结果内容和投递位置;如果任务显示“失败”,先核对智能体、积分、提示词和外部目标是否仍然可用,再调整任务。
