自动化与任务

OpenClaw 提供多种自动化机制，让代理能够自主执行任务、响应事件和按计划运行。

自动化类型

类型	说明	使用场景
定时任务	按计划时间执行的任务	每日报告、定期检查
后台任务	长时间运行的工作	代码构建、数据处理
常备指令	定义代理被授权执行的永久程序	重复性后台工作
钩子	事件驱动的脚本	代理生命周期事件

定时任务（Cron）

Cron 是 Gateway 内置的调度器，用于在指定时间唤醒代理执行任务。

# 添加一次性提醒
openclaw cron add \
  --name "Reminder" \
  --at "2026-02-01T16:00:00Z" \
  --session main \
  --system-event "Reminder: check the cron docs draft" \
  --wake now \
  --delete-after-run

# 查看任务列表
openclaw cron list

# 查看运行历史
openclaw cron runs --id <job-id>

详见 定时任务 (Cron Jobs)

后台任务

后台任务跟踪在主对话会话之外运行的工作。

# 列出所有任务（最新优先）
openclaw tasks list

# 按运行时或状态过滤
openclaw tasks list --runtime acp
openclaw tasks list --status running

# 显示特定任务的详细信息
openclaw tasks show <lookup>

详见 后台任务

常备指令

常备指令定义代理被授权在无人工干预的情况下执行的操作程序。

详见 常备指令

钩子

事件驱动的脚本，在代理生命周期事件触发时执行。

{
  "hooks": {
    "enabled": true,
    "path": "/hooks"
  }
}

详见 钩子

---

本文档为非官方中文镜像，仅用于学习交流