文档中心

ArkClaw 企业版

请输入

命令详解

定时任务

定时任务由 Claw 服务端内置调度器后台执行，仅 OpenClaw 传输模式支持，A2A 公网通道不可用。

前置校验

创建 / 管理任务前，先确认目标 Claw 实例调度器功能已开启：

arkclaw cron status --clawid <ClawID>

创建任务

示例 1：每日 9 点执行循环任务

arkclaw cron add \​
  --name "每日摘要" \​
  --cron "0 9 * * *" \​
  --tz Asia/Shanghai \​
  -m "生成今日工作摘要" \​
  --clawid <ClawID>​

示例 2：每 30 分钟巡检任务

arkclaw cron add \​
  --name "服务巡检" \​
  --every 30m \​
  -m "检查服务状态并记录异常" \​
  --clawid <ClawID>​

命令介绍

调度触发方式三选一，不可同时配置：

--cron "表达式"：标准分时日月周定时，搭配 --tz 指定时区。

--every <正整数><s|m|h|d>：简单循环（秒 / 分 / 时 / 天）。

--at <ISO8601 时间>：一次性定点执行，常配合 --delete-after-run。

其他常用参数：

选项	作用
--agent <AgentID>	指定执行任务的 Agent
--model <模型>	覆盖任务默认推理模型
--timeout <秒>	单次任务最大执行超时时间
--session-target isolated	每次运行使用独立会话，默认值
--session-target main	使用主会话
--session-target current	使用当前会话
--disabled	任务创建后处于禁用状态，未指定时默认启用
--delete-after-run	执行一次后自动删除，通常配合 --at

查看和修改任务

arkclaw cron list --clawid <ClawID> # 列出实例全部定时任务​
arkclaw cron get <任务ID> --clawid <ClawID> # 查看单条任务完整配置详情​
​
arkclaw cron update <任务ID> --disable --clawid <ClawID> # 停用任务​
arkclaw cron update <任务ID> --enable --clawid <ClawID> # 启用任务​
arkclaw cron update <任务ID> -m "新的任务内容" --clawid <ClawID> # 修改任务执行指令​

update 仅更新显式传入的参数，未传入字段默认保留原值。

使用 -m/--message 修改任务指令时，底层会重建任务 payload，原有 model 或 timeout等配置会丢失。

update完成后，必须执行 cron get 核对完整配置，避免参数丢失导致任务异常。

标识带 * 的任务：由 Agent Pack 模板 / 平台托管，应在对应控制台或模板中修改，不建议通过 CLI 修改，避免与平台自动同步冲突。

# 默认强制立即运行​
arkclaw cron run <任务ID> --clawid <ClawID>​
​
# 仅当前时间到达调度周期时才执行​
arkclaw cron run <任务ID> --due --clawid <ClawID>​
​
# 查看单任务最近20次运行日志​
arkclaw cron runs <任务ID> --limit 20 --clawid <ClawID>​
​
# 删除​
arkclaw cron rm <任务ID> --clawid <ClawID>​

删除时，无人值守脚本需强制携带 --yes；不可仅依靠命令退出码 0 判断删除成功，需解析返回 JSON 的 removed 字段校验结果；无 --yes 交互式场景取消删除时，命令依旧返回退出码 0，无法区分是否真实删除。

CLI 创建任务时本地配置的 cmdpolicy.json、--approve-all、终端交互确认，均不会在定时任务后台运行时生效，工具实际执行权限由 Claw 运行时和平台策略管控，与本地客户端隔离。建议遵循最小权限原则，仅给定时任务开放业务必需的工具权限；禁止在任务指令、提示词内写入密钥、账号、凭证等敏感信息，避免日志泄露。

最近更新时间：2026.07.23 17:31:53

这个页面对您有帮助吗？

有用

无用