# Send Clawculator to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawculator",
    "name": "Clawculator",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/echoudhry/clawculator",
    "canonicalUrl": "https://clawhub.ai/echoudhry/clawculator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/clawculator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawculator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "analyzer.js",
      "htmlReport.js",
      "liveDashboard.js",
      "mdReport.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "clawculator",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T04:40:50.797Z",
      "expiresAt": "2026-05-06T04:40:50.797Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawculator",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawculator",
        "contentDisposition": "attachment; filename=\"clawculator-1.2.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "clawculator"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clawculator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawculator",
    "downloadUrl": "https://openagent3.xyz/downloads/clawculator",
    "agentUrl": "https://openagent3.xyz/skills/clawculator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawculator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawculator/agent.md"
  }
}
```
## Documentation

### clawculator

Cost forensics for OpenClaw. Finds billing issues in your config, sessions, and workspace. Pure deterministic logic — no AI, no network calls, no external dependencies.

Source code is fully bundled in this skill folder. Nothing is fetched at runtime. You can audit every file before running.

Files this skill reads:

~/.openclaw/openclaw.json — your OpenClaw config
~/.openclaw/agents/main/sessions/sessions.json — session token usage
~/clawd/ — workspace root file count only (no file contents read)
/tmp/openclaw — log directory (read only, if present)

Files this skill may write (only when --md is used):

./clawculator-report.md — markdown report
Custom path via --out=PATH

No network requests are made. No shell commands are spawned.

Session keys are truncated in all output (first 8 chars + ellipsis) to avoid exposing sensitive identifiers.

Usage

When the user types clawculator, check my costs, analyze spend, or cost report, run:

node {baseDir}/run.js --md

Return the full markdown report to the user inline.

When the user types snapshot, share my grade, cost grade, clawculator snapshot, or what's my grade, run:

node {baseDir}/run.js --snapshot

Return the terminal card output to the user. This shows their grade (A+ to D), cost range, setup complexity, and findings — designed to be screenshot and shared.

Flags

--snapshot — shareable grade card (terminal output, screenshot-ready)
--md — write markdown report and print to stdout
--json — machine-readable JSON to stdout
--out=PATH — custom output path for --md
node {baseDir}/run.js --help — full usage

What it catches

💓 Heartbeat running on paid model instead of Ollama
🔧 Skill polling loops on paid model
📱 WhatsApp groups auto-joined on primary model
🪝 Hooks (boot-md, command-logger, session-memory) on Sonnet
💬 Orphaned sessions still holding tokens
🤖 maxConcurrent too high — burst cost multiplier
📁 Workspace root bloat inflating context
⚙️ Primary model cost awareness

All findings include exact fix commands.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: echoudhry
- Version: 1.2.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T04:40:50.797Z
- Expires at: 2026-05-06T04:40:50.797Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/clawculator)
- [Send to Agent page](https://openagent3.xyz/skills/clawculator/agent)
- [JSON manifest](https://openagent3.xyz/skills/clawculator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/clawculator/agent.md)
- [Download page](https://openagent3.xyz/downloads/clawculator)