Files
openclaw-mission-control/templates/HEARTBEAT.md
Abhimanyu Saharan 7fd079e4f1 feat(agents): Move templates into dedicated folder
Provisioning now reads template files from templates/ and includes the\nbase URL for agent runtime setup. Remove unused root orchestration\ndocs to keep the repo tidy.\n\nCo-Authored-By: Claude <noreply@anthropic.com>
2026-02-04 03:46:46 +05:30

1.4 KiB

HEARTBEAT.md

If this file is empty, skip heartbeat work.

Required inputs

On every heartbeat

  1. Check in:
curl -s -X POST "$BASE_URL/api/v1/agents/heartbeat" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "'$AGENT_NAME'", "status": "online"}'
  1. List boards:
curl -s "$BASE_URL/api/v1/boards" \
  -H "Authorization: Bearer $AUTH_TOKEN"
  1. For each board, list tasks:
curl -s "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks" \
  -H "Authorization: Bearer $AUTH_TOKEN"
  1. Claim next task (FIFO):
  • Find the oldest task with status "inbox" across all boards.
  • Claim it by moving it to "in_progress":
curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "in_progress"}'
  1. Work the task:
  • Update status as you progress.
  • When complete, move to "review":
curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "review"}'

Status flow

inbox -> in_progress -> review -> done

Do not say HEARTBEAT_OK if there is inbox work or active in_progress work.