# Clawhq Dashboard

> ClawHQ Dashboard Connector

- Skill: `johnalbertini14-glitch/clawhq-dashboard` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/clawhq-dashboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/clawhq-dashboard/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/johnalbertini14-glitch/clawhq-dashboard

---

# 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):**
```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):**
```bash
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:**
```powershell
$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:**
```bash
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.