| name | heartbeat |
| description | Use during Manager patrol to inspect room bindings, Worker health, RuntimeLeases, and active tasks. |
Heartbeat
Heartbeat is quiet patrol. It should not spam rooms.
Inspect
state.json
rooms.json
workers-registry.json
- Controller Worker runtime diagnostics
- active runs, tasks, RuntimeLeases, and task rooms
Commands
agenthub schema
agenthub heartbeat --workspace <workspace-id>
agenthub apply -f manager.yaml
Manager Manifest
kind: Manager
metadata:
name: global
spec:
runtimeType: openclaw
desiredState: observed
controllerUrl: <controller-url>
matrixServerName: agenthub.local
Health Fields
lastHeartbeatAt
lastMatrixSyncAt
lastRuntimeReadyAt
lastTaskStartedAt
lastTaskCompletedAt
lastError
queueDepth
Decision Pattern
agenthub schema to inspect managers.reconcile, heartbeat.manager, and apply.manifest.
- Compare expected rooms and Workers with Controller status.
- Refresh Manager mirrors with
agenthub apply -f manager.yaml if local registries are stale.
- Detect stale bindings, stale leases, failed runtimes, and waiting approvals.
- Use
error-recovery when action is needed.
- Stay quiet when healthy.