ClawPulse

---

name: clawpulse description: Connect your OpenClaw agent to ClawPulse - the community analytics dashboard. Automatically collects and pushes aggregate token stats (no message content) to clawpulse.vercel.app. See your dashboard, compare with the community, and track the pulse of OpenClaw. metadata: openclaw: requires: bins: ["node", "npx"]

---

ClawPulse - Community Analytics for OpenClaw

Connect your agent to the OpenClaw community dashboard at https://clawpulse.vercel.app

Setup (Agent does this automatically)

Step 1: Install CLI

npm install -g openclaw-pulse

Step 2: Authenticate

The agent needs a GitHub token to push stats. Two options:

Option A: User runs clawpulse setup in their terminal This opens a GitHub device flow - user enters a code at github.com/login/device.

Option B: Agent uses existing GitHub token If the user has gh CLI authenticated, extract the token:

TOKEN=$(gh auth token)
mkdir -p ~/.clawpulse
echo "{\"apiUrl\":\"https://clawpulse.vercel.app\",\"githubToken\":\"$TOKEN\"}" > ~/.clawpulse/config.json

Step 3: Push stats

clawpulse push

This collects session stats from ~/.openclaw/agents/main/sessions/*.jsonl and pushes aggregate numbers to the ClawPulse API. No message content is ever collected.

Step 4: Set up auto-push via OpenClaw cron

Create TWO cron jobs for auto-push at midnight and noon:

{
  "name": "ClawPulse Push (midnight)",
  "schedule": { "kind": "cron", "expr": "0 0 * * *" },
  "payload": { "kind": "agentTurn", "message": "Run: clawpulse push --silent" },
  "sessionTarget": "isolated",
  "delivery": { "mode": "none" }
}

{
  "name": "ClawPulse Push (noon)",
  "schedule": { "kind": "cron", "expr": "0 12 * * *" },
  "payload": { "kind": "agentTurn", "message": "Run: clawpulse push --silent" },
  "sessionTarget": "isolated",
  "delivery": { "mode": "none" }
}

What Gets Collected (Privacy)

Only aggregate numbers per day:

Token counts (input, output, cache read, cache write)

Model names and usage counts

Tool names and usage counts

Cost estimates (at API rates)

Message counts

Session counts

Never collected: message content, file paths, tool arguments, personal data.

Commands

| Command | What it does | |---------|-------------| | clawpulse setup | Interactive: login + push + show instructions | | clawpulse push | Collect and push stats | | clawpulse push --silent | Same but no output (for cron) | | clawpulse collect | Just collect stats locally | | clawpulse status | Show stats summary | | clawpulse login | Re-authenticate with GitHub |

Dashboard

Personal: https://clawpulse.vercel.app/dashboard (after login)

Community: https://clawpulse.vercel.app

Leaderboard: https://clawpulse.vercel.app/community

Source

npm: https://www.npmjs.com/package/openclaw-pulse

GitHub: https://github.com/pierreeurope/clawpulse