# Send Cost Guardian 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. 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. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "cost-guardian", "name": "Cost Guardian", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/mariusfit/cost-guardian", "canonicalUrl": "https://clawhub.ai/mariusfit/cost-guardian", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/cost-guardian", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cost-guardian", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/cost-guardian.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/cost-guardian" }, "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/cost-guardian", "downloadUrl": "https://openagent3.xyz/downloads/cost-guardian", "agentUrl": "https://openagent3.xyz/skills/cost-guardian/agent", "manifestUrl": "https://openagent3.xyz/skills/cost-guardian/agent.json", "briefUrl": "https://openagent3.xyz/skills/cost-guardian/agent.md" } } ``` ## Documentation ### cost-guardian — AI & Infrastructure Cost Tracker Track, analyze, and optimize the total cost of running your AI agent and infrastructure. Budget alerts, spend forecasts, and concrete optimization recommendations. ### Initialize python scripts/cost-guardian.py init Creates config and database in ~/.openclaw/workspace/costs/. ### Track a Cost Entry # Track API spend python scripts/cost-guardian.py track --provider openai --amount 12.50 --currency USD --period monthly --category api # Track infrastructure cost python scripts/cost-guardian.py track --provider hetzner --amount 5.00 --currency EUR --period monthly --category hosting # Track one-time cost python scripts/cost-guardian.py track --provider cloudflare --amount 10.00 --currency USD --period once --category domain # Track electricity python scripts/cost-guardian.py track --provider electricity --amount 15.00 --currency EUR --period monthly --category power ### Scan Token Usage from Gateway Logs # Scan recent gateway logs for token consumption per model python scripts/cost-guardian.py scan-tokens # Scan specific days python scripts/cost-guardian.py scan-tokens --days 7 ### Set Budget # Monthly budget python scripts/cost-guardian.py budget --monthly 50.00 --currency EUR # Budget with alert threshold (alert at 80%) python scripts/cost-guardian.py budget --monthly 50.00 --alert-pct 80 ### Cost Report # Current month report python scripts/cost-guardian.py report # Weekly report python scripts/cost-guardian.py report --period week # JSON output python scripts/cost-guardian.py report --json # Specific month python scripts/cost-guardian.py report --month 2026-02 ### Optimization Recommendations # Get optimization suggestions python scripts/cost-guardian.py optimize # JSON output python scripts/cost-guardian.py optimize --json ### Forecast Spend # Forecast next 3 months python scripts/cost-guardian.py forecast # Forecast next N months python scripts/cost-guardian.py forecast --months 6 # JSON output python scripts/cost-guardian.py forecast --json ### Manage Subscriptions # Add a subscription python scripts/cost-guardian.py sub add --name "OpenRouter" --amount 20.00 --currency USD --cycle monthly --renews 2026-03-15 --category api # List subscriptions python scripts/cost-guardian.py sub list # Remove a subscription python scripts/cost-guardian.py sub remove --name "OpenRouter" # Check upcoming renewals python scripts/cost-guardian.py sub upcoming --days 14 ### Status Dashboard # Quick status overview python scripts/cost-guardian.py status # JSON output python scripts/cost-guardian.py status --json ### Categories api — AI model API costs (OpenAI, Anthropic, OpenRouter, etc.) hosting — VPS, cloud, domain, DNS power — Electricity for homelab subscription — SaaS subscriptions hardware — One-time hardware purchases other — Everything else ### Output Modes All commands support: Human-readable (default) — colored terminal output JSON (--json) — structured data for programmatic use ### Cron Integration Add to OpenClaw cron for automated cost tracking: Daily: scan-tokens to track API usage Weekly: report --period week for digest Monthly: report + forecast for full analysis On-demand: optimize when looking to cut costs ### Data Storage All data stored in ~/.openclaw/workspace/costs/: config.json — budget settings, preferences costs.db — SQLite database (entries, subscriptions, token scans) ### Zero Dependencies Pure Python 3 stdlib — no pip install needed. Uses sqlite3, json, datetime, pathlib. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: mariusfit - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/cost-guardian) - [Send to Agent page](https://openagent3.xyz/skills/cost-guardian/agent) - [JSON manifest](https://openagent3.xyz/skills/cost-guardian/agent.json) - [Markdown brief](https://openagent3.xyz/skills/cost-guardian/agent.md) - [Download page](https://openagent3.xyz/downloads/cost-guardian)