已排程任務

Cron 是 Gateway 的內建排程器。它會持久化工作，在正確的時間喚醒代理，並可以將輸出傳遞回聊天頻道或 webhook 端點。

快速入門

1. 新增一次性提醒

   openclaw cron create "2026-02-01T16:00:00Z" \
     --name "Reminder" \
     --session main \
     --system-event "Reminder: check the cron docs draft" \
     --wake now \
     --delete-after-run

2. 檢查您的工作

   openclaw cron list
   openclaw cron get

   openclaw cron show

3. 查看執行歷史

   openclaw cron runs --id

Cron 的運作方式

• Cron 在 Gateway 程序內部執行（而非在模型內部）。
• 工作定義、執行時狀態和執行歷史記錄會持久儲存在 OpenClaw 的共享 SQLite 狀態資料庫中，因此重啟不會導致排程遺失。
• 升級時，請執行 openclaw doctor --fix 以將舊版 ~/.openclaw/cron/jobs.json、jobs-state.json 和 runs/*.jsonl 檔案匯入 SQLite，並將其重新命名加上 .migrated 後綴。格式錯誤的工作列會在執行時期被跳過，並複製到 jobs-quarantine.json 以供稍後修復或檢閱。
• cron.store 仍會指定邏輯 cron 儲存金鑰與 doctor 匯入路徑。匯入後，編輯該 JSON 檔案將不再會變更作用中的 cron 工作；請改用 openclaw cron add|edit|remove 或 Gateway cron RPC 方法。
• 所有 cron 執行都會建立 background task 記錄。
• Gateway 啟動時，過期的隔離 agent-turn 工作會重新排程到通道連線視窗之外，而不是立即重播，這樣 Discord/Telegram 啟動和原生指令設定在重啟後仍能保持響應。
• 單次工作 (--at) 預設在成功後會自動刪除。
• 獨立 cron 執行會在執行完成時，盡力關閉其 cron:<jobId> 會話的追蹤瀏覽器分頁/程序，因此分離的瀏覽器自動化不會留下殘留的程序。
• 接收狹隘 cron 自身清理授權的隔離 cron 執行仍然可以讀取排程器狀態、其目前工作的自我過濾清單，以及該工作的執行歷史記錄，因此狀態/心跳檢查可以檢查其自己的排程，而無需獲得更廣泛的 cron 變更存取權。
• 獨立 cron 執行也會防止過時的確認回覆。如果第一個結果只是過渡狀態更新 (on it、pulling everything together 和類似提示)，且沒有子代理執行仍對最終答案負責，OpenClaw 會在傳送前再次提示以取得實際結果。
• 獨立 cron 執行會使用來自內嵌執行的結構化執行拒絕中繼資料，包括巢狀錯誤訊息以 SYSTEM_RUN_DENIED 或 INVALID_REQUEST 開頭的節點主機 UNAVAILABLE 包裝器，因此被封鎖的指令不會被回報為成功執行，而一般的助理文字也不會被視為拒絕。
• 獨立 cron 執行還會將執行層級的代理失敗視為任務錯誤，即使沒有產生回應載荷，因此模型/提供者失敗會增加錯誤計數器並觸發失敗通知，而不是將任務清除為成功。
• 當獨立的 agent-turn 工作到達 timeoutSeconds 時，cron 會中止底層的代理執行並給予短暫的清理時間。如果執行未清空，Gateway 擁有的清理程序會在 cron 記錄逾時前強制清除該執行的會話擁有權，因此排隊的聊天工作不會滯留於過時的處理會話。
• 如果獨立的 agent-turn 在 runner 啟動之前或第一次模型調用之前停滯，cron 會記錄特定階段的超時，例如 setup timed out before runner start 或 stalled before first model call (last phase: context-engine)。這些看門狗程序覆蓋了嵌入式提供者和支援 CLI 的提供者，在其外部 CLI 實際程序啟動之前，並且與長 timeoutSeconds 值分開設置上限，以便冷啟動/驗證/上下文失敗能快速顯示，而不是等待完整的作業預算。
• 如果您使用系統 cron 或其他外部排程器來執行 openclaw agent，請用強制終止的升級處理來包裝它，即使 CLI 處理了 SIGTERM/SIGINT。由 Gateway 支援的執行會請 Gateway 中止已接受的執行；本地和嵌入式備用執行會收到相同的中止訊號。對於 GNU timeout，比起單純的 timeout 600 ... 更傾向使用 timeout -k 60 600 openclaw agent ...；如果程序無法排空，-k 值是監督者的最後防線。對於 systemd 單元，請透過使用 SIGTERM 停止訊號加上緩衝視窗（例如 TimeoutStopSec）來保持相同的結構，然後再進行最終終止。如果重試在原始 Gateway 執行仍處於活動狀態時重用了 --run-id，則重複項會被報告為進行中，而不是啟動第二次執行。

Note

Cron 的任務協調首先由 runtime 所有，其次由持久化歷史記錄支援：只要 cron runtime 仍將該作業追蹤為正在執行，活動的 cron 任務就會保持活躍，即使舊的子會話行仍然存在。一旦 runtime 停止擁有該作業且 5 分鐘的緩衝視窗過期，維護程序就會檢查匹配 `cron:

:

執行的持久化執行日誌和作業狀態。如果該持久化歷史記錄顯示終止結果，則任務分類帳將據此完成；否則，Gateway 擁有的維護程序可以將任務標記為lost`。離線 CLI 審計可以從持久化歷史記錄中恢復，但它不會將其自身空的進程中活動作業集視為 Gateway 擁有的 cron 執行已消失的證明。

排程類型

種類	CLI 標誌	描述
at	--at	一次性時間戳（ISO 8601 或類似 20m 的相對時間）
every	--every	固定間隔
cron	--cron	5 欄位或 6 欄位 cron 表達式，帶可選的 --tz

未指定時區的時間戳會被視為 UTC。加入 --tz America/New_York 以進行本地牆上時鐘排程。

循環的整點表達式會自動分散最多 5 分鐘以減少負載尖峰。使用 --exact 強制精確時間，或使用 --stagger 30s 指定明確的時間範圍。

月份中的日期與星期幾使用 OR 邏輯

Cron 表達式由 croner 解析。當月份中的日期和星期幾這兩個欄位皆非萬用字元時，croner 會在 任一 欄位匹配時觸發——而非兩者皆匹配。這是標準的 Vixie cron 行為。

# Intended: "9 AM on the 15th, only if it's a Monday"
# Actual:   "9 AM on every 15th, AND 9 AM on every Monday"
0 9 15 * 1

這會導致每月觸發約 5-6 次，而非 0-1 次。OpenClaw 此處使用 Croner 的預設 OR 行為。若需兩個條件同時成立，請使用 Croner 的 + 星期幾修飾符（0 9 15 * +1），或在其中一個欄位排程並在工作的提示或指令中守衛另一個條件。

執行樣式

樣式	--session 值	執行於	最適用於
主工作階段	main	專用 cron 喚醒通道	提醒、系統事件
隔離	isolated	專屬 cron:<jobId>	報表、背景雜務
目前工作階段	current	於建立時綁定	具備情境感知的週期性工作
自訂工作階段	session:custom-id	具名的持久工作階段	基於歷史記錄的工作流程

主會話與獨立與自訂

主會話 (Main session) 工作會將系統事件加入 cron 擁有的執行通道中，並選擇性地喚醒心跳 (--wake now 或 --wake next-heartbeat)。它們可以使用目標主會話的最後傳送內容作為回覆，但不會將例行的 cron 回合附加至人工聊天通道，也不會延長目標會話的每日/閒置重置新鮮度。獨立 (Isolated) 工作會以全新會話執行專屬的代理程式回合。自訂會話 (session:xxx) 則在多次執行間保留內容，實現像是基於先前摘要的每日站會之類的工作流程。

主會話 cron 事件是獨立的系統事件提醒。它們並不會自動包含預設心跳提示中的「閱讀 HEARTBEAT.md」指令。如果週期性提醒應參閱 HEARTBEAT.md，請在 cron 事件文字或代理程式自身的指令中明確說明。

「全新會話」對獨立工作的意義

對於獨立工作，「全新會話」意指每次執行都使用新的逐字稿/會話 ID。OpenClaw 可能會帶入安全的偏好設定，例如思考/快速/詳細設定、標籤，以及使用者明確選取的模型/驗證覆寫，但它不會繼承舊有 cron 記錄的周圍對話內容：頻道/群組路由、傳送或佇列政策、提權、來源，或 ACP 執行時期繫結。當週期性工作應刻意基於相同的對話內容時，請使用 current 或 `session:

`。

執行階段清理

對於獨立工作，執行階段拆解現在包含對該 cron 會話的盡力而為 (best-effort) 瀏覽器清理。清理失敗會被忽略，因此實際的 cron 結果仍會優先採用。

獨立 cron 執行也會透過共用的執行階段清理路徑，釋放為該工作建立的任何隨附 MCP 執行階段執行個體。這與主會話和自訂會話 MCP 用戶端的拆解方式一致，因此獨立 cron 工作不會在執行之間洩漏 stdio 子程序或長期存在的 MCP 連線。

Subagent and Discord delivery

當獨立的 cron 執行協調子代理時，傳遞也會優先使用最終的後代輸出，而非陳舊的父代暫時性文字。如果後代仍在運行，OpenClaw 會隱藏該部分父代更新，而不是發布它。

對於僅限文字的 Discord 公告目標，OpenClaw 只會發送一次標準的最終助理文字，而不是重播串流/中間文字承載和最終答案。媒體和結構化 Discord 承載仍會作為單獨的承載傳遞，以確保附件和元件不會遺失。

隔離任務的 Payload 選項

提示詞文字（隔離作業所需）。 模型覆寫；使用為該作業選取的允許模型。 思考層級覆寫。 略過工作區引導檔案注入。 限制作業可使用的工具，例如 `--tools exec,read`。

--model 會將選取的允許模型用作該作業的主要模型。這與聊天工作階段的 /model 覆寫不同：當作業主要模型失敗時，設定的後援鏈仍然會生效。如果請求的模型不被允許或無法解析，cron 會失敗並顯示明確的驗證錯誤，而不是自動靜默地回退至作業的 agent/預設模型選擇。

Cron 作業也可以攜帶層級的 fallbacks。當存在時，該列表會取代作業的已設定後援鏈。當您想要嚴格的 cron 執行，且僅嘗試選取的模型時，請在作業 payload/API 中使用 fallbacks: []。如果作業有 --model 但既無 payload 也無已設定的後援，OpenClaw 會傳遞明確的空後援覆寫，以免 agent 主要模型被附加為隱藏的額外重試目標。

本地提供者的飛行前檢查會在將 cron 執行標記為 skipped 之前檢查已設定的後援；fallbacks: [] 會使該飛行前路徑保持嚴格。

隔離任務的模型選擇優先順序為：

1. Gmail hook 模型覆寫（當運行來自 Gmail 且允許該覆寫時）
2. 各作業的 payload model
3. 使用者選擇的已儲存 cron 會話模型覆寫
4. Agent/預設模型選擇

快速模式也會遵循解析後的即時選擇。如果選取的模型配置具有 params.fastMode，隔離的 cron 預設會使用該選項。無論在哪個方向，已儲存的工作階段 fastMode 覆寫仍然優先於配置。

如果隔離運行遇到即時模型切換交接，cron 會使用切換後的提供商/模型進行重試，並在重試之前將該即時選擇持久化給活動運行。當切換還攜帶新的 auth profile 時，cron 也會為活動運行持久化該 auth profile 覆寫。重試是有界的：在初始嘗試加上 2 次切換重試後，cron 會中止而不是無限循環。

在獨立的 cron 執行進入代理執行器之前，OpenClaw 會檢查可達到的本地供應商端點，對於已配置的 api: "ollama" 和 api: "openai-completions" 供應商，其 baseUrl 為 loopback、private-network 或 .local。如果該端點關閉，執行將被記錄為 skipped，並附上清楚的供應商/模型錯誤，而不是啟動模型呼叫。端點結果會快取 5 分鐘，因此許多使用同一個已停機本地 Ollama、vLLM、SGLang 或 LM Studio 伺服器的到期任務將共用一個小型探測，而不是造成請求風暴。跳過的供應商預檢執行不會增加執行錯誤的退避時間；當您希望重複收到跳過通知時，請啟用 failureAlert.includeSkipped。

傳遞與輸出

模式	發生情況
announce	如果代理未發送，則將最終文字後備傳遞至目標
webhook	將完成事件負載 POST 至 URL
none	無執行器後備傳遞

使用 --announce --channel telegram --to "-1001234567890" 進行頻道傳遞。對於 Telegram 論壇主題，請使用 -1001234567890:topic:123；OpenClaw 也接受 Telegram 擁有的 -1001234567890:123 簡寫。直接 RPC/config 呼叫者可以將 delivery.threadId 作為字串或數字傳遞。Slack/Discord/Mattermost 目標應使用明確的前綴（channel:<id>、user:<id>）。Matrix 房間 ID 區分大小寫；請使用 Matrix 提供的確切房間 ID 或 room:!room:server 格式。

當公告傳遞使用 channel: "last" 或省略 channel 時，諸如 telegram:123 這類提供者前綴的目標可以在 cron 回退到會話歷史或單一配置通道之前選擇通道。只有已載入插件廣告的前綴才是提供者選擇器。如果 delivery.channel 是明確指定的，目標前綴必須指定同一個提供者；例如，channel: "whatsapp" 搭配 to: "telegram:123" 會被拒絕，而不是讓 WhatsApp 將 Telegram ID 解釋為電話號碼。目標類型和服務前綴，例如 channel:<id>、user:<id>、imessage:<handle> 和 sms:<number>，仍然是通道擁有的目標語法，而非提供者選擇器。

對於隔離作業，聊天傳遞是共享的。如果有聊天路由可用，即使作業使用 --no-deliver，Agent 也可以使用 message 工具。如果 Agent 發送到配置/當前目標，OpenClaw 會跳過回退公告。否則 announce、webhook 和 none 僅控制 Runner 對 Agent 輪次後最終回覆的處理方式。

當代理程式從作用中的聊天建立隔離提醒時，OpenClaw 會將保留的即時傳遞目標儲存為回退公告路由。內部工作階段金鑰可能是小寫；當目前的聊天內容可用時，提供者傳遞目標不會從這些金鑰重建。

隱式公告傳遞使用配置的通道允許清單來驗證並重新路由過時的目標。DM 配對存儲中的核准並非回退自動化的接收者；當排程作業應主動發送到 DM 時，請設定 delivery.to 或配置通道 allowFrom 條目。

輸出語言

Cron 工作不會從頻道、地區設定或先前的訊息中推斷回覆語言。請將語言規則放入排程訊息或範本中：

openclaw cron edit <jobId> \
  --message "Summarize the updates. Respond in Chinese; keep URLs, code, and product names unchanged."

對於模板檔案，請將語言指令保留在渲染後的提示中，並在作業運行前驗證諸如 {{language}} 的佔位符是否已填充。如果輸出混合了語言，請將規則設為明確，例如：「敘述性文字使用中文，技術術語保留英文」。

失敗通知遵循獨立的目的地路徑：

• cron.failureDestination 為失敗通知設定全域預設值。
• job.delivery.failureDestination 會針對每個作業覆蓋該設定。
• 如果兩者均未設定，且作業已透過 announce 進行傳遞，失敗通知現在會回退到該主要公告目標。
• delivery.failureDestination 僅在 sessionTarget="isolated" 任務上支援，除非主要傳遞模式為 webhook。
• failureAlert.includeSkipped: true 讓任務或全域 cron 警報原則加入重複跳過執行的警報。跳過的執行會維護獨立的連續跳過計數器，因此不會影響執行錯誤的退避。

CLI 範例

單次提醒週期性獨立作業模型與思考覆寫Webhook 輸出

bash openclaw cron add \ --name "Calendar check" \ --at "20m" \ --session main \ --system-event "Next heartbeat: check calendar." \ --wake now

bash openclaw cron create "0 7 * * *" \ "Summarize overnight updates." \ --name "Morning brief" \ --tz "America/Los_Angeles" \ --session isolated \ --announce \ --channel slack \ --to "channel:C1234567890"

bash openclaw cron add \ --name "Deep analysis" \ --cron "0 6 * * 1" \ --tz "America/Los_Angeles" \ --session isolated \ --message "Weekly deep analysis of project progress." \ --model "opus" \ --thinking high \ --announce

bash openclaw cron create "0 18 * * 1-5" \ "Summarize today's deploys as JSON." \ --name "Deploy digest" \ --webhook "https://example.invalid/openclaw/cron"

Webhooks

Gateway 可以公開 HTTP webhook 端點以供外部觸發。在設定中啟用：

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
  },
}

驗證

每個請求必須透過標頭包含 hook token：

• Authorization: Bearer <token> (推薦)
• x-openclaw-token: <token>

查詢字串 token 將被拒絕。

POST /hooks/wake

將系統事件加入主工作階段的佇列：

curl -X POST http://127.0.0.1:18789/hooks/wake \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"text":"New email received","mode":"now"}'

事件描述。

now 或 next-heartbeat。

POST /hooks/agent

執行一個獨立的代理程式輪次：

curl -X POST http://127.0.0.1:18789/hooks/agent \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"message":"Summarize inbox","name":"Email","model":"openai/gpt-5.4"}'

欄位：message (必要)、name、agentId、wakeMode、deliver、channel、to、model、fallbacks、thinking、timeoutSeconds。

Mapped hooks (POST /hooks/<name>)

自訂 hook 名稱是透過組態中的 hooks.mappings 進行解析。對應可以使用範本或程式碼轉換，將任意 payload 轉換為 wake 或 agent 動作。

Warning

請將 Hook 端點置於 loopback、tailnet 或受信任的反向代理之後。

• 使用專用的 Hook token；不要重複使用 Gateway auth token。
• 將 hooks.path 保持在專用的子路徑上；/ 會被拒絕。
• 設定 hooks.allowedAgentIds 以限制 Hook 可以鎖定的有效代理程式（effective agent），包括省略 agentId 時的預設代理程式。
• 除非您需要由呼叫者選擇的 session，否則請保持 hooks.allowRequestSessionKey=false。
• 如果您啟用 hooks.allowRequestSessionKey，請同時設定 hooks.allowedSessionKeyPrefixes 以限制允許的 session key 形狀。
• Hook payload 預設會以安全邊界包裝。

Gmail PubSub 整合

透過 Google PubSub 將 Gmail 收件匣觸發程序連線至 OpenClaw。

Note

先決條件：

gcloud

CLI、

gog

(gogcli)、已啟用 OpenClaw hooks、用於公開 HTTPS 端點的 Tailscale。

精靈設定（推薦）

openclaw webhooks gmail setup --account [email protected]

這會寫入 hooks.gmail 設定，啟用 Gmail 預設集，並使用 Tailscale Funnel 作為推送端點。

Gateway 自動啟動

當設定 hooks.enabled=true 和 hooks.gmail.account 時，Gateway 會在開機時啟動 gog gmail watch serve 並自動續期監看。設定 OPENCLAW_SKIP_GMAIL_WATCHER=1 以退出此行為。

手動一次性設定

1. 選擇 GCP 專案

   選擇擁有 gog 所使用 OAuth 用戶端的 GCP 專案：

   gcloud auth login
   gcloud config set project

   gcloud services enable gmail.googleapis.com pubsub.googleapis.com

2. 建立主題並授予 Gmail 推送存取權

   gcloud pubsub topics create gog-gmail-watch
   gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
     --member=serviceAccount:[email protected] \
     --role=roles/pubsub.publisher

3. 啟動監聽

   gog gmail watch start \
     --account [email protected] \
     --label INBOX \
     --topic projects/

   /topics/gog-gmail-watch ```

Gmail 模型覆蓋

{
  hooks: {
    gmail: {
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}

管理工作

# List all jobs
openclaw cron list

# Get one stored job as JSON
openclaw cron get <jobId>

# Show one job, including resolved delivery route
openclaw cron show <jobId>

# Edit a job
openclaw cron edit <jobId> --message "Updated prompt" --model "opus"

# Force run a job now
openclaw cron run <jobId>

# Force run a job now and wait for its terminal status
openclaw cron run <jobId> --wait --wait-timeout 10m --poll-interval 2s

# Run only if due
openclaw cron run <jobId> --due

# View run history
openclaw cron runs --id <jobId> --limit 50

# View one exact run
openclaw cron runs --id <jobId> --run-id <runId>

# Delete a job
openclaw cron remove <jobId>

# Agent selection (multi-agent setups)
openclaw cron create "0 6 * * *" "Check ops queue" --name "Ops sweep" --session isolated --agent ops
openclaw cron edit <jobId> --clear-agent

openclaw cron run <jobId> 會在將手動執行加入佇列後返回。對於必須等到佇列執行完成才能繼續的 shutdown hook、維護腳本或其他自動化操作，請使用 --wait。等待模式會輪詢確切返回的 runId；如果狀態為 ok 則以 0 退出，如果是 error、skipped 或等待逾時，則以非零值退出。

openclaw cron create 是 openclaw cron add 的別名，新的作業可以使用位置排程（"0 9 * * 1"、"every 1h"、"20m" 或 ISO 時間戳記），後面接著位置的 Agent 提示。在 cron add|create 或 cron edit 上使用 --webhook <url>，將完成的執行負載 POST 到 HTTP 端點。Webhook 傳送不能與聊天傳送標誌（例如 --announce、--channel、--to、--thread-id 或 --account）結合使用。

Note

模型覆寫說明：

• openclaw cron add|edit --model ... 會變更作業的選取模型。
• 如果允許該模型，則該特定的提供者/模型會到達獨立的 Agent 執行。
• 如果不允許或無法解析，cron 會以明確的驗證錯誤使執行失敗。
• 設定的備援鏈仍然適用，因為 cron --model 是作業主要設定，而不是工作階段 /model 覆寫。
• 負載 fallbacks 會取代該作業的設定備援；fallbacks: [] 會停用備援並使執行變為嚴格模式。
• 沒有明確或設定備援清單的純 --model，不會將 Agent 主要設定作為無聲的額外重試目標。

設定

{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 8,
    retry: {
      maxAttempts: 3,
      backoffMs: [60000, 120000, 300000],
      retryOn: ["rate_limit", "overloaded", "network", "server_error"],
    },
    webhookToken: "replace-with-dedicated-webhook-token",
    sessionRetention: "24h",
    runLog: { maxBytes: "2mb", keepLines: 2000 },
  },
}

maxConcurrentRuns 同時限制了預定的 cron 排程和獨立的 Agent 回合執行，預設值為 8。獨立的 cron Agent 回合會在內部使用佇列專用的 cron-nested 執行通道，因此提高此數值可讓獨立的 cron LLM 執行並行進行，而不僅僅是啟動其外部 cron 包裝器。共享的非 cron nested 通道不會由此設定擴充。

cron.store 是邏輯儲存區金鑰和舊版 doctor 匯入路徑。執行 openclaw doctor --fix 將現有的 JSON 儲存區匯入 SQLite 並進行封存；未來的 cron 變更應透過 CLI 或 Gateway API 進行。

停用 cron：cron.enabled: false 或 OPENCLAW_SKIP_CRON=1。

重試行為

一次性重試：暫時性錯誤（速率限制、過載、網路、伺服器錯誤）會以指數退避重試最多 3 次。永久性錯誤會立即停用。

週期性重試：重試之間使用指數退避（30 秒到 60 分鐘）。下次成功執行後退避會重置。

維護

cron.sessionRetention (預設 24h) 會修剪獨立的執行階段項目。cron.runLog.keepLines 限制每個工作保留的 SQLite 執行歷史記錄列數；maxBytes 則是為了與較舊的檔案支援執行日誌進行設定相容性而保留。

故障排除

命令階梯

openclaw status
openclaw gateway status
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
openclaw doctor

Cron 未觸發

• 檢查 cron.enabled 和 OPENCLAW_SKIP_CRON 環境變數。
• 確認 Gateway 持續在執行中。
• 針對 cron 排程，請驗證時區 (--tz) 與主機時區是否一致。
• 執行輸出中的 reason: not-due 表示已使用 `openclaw cron run

—due` 檢查手動執行，且該工作尚未到期。

Cron 已觸發但未傳送

• 傳送模式 none 表示預期不會有執行器回退傳送。當可用聊天路由時，Agent 仍可使用 message 工具直接傳送。
• 傳送目標遺失/無效 (channel/to) 表示已略過傳出傳送。
• 對於 Matrix，複製或舊版工作若使用小寫的 delivery.to 房間 ID 可能會失敗，因為 Matrix 房間 ID 有大小寫之分。請將工作編輯為來自 Matrix 的確切 !room:server 或 room:!room:server 值。
• 頻道驗證錯誤 (unauthorized, Forbidden) 表示傳送遭憑證阻擋。
• 如果獨立執行僅返回靜默符記 (NO_REPLY / no_reply)，OpenClaw 會抑制直接傳出傳送，並抑制回退佇列摘要路徑，因此不會發布任何內容回聊天。
• 如果 Agent 應自行傳送訊息給使用者，請檢查工作是否有可用的路由 (channel: "last" 搭配先前的聊天，或明確的頻道/目標)。

Cron or heartbeat appears to prevent /new-style rollover

• 每日和空閒重置的新鮮度並非基於 updatedAt；請參閱會話管理。
• Cron 喚醒、heartbeat 執行、exec 通知以及 gateway 簿記可能會更新會話行以進行路由/狀態處理，但它們不會延長 sessionStartedAt 或 lastInteractionAt。
• 對於在這些欄位存在之前建立的舊版行，當檔案仍然可用時，OpenClaw 可以從逐字稿 JSONL 會話標頭還原 sessionStartedAt。沒有 lastInteractionAt 的舊版空閒行會使用該還原的開始時間作為其空閒基準。

Timezone gotchas

• 沒有 --tz 的 Cron 使用 gateway 主機時區。
• 沒有時區的 at 排程會被視為 UTC。
• Heartbeat activeHours 使用已配置的時區解析方式。

相關

• 自動化 — 所有自動化機制一覽
• 背景任務 — cron 執行的任務分類帳
• Heartbeat — 週期性主會話輪次
• 時區 — 時區配置