ClawHQ Dashboard Connector
Report agent status, heartbeats, and task completions to your ClawHQ dashboard.
Requirements
Environment variable must be set:
CLAWHQ_API_KEY— Your ClawHQ API key (generate in Settings → API Keys)
Behavior
On Session Start
Report status "working" with the current task:
Windows (PowerShell):
$headers = @{ "Authorization" = "Bearer $env:CLAWHQ_API_KEY"; "Content-Type" = "application/json" }
$body = @{ agent = "<agent_name>"; status = "working"; task = "<current task summary>" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://app.clawhq.co/api/agents/report" -Method Post -Headers $headers -Body $body
Mac/Linux (curl):
curl -s -X POST "https://app.clawhq.co/api/agents/report" \
-H "Authorization: Bearer $CLAWHQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent":"<agent_name>","status":"working","task":"<current task summary>"}'
On Session End
Report status "idle":
Windows:
$headers = @{ "Authorization" = "Bearer $env:CLAWHQ_API_KEY"; "Content-Type" = "application/json" }
$body = @{ agent = "<agent_name>"; status = "idle" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://app.clawhq.co/api/agents/report" -Method Post -Headers $headers -Body $body
Mac/Linux:
curl -s -X POST "https://app.clawhq.co/api/agents/report" \
-H "Authorization: Bearer $CLAWHQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent":"<agent_name>","status":"idle"}'
On Heartbeat
Post a heartbeat to keep the dashboard current. Use the same commands above with "status":"heartbeat".
Notes
- All calls should be fire-and-forget — wrap in try/catch so failures never block the agent.
- Replace
<agent_name>with the agent's name (e.g. "Eros", "Atlas"). - The API auto-creates agents on first report — no setup needed in the dashboard.