- 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-pulseStep 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.jsonStep 3: Push stats
clawpulse pushThis 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