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
CODEBLOCK0
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:
CODEBLOCK1
Step 3: Push stats
CODEBLOCK2
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:
CODEBLOCK3
CODEBLOCK4
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 |
|---|
| INLINECODE3 | Interactive: login + push + show instructions |
| INLINECODE4 |
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
ClawPulse - OpenClaw社区分析工具
将您的代理连接到OpenClaw社区仪表板：https://clawpulse.vercel.app
设置（代理会自动完成）
步骤1：安装CLI
bash
npm install -g openclaw-pulse
步骤2：身份验证
代理需要一个GitHub令牌来推送统计数据。两种选择：
选项A：用户在终端中运行 clawpulse setup
这将打开GitHub设备流程——用户在github.com/login/device输入代码。
选项B：代理使用现有的GitHub令牌
如果用户已通过 gh CLI完成身份验证，提取令牌：
bash
TOKEN=$(gh auth token)
mkdir -p ~/.clawpulse
echo {\apiUrl\:\https://clawpulse.vercel.app\,\githubToken\:\$TOKEN\} > ~/.clawpulse/config.json
步骤3：推送统计数据
bash
clawpulse push
这将从 ~/.openclaw/agents/main/sessions/*.jsonl 收集会话统计数据，并将汇总数据推送到ClawPulse API。不会收集任何消息内容。
步骤4：通过OpenClaw定时任务设置自动推送
创建两个定时任务，分别在午夜和中午自动推送：
json
{
name: ClawPulse推送（午夜）,
schedule: { kind: cron, expr: 0 0 * },
payload: { kind: agentTurn, message: 运行：clawpulse push --silent },
sessionTarget: isolated,
delivery: { mode: none }
}
json
{
name: ClawPulse推送（中午）,
schedule: { kind: cron, expr: 0 12 * },
payload: { kind: agentTurn, message: 运行：clawpulse push --silent },
sessionTarget: isolated,
delivery: { mode: none }
}
收集内容（隐私保护）
仅收集每日汇总数据：
- - Token数量（输入、输出、缓存读取、缓存写入）
- 模型名称及使用次数
- 工具名称及使用次数
- 成本估算（按API费率计算）
- 消息数量
- 会话数量
绝不收集： 消息内容、文件路径、工具参数、个人数据。
命令
| 命令 | 功能说明 |
|---|
| clawpulse setup | 交互式：登录 + 推送 + 显示说明 |
| clawpulse push |
收集并推送统计数据 |
| clawpulse push --silent | 同上但无输出（用于定时任务） |
| clawpulse collect | 仅在本地收集统计数据 |
| clawpulse status | 显示统计数据摘要 |
| clawpulse login | 重新进行GitHub身份验证 |
仪表板
- - 个人： https://clawpulse.vercel.app/dashboard（登录后）
- 社区： https://clawpulse.vercel.app
- 排行榜： https://clawpulse.vercel.app/community
源码
- - npm：https://www.npmjs.com/package/openclaw-pulse
- GitHub：https://github.com/pierreeurope/clawpulse
