2026 OpenClaw Cron 排程指令詳解：定時任務設定、管理與疑難排解完整問答
本文說明：OpenClaw 的 cron 指令讓你的 AI 助手可以按時自動執行任務——例如每天早上 8 點發送晨間報告、每小時檢查信箱、每週一彙整工作記錄。本文完整解析 cron 的每個子命令，同時涵蓋 hooks、sandbox、dns、docs 等相關指令。
Cron 基礎概念
Q1 OpenClaw 的 cron 功能是什麼？
A：OpenClaw 的 cron 是內建的排程系統，讓你的 AI 助手可以在特定時間自動執行任務。與傳統 cron job 不同，OpenClaw 的 cron 任務可以透過 Gateway RPC 動態新增、修改、啟停，不需要重啟 Gateway。觸發時可以發送訊息給 AI（讓它執行複雜任務）或觸發系統事件（輕量級通知）。
Q2 Cron 指令需要 Gateway 運行才能使用嗎？
A：是的，所有 cron 子命令都是透過 Gateway RPC 執行的，需要 Gateway 正在運行。如果 Gateway 停止，排程任務也不會觸發。因此建議：
- 安裝 Gateway 為系統服務（
openclaw gateway install） - 確保 Gateway 連線穩定（搭配 VPN07）
- 定期用
openclaw health確認 Gateway 健康
Q3 Cron 的 payload 是什麼？--system-event 和 --message 有什麼差別？
A：每個 cron 任務觸發時必須做一件事（payload），有兩種選擇：
--message "文字內容"
將訊息發送給 AI 代理，讓它執行複雜任務（如「整理今天的郵件」、「產生每日報告」）。AI 會完整回應，適合需要智能處理的任務。
--system-event "文字內容"
觸發輕量系統事件，不會讓 AI 做完整回應，適合簡單通知或觸發 Webhook。消耗的 API 額度遠少於 message。
cron status 與 cron list 詳解
Q4 openclaw cron status 顯示什麼？
A：cron status 顯示排程系統的整體狀態，包括：總任務數量、已啟用/停用任務數、下一個觸發時間、最後執行時間和結果。是快速確認 cron 系統正常運作的第一步。
Q5 openclaw cron list 如何查看所有排程任務？
A：cron list 以表格形式列出所有已設定的排程任務，每行顯示任務 ID、名稱、觸發條件、啟用狀態。
cron add 詳細用法
Q6 openclaw cron add 必填參數是什麼？如何建立第一個排程？
A：cron add（別名 create）必須提供：① --name 任務名稱；② 觸發條件（三選一）；③ payload（二選一）。
Q7 --at、--every、--cron 三種觸發方式怎麼選？
--at "HH:MM" 或 --at "YYYY-MM-DD HH:MM"
指定具體時間觸發，每天固定時間執行。例如 --at "07:30" 表示每天早上 7:30。
--every "間隔"
固定間隔觸發，支援 30m（30分鐘）、1h（1小時）、2d（2天）等格式。適合定期輪詢任務。
--cron "標準 crontab 語法"
最靈活，使用傳統 crontab 五欄語法（分 時 日 月 週）。例如 "0 9 * * 1-5" 表示平日早上 9 點。
Q8 如何確認 cron add 成功了？新建的任務在哪裡查？
A：執行 cron add 後，系統會回傳任務 ID（格式如 cron_abc123）。然後用 openclaw cron list 可以看到新任務出現在列表中，或用 openclaw cron list --json 取得完整 JSON 資訊包含所有欄位。
cron edit、rm、enable、disable 詳解
Q9 openclaw cron edit 如何修改已建立的排程任務？
A：cron edit 允許你修改現有任務的欄位，不需要刪掉重建。只需提供任務 ID 和要修改的欄位即可：
注意：cron edit 是 patch 操作，只更新你指定的欄位，其他欄位保持不變。
Q10 openclaw cron rm 如何刪除排程任務？能復原嗎？
A：cron rm（別名 remove、delete）刪除任務，不可復原。建議在刪除前先用 cron disable 暫停，確認不再需要後再刪除。
Q11 cron enable 和 cron disable 與刪除有什麼差別？何時用？
A：停用（disable）是暫停任務，保留設定，隨時可重新啟用。刪除（rm）是永久移除。建議使用情境：
用 disable 的情境
外出旅行期間暫停晨間報告、測試新版本設定前先停用、季節性任務（如年度報告）
用 rm 的情境
任務功能已完全不需要、重新設計後需要完全重建
cron runs 與 cron run 詳解
Q12 openclaw cron runs 如何查看任務的歷史執行記錄？
A：cron runs 查看特定任務的歷史執行結果，幫助你判斷任務是否按時執行、有無錯誤。
每筆記錄包含：執行時間、執行狀態（success/error）、執行耗時。如果有錯誤，記錄中也會顯示錯誤訊息。
Q13 openclaw cron run 如何立即手動觸發某個任務？
A：cron run 讓你不等排程時間，立即手動執行一次任務，非常適合測試和緊急觸發。
Q14 Cron 任務一直沒有執行，如何診斷問題？
A：按照以下順序診斷：
步驟 1：確認 Gateway 在運行
步驟 2：確認任務已啟用
步驟 3：手動觸發測試
步驟 4：查看執行記錄找錯誤
步驟 5：查看 Gateway 日誌
hooks 指令詳解
Q15 OpenClaw 的 hooks 是什麼？和 cron 有什麼不同？
A：Hooks 是事件驅動的自動化機制，當特定事件發生時自動觸發（而不是按時間觸發）。例如：收到 Telegram 訊息時、AI 完成回應時、檔案變更時。Hooks 可以延伸 OpenClaw 的功能，讓系統對事件做出即時反應。
Q16 openclaw hooks 有哪些子命令？各自功能是什麼？
hooks list
列出所有可用的 hooks，顯示名稱、狀態、描述
hooks info <name>
顯示特定 hook 的詳細資訊，包括依賴需求和設定選項
hooks check
檢查 hooks 的就緒狀態（依賴是否滿足）
hooks enable / disable <name>
啟用或停用特定 hook
hooks install <name>
安裝 hook（下載並設定依賴）
hooks update <name>
更新已安裝的 hook 到最新版本
Q17 webhooks gmail setup 是什麼？如何設定 Gmail 即時通知？
A：webhooks gmail setup 設定 Gmail Pub/Sub 推送通知，讓 OpenClaw 在收到新郵件時立即收到通知並自動處理。需要 Google Cloud 帳號和相關設定。
sandbox、dns、docs 指令詳解
Q18 openclaw sandbox 指令是什麼？有哪些子命令？
A：Sandbox 是 OpenClaw 的隔離執行環境，讓 AI 代理在受控環境中執行 Shell 指令，不影響主機系統。適合執行有潛在風險的程式碼。
sandbox list
列出所有可用的 sandbox 環境
sandbox recreate
重新建立 sandbox 環境（清空後重建），用於重置污染的環境
sandbox explain
解釋 sandbox 的設定和目前狀態，了解安全邊界
Q19 openclaw dns setup 是做什麼的？
A：dns setup 設定廣域發現 DNS（搭配 CoreDNS + Tailscale），讓多台機器上的 OpenClaw 節點能互相發現。這是多節點部署的重要設定。
Q20 openclaw docs 如何搜尋官方文件？
A：openclaw docs [搜尋詞] 會在即時文件索引中搜尋，直接從終端機查詢文件，不需要開瀏覽器。例如：
Q21 system event、system heartbeat 和 system presence 有什麼用？
openclaw system event --text "文字"
手動觸發一個系統事件並放入 Gateway 事件佇列，可選擇同時觸發 heartbeat
openclaw system heartbeat last/enable/disable
控制 AI 助手的心跳功能——OpenClaw 會定期主動聯繫你（問候、提醒、分享資訊）
openclaw system presence
列出系統在線狀態記錄，顯示 AI 助手的活動歷程
Cron 實戰應用案例
📅 每日自動化
- • 早上 7:30 晨間報告（天氣+日程）
- • 中午 12:00 未讀郵件摘要
- • 晚上 22:00 今日工作總結
- • 每週一 9:00 本週工作規劃
⚙️ 系統監控
- • 每 30 分鐘檢查伺服器狀態
- • 每小時備份重要資料
- • 每天清理暫存檔案
- • 異常事件立即通知
💡 穩定執行 Cron 任務的關鍵
Cron 任務需要 Gateway 24 小時穩定連線。台灣用戶直連 Anthropic 的延遲可能導致任務逾時失敗。搭配 VPN07 的 1000Mbps 穩定頻寬，任務成功率從 73% 提升到 99.9%。月費只要 $1.5，十年穩定運營，30 天退款保證。