OpenClaw 透過任務、排程工作、推斷承諾、事件 hooks 與常駐指示在背景執行工作。此頁協助你選擇合適機制,並了解它們如何配合運作。Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
快速決策指南
| 使用情境 | 建議使用 | 原因 |
|---|---|---|
| 在上午 9 點準時傳送每日報告 | 排程任務 (Cron) | 精確時間、隔離執行 |
| 20 分鐘後提醒我 | 排程任務 (Cron) | 具精準時間的一次性任務 (--at) |
| 執行每週深度分析 | 排程任務 (Cron) | 獨立任務,可使用不同模型 |
| 每 30 分鐘檢查收件匣 | Heartbeat | 與其他檢查批次執行,具備情境感知 |
| 監控行事曆中的即將到來事件 | Heartbeat | 非常適合週期性覺察 |
| 在提及的面試後追蹤確認 | 推斷承諾 | 類似記憶的後續追蹤,沒有精確提醒請求 |
| 根據使用者情境進行溫和關懷確認 | 推斷承諾 | 限定於同一個 agent 和頻道 |
| 檢查 subagent 或 ACP 執行的狀態 | 背景任務 | 任務台帳會追蹤所有分離工作 |
| 稽核執行了什麼以及何時執行 | 背景任務 | openclaw tasks list 和 openclaw tasks audit |
| 多步驟研究後再摘要 | Task Flow | 具修訂追蹤的持久化編排 |
| 在工作階段重設時執行指令碼 | Hooks | 由事件驅動,會在生命週期事件觸發 |
| 在每次工具呼叫時執行程式碼 | Plugin hooks | 程序內 hooks 可攔截工具呼叫 |
| 回覆前一律檢查合規性 | 常駐指示 | 自動注入每個工作階段 |
排程任務 (Cron) 與 Heartbeat
| 面向 | 排程任務 (Cron) | Heartbeat |
|---|---|---|
| 時間 | 精確(cron 表達式、一次性) | 近似(預設每 30 分鐘) |
| 工作階段情境 | 全新(隔離)或共享 | 完整主要工作階段情境 |
| 任務記錄 | 一律建立 | 從不建立 |
| 傳送方式 | 頻道、webhook,或靜默 | 主要工作階段內聯 |
| 最適合 | 報告、提醒、背景工作 | 收件匣檢查、行事曆、通知 |
核心概念
排程任務 (cron)
Cron 是 Gateway 內建的精準時間排程器。它會持久化工作、在正確時間喚醒 agent,並可將輸出傳送到聊天頻道或 webhook 端點。支援一次性提醒、週期性表達式與傳入 webhook 觸發器。 請參閱排程任務。任務
背景任務台帳會追蹤所有分離工作:ACP 執行、subagent 產生、隔離 cron 執行,以及 CLI 操作。任務是記錄,不是排程器。使用openclaw tasks list 和 openclaw tasks audit 來檢查它們。
請參閱背景任務。
推斷承諾
承諾是選擇加入、短期存在的後續追蹤記憶。OpenClaw 會從一般對話中推斷它們,將其限定於同一個 agent 和頻道,並透過 Heartbeat 傳送到期確認。使用者明確要求的精確提醒仍屬於 cron。 請參閱推斷承諾。Task Flow
Task Flow 是位於背景任務之上的流程編排基礎層。它管理持久化的多步驟流程,提供受管理與鏡像同步模式、修訂追蹤,以及用於檢查的openclaw tasks flow list|show|cancel。
請參閱 Task Flow。
常駐指示
常駐指示會授予 agent 針對已定義程式的永久操作權限。它們存在於工作區檔案中(通常是AGENTS.md),並會注入每個工作階段。可與 cron 結合,用於基於時間的強制執行。
請參閱常駐指示。
Hooks
內部 hooks 是由 agent 生命週期事件(/new、/reset、/stop)、工作階段 Compaction、Gateway 啟動與訊息流程觸發的事件驅動指令碼。它們會自動從目錄中探索,並可使用 openclaw hooks 管理。若要進行程序內工具呼叫攔截,請使用 Plugin hooks。
請參閱 Hooks。
Heartbeat
Heartbeat 是週期性的主要工作階段回合(預設每 30 分鐘)。它會在具完整工作階段情境的一個 agent 回合中,批次處理多項檢查(收件匣、行事曆、通知)。Heartbeat 回合不會建立任務記錄,也不會延長每日或閒置工作階段重設的新鮮度。可使用HEARTBEAT.md 放置一份小型檢查清單;若你想在 Heartbeat 本身內進行僅限到期的週期性檢查,也可使用 tasks: 區塊。空的 Heartbeat 檔案會以 empty-heartbeat-file 略過;僅限到期任務模式會以 no-tasks-due 略過。當 cron 工作處於作用中或已排入佇列時,Heartbeat 會延後;當同一 agent 的工作階段鍵控 subagent 或巢狀 lanes 忙碌時,heartbeat.skipWhenBusy 也可延後該 agent。
請參閱 Heartbeat。
它們如何配合運作
- Cron 處理精確排程(每日報告、每週檢閱)與一次性提醒。所有 cron 執行都會建立任務記錄。
- Heartbeat 在每 30 分鐘的一個批次回合中處理例行監控(收件匣、行事曆、通知)。
- Hooks 以自訂指令碼回應特定事件(工作階段重設、Compaction、訊息流程)。Plugin hooks 則涵蓋工具呼叫。
- 常駐指示 提供 agent 持久情境與權限邊界。
- Task Flow 在個別任務之上協調多步驟流程。
- 任務 會自動追蹤所有分離工作,方便你檢查與稽核。