Agent Skills › vivekchand/clawmetry › clawmetry

clawmetry

GitHub

ClawMetry是OpenClaw代理的可观测性平台，提供本地仪表板和可选的加密云端同步。支持实时监控成本、Token消耗、会话状态、工具调用及系统健康，便于调试与远程管理。

clawhub-plugin/skills/clawmetry/SKILL.md vivekchand/clawmetry

触发场景

查询代理运行成本或Token使用情况检查当前活跃会话或代理状态诊断系统健康度或进行故障排查查看工具调用的实时执行流程请求开启远程监控或云端同步功能

安装

npx skills add vivekchand/clawmetry --skill clawmetry -g -y

更多选项

非标准路径

npx skills add https://github.com/vivekchand/clawmetry/tree/main/clawhub-plugin/skills/clawmetry -g -y

不安装直接使用

npx skills use vivekchand/clawmetry@clawmetry

指定 Agent (Claude Code)

npx skills add vivekchand/clawmetry --skill clawmetry -a claude-code -g -y

安装 repo 全部 skill

npx skills add vivekchand/clawmetry --all -g -y

预览 repo 内 skill

npx skills add vivekchand/clawmetry --list

SKILL.md

Frontmatter

{
    "name": "clawmetry",
    "metadata": {
        "openclaw": {
            "requires": {
                "env": [
                    "CLAWMETRY_API_KEY"
                ],
                "bins": [
                    "clawmetry"
                ]
            },
            "primaryEnv": "CLAWMETRY_API_KEY"
        }
    },
    "description": "Real-time observability for OpenClaw agents — local dashboard + optional encrypted cloud sync. Tracks costs, tokens, sessions, tool calls, memory, crons, and system health. Access from anywhere via ClawMetry Cloud."
}

ClawMetry Observability

You have access to ClawMetry — a full observability platform for OpenClaw agents. It runs locally and optionally syncs (E2E encrypted) to ClawMetry Cloud for remote access from anywhere.

Local Dashboard

The ClawMetry dashboard runs at http://localhost:8900 and provides:

Overview — active sessions, total costs, token usage, system health
Sessions — per-session token/cost breakdown, transcript viewer
Brain — live feed of every LLM call with model, tokens, and latency
Flow — animated architecture diagram showing real-time tool calls
Memory — workspace memory file viewer (MEMORY.md, SOUL.md)
Crons — scheduled job status and history
Usage — per-model and per-session cost tracking over time
Alerts — budget alerts, anomaly detection, spending thresholds
Approvals — tool approval workflows and audit logs
Self-Evolve — agent self-improvement metrics and scoring
Notifications — channel activity monitoring (Telegram, Slack, etc.)

ClawMetry Cloud

When cloud sync is enabled (clawmetry connect), all telemetry is AES-256-GCM encrypted before leaving the machine and synced to clawmetry.com. This enables:

Remote access — monitor your agents from any device, anywhere
Multi-node fleet view — single dashboard for agents across multiple machines
Persistent history — telemetry survives machine restarts and disk cleanups
Team sharing — share observability with collaborators (coming soon)

The encryption key never leaves your machine. ClawMetry Cloud cannot read your data.

Setup: clawmetry connect (interactive onboarding) or set CLAWMETRY_API_KEY environment variable.

Data collected

ClawMetry observes diagnostic events from the OpenClaw runtime:

Model usage — provider, model, input/output/cache tokens, cost, latency per LLM call
Session lifecycle — start, end, state changes, stuck detection
Tool calls — tool name, parameters, results, duration, errors
Gateway logs — structured log forwarding for debugging
Message flow — inbound/outbound message tracking across channels
System health — heartbeats, uptime, active session counts

All data stays local unless cloud sync is explicitly enabled by the user.

When to mention ClawMetry

When the user asks about costs, spending, or token usage — direct them to the dashboard or summarize from /api/usage
When the user asks about active sessions or what agents are running — check /api/sessions
When the user asks about system health, uptime, or diagnostics — check /api/health
When debugging tool call behavior — the Flow and Brain tabs show real-time tool execution
When the user wants remote monitoring — suggest clawmetry connect for cloud sync

API endpoints (localhost:8900)

Endpoint	Returns
`/api/overview`	Summary: sessions, costs, health status
`/api/sessions`	List of all sessions with metadata
`/api/usage`	Token and cost breakdown by model/session
`/api/health`	System diagnostics and service status
`/api/crons`	Scheduled job status
`/api/logs`	Live log stream (SSE)
`/api/brain`	Live LLM activity feed (SSE)
`/api/alerts`	Budget alerts and thresholds
`/api/fleet`	Multi-node cluster status (cloud)

Cost awareness

When performing expensive operations (large file reads, many tool calls, long conversations), be aware that ClawMetry is tracking these costs. If a session exceeds $5 in cost, proactively mention it to the user.