ArkClaw 企业版
ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
ArkClaw 企业版
产品动态
ArkClaw性能说明
员工使用ArkClaw
管理Agent
ArkClaw快捷功能
Hermes Agent
ArkClaw高级功能
管理 ArkClaw 实例
查看 ArkClaw 详情
管理 ArkClaw 插件与连接器
管理企业服务智能体
员工观测ArkClaw
管理员管理ArkClaw
Claw 实例
管理席位下的 Claw 实例
用户管理
网络管理
公网出口
私网出口
安全管理
管理员观测ArkClaw
管理员批量运维ArkClaw
最佳实践
开发者指南
API 参考
ClawSpace
Template
ClawInstance
Image
UserManagement
UserSeatQuota
PrivateEgressService
ArkClaw
产品动态
控制台操作指南
管理 Agent
使用技巧
快捷功能
Hermes Agent
管理 ArkClaw
观测 ArkClaw
常见问题
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南CLI参考命令详解定时任务
复制全文
下载 pdf定时任务
文档反馈
问问助手定时任务由 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
这个页面对您有帮助吗？
有用
有用
无用
无用