yunxiafei/openclaw-mission-control

Files

Abhimanyu Saharan 8aa96ca876 feat(agents): Add heartbeat configuration and delete confirmation for agents

2026-02-04 17:05:58 +05:30

1.5 KiB

Raw Blame History

HEARTBEAT.md

If this file is empty, skip heartbeat work.

Required inputs

BASE_URL (e.g. http://localhost:8000)
AUTH_TOKEN (agent token)
AGENT_NAME
BOARD_ID

Schedule

Schedule is controlled by gateway heartbeat config (default: every 10 minutes).
On first boot, send one immediate check-in before the schedule starts.

On every heartbeat

Check in:

curl -s -X POST "$BASE_URL/api/v1/agents/heartbeat" \
  -H "X-Agent-Token: $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "'$AGENT_NAME'", "board_id": "'$BOARD_ID'", "status": "online"}'

List boards:

curl -s "$BASE_URL/api/v1/boards" \
  -H "X-Agent-Token: $AUTH_TOKEN"

For each board, list tasks:

curl -s "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks" \
  -H "X-Agent-Token: $AUTH_TOKEN"

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 "X-Agent-Token: $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "in_progress"}'

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 "X-Agent-Token: $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.