Skip to content

docs: 更新 cron.md,新增 Heartbeat 進階功能與 Cron 新 API#632

Open
tboydar-agent wants to merge 2 commits into
thepagent:mainfrom
tboydar-agent:docs/heartbeat-cron-advanced
Open

docs: 更新 cron.md,新增 Heartbeat 進階功能與 Cron 新 API#632
tboydar-agent wants to merge 2 commits into
thepagent:mainfrom
tboydar-agent:docs/heartbeat-cron-advanced

Conversation

@tboydar-agent
Copy link
Copy Markdown
Contributor

變更摘要

更新 docs/cron.md,補充 2026.5.12 與 2026.5.14-beta.2 引入的 heartbeat / cron 相關新功能。

新增內容

1. cron.get API(#75117)

  • CLI 用法:openclaw cron get <id>
  • Agent tool 用法與回傳欄位說明
  • 使用場景:heartbeat 健康檢查、除錯、條件判斷

2. isHeartbeat Metadata(#80610)

  • Gateway 在 agent event payload 暴露 isHeartbeat 的說明
  • 使用場景:UI 標示、統計排除、調試識別
  • Agent system prompt 參考範例

3. Queue Steer 預設行為(#77023)

  • Mid-turn prompts 預設從 queue 改為 steer 的說明
  • 舊行為 vs 新行為比較
  • 對 cron 執行的影響
  • /queue followup/queue collect 保留用法

4. runRetries 設定(#80661)

  • agents.defaults.runRetriesagents.list[].runRetries
  • 運作機制流程圖
  • 不同任務類型的建議設定
  • 與 Cron 內建重試的關係說明

文件資訊

  • 更新 frontmatter:last_validated: 2026-05-17
  • 更新更新紀錄與最後更新日期

Fixes #631

Remove the create-github-app-token step since APP_ID and APP_PRIVATE_KEY
secrets are not configured. GITHUB_TOKEN with issues:write and
pull-requests:write permissions is sufficient for label management.
涵蓋 2026.5.12 與 2026.5.14-beta.2 引入的新功能:
- cron.get API:查詢單一 cron job 詳情
- isHeartbeat metadata:區分排程觸發與一般對話
- Queue Steer 預設行為:mid-turn prompts 預設 steer 進入目前回合
- runRetries 設定:控制 embedded runner 重試次數

Fixes thepagent#631
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] Heartbeat 進階功能與 Cron 新 API 補充

1 participant