如何設定 Heartbeat 讓 Agent 自動執行定期任務
寫程式最怕的就是要一直盯著系統狀態。有時候你只想讓系統每隔一段時間自動巡檢，而不是自己手動去觸發，或者寫一堆複雜的排程邏輯來管理這些瑣事。如果能直接用一個簡單的設定檔來搞定，開發體驗會好很多。
如果你正在尋找一種簡單的方法來讓 Agent 定期「醒來」巡視你的專案，HEARTBEAT.md 就是最直接的方案。
需要準備的東西
Section titled “需要準備的東西”- 你的專案開發環境
HEARTBEAT.md設定檔
要在專案中啟動或關閉定期檢查機制，只需操作一個檔案：
- 建立檔案：在專案根目錄建立一個名為
HEARTBEAT.md的檔案。 - 加入任務：在檔案中寫下你希望 Agent 定期執行的任務描述。
- 跳過檢查：如果你想停止所有 heartbeat API 呼叫，只需清空該檔案，或僅保留註解。
這是一個典型的 HEARTBEAT.md 範例：
# 這裡可以加入註解，Agent 會忽略這些內容# 加入下方任務讓 Agent 定期執行
檢查外部 API 串接狀態是否正常確認資料庫是否有異常 Log如果你暫時不需要 Agent 自動運作，只需確保檔案內容如下：
# 保持檔案空白或僅保留註解即可跳過 heartbeat API 呼叫如何停止不必要的 API 呼叫？
Section titled “如何停止不必要的 API 呼叫？”如果你的 API 額度消耗太快，或者不需要 Agent 持續檢查，請檢查你的 HEARTBEAT.md。只要將檔案內容清空，Agent 就會自動跳過 heartbeat 流程，不會產生額外的 API 請求。
任務沒有按預期執行？
Section titled “任務沒有按預期執行？”確保你的任務描述清晰。Agent 會根據你在 HEARTBEAT.md 中列出的文字來判斷需要檢查的內容。如果檔案完全不存在，Agent 可能會採取預設行為，建議明確建立該檔案來進行控管。
如果你在設定過程中遇到任何問題，可以直接詢問 AI Setup Assistant 獲取即時協助。
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。