Skill: zachmael/clawhq-dashboard (version 1.0.1)

# 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.

path: package.json
content: {
  "name": "clawhq-dashboard",
  "version": "1.2.0",
  "description": "Report agent status to ClawHQ dashboard",
  "keywords": ["monitoring", "dashboard", "agents", "clawhq", "observability", "heartbeat"],
  "author": "ClawHQ <[REDACTED_SECRET]>",
  "license": "MIT",
  "homepage": "https://app.clawhq.co",
  "repository": {
    "type": "git",
    "url": "https://github.com/clawhq/clawhq-dashboard"
  },
  "openclaw": {
    "type": "skill",
    "category": "monitoring",
    "requiredEnv": ["CLAWHQ_API_KEY"],
    "runtime": "instruction-only"
  }
}


path: README.md
content: # ClawHQ Dashboard Reporter

Monitor your AI agents in real-time at [app.clawhq.co](https://app.clawhq.co).

## Quick Start

```bash
# 1. Get your API key from Settings → API Keys
# 2. Set env var
export CLAWHQ_API_KEY=chq_your_key_here

# 3. Install skill and you're done
```

## What Gets Reported

- Agent name & status (active, idle, error, offline)
- Current task description
- Heartbeat timestamps

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `CLAWHQ_API_KEY` | Yes | API key from ClawHQ Settings |


path: setup.md
content: # ClawHQ Dashboard Setup

## Quick Start

1. **Sign up** at [app.clawhq.co](https://app.clawhq.co)
2. Go to **Settings → API Keys → Generate**
3. Copy the key (you only see it once!)
4. Set the environment variable:
   ```
   CLAWHQ_API_KEY=chq_your_key_here
   ```
5. Install this skill
6. Done — your agents will appear on your dashboard

## Verify Connection

```bash
curl -X POST "https://app.clawhq.co/api/agents/report" \
  -H "Authorization: Bearer $CLAWHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent":"test","status":"idle"}'
```

Should return `{"ok":true}`.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)