Agent skill

Clawmetry

by vivekchand in vivekchand/clawmetry

Real-time observability for OpenClaw agents — local dashboard + optional encrypted cloud sync.

MITAuto-check passedDevOps & Cloud

Install Clawmetry

skills CLI
$ npx skills add vivekchand/clawmetry --skill clawmetry -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vivekchand/clawmetry clawmetry --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vivekchand/clawmetry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/clawhub-plugin/skills/clawmetry .claude/skills/clawmetry && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clawmetry
GitHub stars
424
Token cost
~992 tokens
SKILL.md length
443 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Real-time observability for OpenClaw agents — local dashboard + optional encrypted cloud sync.

  • Tasks that involve Observability
  • SKILL.md covers Local Dashboard, ClawMetry Cloud, Data collected and When to mention ClawMetry, plus 2 more sections
  • Needs CLAWMETRY_API_KEY
  • Tasks that involve Scheduled and recurring tasks

What it does

Clawmetry is an agent skill from vivekchand/clawmetry. 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.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Observability, Scheduled and recurring tasks and LLM cost and token optimization. It works with OpenTelemetry and Python. The repository describes itself as: See your agent think. Zero-config observability & governance for 30 AI agent runtimes: Claude Code, OpenAI Codex, Hermes, OpenClaw & 26 more. Live token costs, sessions, tool… The licence is MIT.

When your agent uses it

  • Tasks that involve Observability
  • Tasks that involve Scheduled and recurring tasks
  • Tasks that involve LLM cost and token optimization

Example prompts

  • “/clawmetry”

Requirements

  • A credential in CLAWMETRY_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 795d6fa. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • CLAWMETRY_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clawmetry loads about 992 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 443 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~992

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vivekchand/clawmetry at commit 795d6fa, republished under its MIT licence (© vivekchand). 443 words, ~992 tokens.

Download SKILL.mdSave it as .claude/skills/clawmetry/SKILL.md (or your agent's skills folder).
name
clawmetry
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.

Show full SKILL.md (166 more words)Show less

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)

EndpointReturns
/api/overviewSummary: sessions, costs, health status
/api/sessionsList of all sessions with metadata
/api/usageToken and cost breakdown by model/session
/api/healthSystem diagnostics and service status
/api/cronsScheduled job status
/api/logsLive log stream (SSE)
/api/brainLive LLM activity feed (SSE)
/api/alertsBudget alerts and thresholds
/api/fleetMulti-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.

© vivekchand, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in clawhub-plugin/skills/clawmetry of vivekchand/clawmetry.

Open the folder on GitHubat commit 795d6fa

Compare with similar skills

Clawmetry next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clawmetry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clawmetry this skillvivekchand/clawmetry424—~992Automated safety check: PassMIT
Logfire Instrumentationbasicmachines-co/basic-memory4.1k—~2.3kAutomated safety check: PassAGPL-3.0
Azure Monitor Opentelemetry Exporter Pymicrosoft/skills3.1k6 repos~2.3kAutomated safety check: PassMIT
Azure Monitor Opentelemetry Pymicrosoft/skills3.1k6 repos~2kAutomated safety check: PassMIT
Enforcing Nophi Loggingmaziyarpanahi/openmed5.5k—~1.9kAutomated safety check: PassApache-2.0
App Observabilitygrafana/skills278—~1.8kAutomated safety check: PassApache-2.0

Similar skills

  • Logfire Instrumentation

    basicmachines-co/basic-memory

    Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.

    4.1k GitHub stars~2.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Official

    Azure Monitor OpenTelemetry Exporter for Python. An agent skill from microsoft/skills.

    3.1k GitHub starsUsed in 6 repos~2.3k tokens
    DevOps & CloudAuto-check passed
  • Official

    Azure Monitor OpenTelemetry Distro for Python. An agent skill from microsoft/skills.

    3.1k GitHub starsUsed in 6 repos~2k tokens
    DevOps & CloudAuto-check passed
  • Enforcing Nophi Logging

    maziyarpanahi/openmed

    Add a logging and telemetry guard that scrubs or blocks PHI from logs, traces, and error reports around an OpenMed deployment.

    5.5k GitHub stars~1.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • App Observability

    grafana/skills

    Official

    Get RED metrics + service maps + frontend RUM + AI/LLM monitoring out of Grafana Cloud — Application Observability (tracesspanmetrics from OTel traces, p50/p95/p99 latency, exemplar-to-trace…

    278 GitHub stars~1.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Implementing Observability

    ancoleman/ai-design-components

    Monitoring, logging, and tracing implementation using OpenTelemetry as the unified standard.

    526 GitHub stars~3k tokensUpdated 10 mo ago
    DevOps & CloudAuto-check passed

More from vivekchand/clawmetry

  • Agent Kill Switch

    vivekchand/clawmetry

    Give the human an off switch and a cost meter for the coding agents on this machine, using ClawMetry.

    424 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Clawmetry Selfcheck

    vivekchand/clawmetry

    Read your own agent telemetry from ClawMetry (waste, progress, cost) and act on it before finishing a task.

    424 GitHub stars~515 tokensUpdated today
    Auto-check passed

Categories

Questions about Clawmetry

What does Clawmetry do?

Real-time observability for OpenClaw agents — local dashboard + optional encrypted cloud sync. Clawmetry is an agent skill from vivekchand/clawmetry. Real-time observability for OpenClaw agents — local dashboard + optional encrypted cloud sync.

When should I use Clawmetry?

Clawmetry fits situations like: tasks that involve Observability; tasks that involve Scheduled and recurring tasks; tasks that involve LLM cost and token optimization.

How do I install Clawmetry in Claude Code?

Run `npx skills add vivekchand/clawmetry --skill clawmetry -a claude-code`. Or copy the skill folder (clawhub-plugin/skills/clawmetry in vivekchand/clawmetry) into .claude/skills/clawmetry in your project. Claude Code loads it when a task matches its description.

How do I install Clawmetry in Codex?

Run `npx skills add vivekchand/clawmetry --skill clawmetry -a codex`. Or copy the skill folder (clawhub-plugin/skills/clawmetry in vivekchand/clawmetry) into .agents/skills/clawmetry in your project. Codex loads it when a task matches its description.

Can I use Clawmetry in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vivekchand/clawmetry --skill clawmetry -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clawmetry, .gemini/skills/clawmetry, .github/skills/clawmetry and .opencode/skills/clawmetry in your project.

What does Clawmetry need to run?

Going by SKILL.md and its folder, Clawmetry needs credentials named CLAWMETRY_API_KEY. Our summary lists: A credential in CLAWMETRY_API_KEY.

Does Clawmetry access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Clawmetry safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clawmetry use?

Clawmetry is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clawmetry use?

About 992 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clawmetry?

Skills that share tags, products or a category with Clawmetry: Logfire Instrumentation (basicmachines-co/basic-memory, 4.1k stars), Azure Monitor Opentelemetry Exporter Py (microsoft/skills, 3.1k stars), Azure Monitor Opentelemetry Py (microsoft/skills, 3.1k stars) and Enforcing Nophi Logging (maziyarpanahi/openmed, 5.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clawmetry?

vivekchand (a GitHub user) maintains it in vivekchand/clawmetry, which has 424 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: vivekchand/clawmetry on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.