OneCLI定时任务实战如何让AI Agent按计划自动唤醒干活完整配置教程与避坑清单【免费下载链接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.项目地址: https://gitcode.com/gh_mirrors/on/onecliOneCLI 定时任务是这款开源沙箱 Agent 平台的核心能力之一OneCLI 让每位员工拥有一个安全的个人 AI Agent而它的「A schedule」机制能让 Agent 按计划自动唤醒干活——比如每天早上 9 点汇总收件箱、每小时巡检一次线上服务。本文是一份面向新手的完整配置教程带你用最少的代码把 Agent 定时唤醒跑起来并附一份避坑清单。什么是 OneCLI 的定时任务Cron在 OneCLI 中Agent 不只是「问一句答一句」它是一件持久存在的资产有自己的沙箱、对话、记忆和技能还有一份日程表。平台会在正确的时间点唤醒沙箱、把任务提示词作为一轮对话发给 AgentAgent 干完活后把报告投递回当初创建定时任务的那个聊天窗口。整个唤醒链路托管在控制面而不是沙箱里计划存控制面定时任务行由 agent-cron-service.ts 统一管理沙箱重启不影响计划。Runner 轮询触发由 cron-fire-service.ts 在 Runner 每次轮询时检查到期任务并点火。报告自动送达每次运行在独立对话中进行报告自动发回创建任务的聊天你不用守屏。两种配置方法聊天里说一句话 / 控制台可视化方法一直接在聊天里说推荐新手Agent 自带三个平台工具schedule_task创建、list_tasks查看、cancel_task取消工具契约定义在 crons.ts。你只需要用自然语言说“每天早上 9 点检查支持邮箱把紧急事项汇总发给我。”Agent 会调用schedule_task建好计划。注意它必须有一个明确的 IANA 时区如Asia/Shanghai。如果你没说时区Agent 会主动问你——这是刻意设计因为「14:00」没有时区就没有意义。方法二Dashboard 的 Schedules 页面进入某个 Agent 页面 →Schedules标签 → 点New schedule会弹出一个配置对话框实现见 cron-dialog.tsx/w/[workspaceId]/agents/[agentId]/schedules/_components/cron-dialog.tsx?utm_sourcegitcode_repo_files)。需要填 4 个字段字段说明Name简短可读的名字会显示在每份报告上What should it do?每次运行要执行的任务指令Runs四种预设每天 / 每小时 / 指定时间执行一次 / 自定义 cron 表达式TimezoneIANA 时区默认自动取你浏览器的时区保存后任务列表每一行会显示cron 表达式、时区、下次触发时间、上次运行结果以及三个操作Run now立即手动跑一次、编辑、暂停/恢复开关。常用定时任务类型速查预设本质上在拼标准 5 段 cron 表达式分 时 日 月 周每天 14:00→0 14 * * *⏰每小时第 0 分→0 * * * *工作日早会提醒→0 9 * * 1-5自定义栏填写⏳一次性任务→ 用2026-09-27T09:00:00这样的 ISO 本地时间到点触发一次后任务自动标记为 Completed校验由服务端 croner 引擎负责创建时就用「将来真实计算下次触发的同一个对象」来验证表达式不存在「保存成功但永远不触发」的行见 validations/crons.ts。避坑清单这些细节决定定时任务靠不靠谱✅ / ⚠️ 对照检查基本能避开所有新手坑⚠️ 时区必填且必须是 IANA 名称写UTC、Asia/Shanghai这类名字写中文或CST这类缩写会被拒绝。⚠️ 每个 Agent 最多 20 个定时任务这是可用性上限MAX_CRONS_PER_AGENT规划时把大任务拆给不同 Agent。⚠️ 任务可能在 5 分钟内迟到平台给每次触发加了 0~300 秒的「只晚不早」抖动避免全公司「每天 9 点的日报」同时惊起一堆沙箱。别把它当 bug。⚠️ 上一轮没跑完时本轮会跳过结果记为skipped_busy下个周期自动重试。所以长任务比如跑半小时的爬取别配 15 分钟一次的计划。⚠️ 连续失败 5 次会自动停用任务不会无限报错轰炸你行上会出现 Auto-disabled 徽标修复后手动打开开关即可恢复CRON_FAILURE_DISABLE_THRESHOLD。⚠️ 创建者失去工作区权限后任务会因授权失效自动停用安全设计离职/调岗账号的定时任务不会继续持有「落脚点」。✅ 平台停机期间的触发会合并成一次补发按当前时间重新计算下一次触发不会积压一堆补跑。✅ 一次性任务触发后是「完成」而非「故障」行上显示 Completed 徽标属正常终态。✅ 先用 Run now 验证创建后点一下立即执行确认报告能正常回到聊天窗口再放心交给计划。✅ 任务名要描述性名字会拼在每一份自动报告的头部Daily inbox check远好于task1。想看源码关键路径在这里平台工具与能力片段教 Agent 使用 schedule_task 的提示词就在这里apps/sandbox-supervisor/src/capabilities/crons.ts计划行服务创建/更新/停用、下次触发计算packages/api/src/services/agent-cron-service.ts点火逻辑到期认领、授权复查、跳过与完成packages/api/src/services/cron-fire-service.ts参数校验与上限名称 100 字符、提示词 1 万字符packages/api/src/validations/crons.tsDashboard 调度面板apps/web/src/app/(dashboard)/w/[workspaceId]/agents/[agentId]/schedules/端到端行为验证apps/hosted-e2e/tests/cron.test.ts小结OneCLI 定时任务的设计哲学是「计划归平台执行归沙箱结果归聊天」你只需说清「什么时间、做什么、哪个时区」唤醒、授权复查、失败自愈都交给控制面。按上面的步骤配置一遍再对照避坑清单检查一遍你的 AI Agent 就会像靠谱的同事一样到点自己开工、干完自动汇报。【免费下载链接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.项目地址: https://gitcode.com/gh_mirrors/on/onecli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考