How do I install the Openclaw Cost Guard skill?

Run npx skillmds@latest add dvcrn/openclaw-cost-guard in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openclaw Cost Guard safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openclaw Cost Guard?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openclaw Cost Guard free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openclaw Cost Guard?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openclaw Cost Guard by dvcrn — Agent Skill

Name: Openclaw Cost Guard
Rating: 4.5 (4 reviews)
Author: dvcrn

Openclaw Cost Guard

Track OpenClaw/Clawdbot token and cost usage from session JSONL logs (prefer real usage.cost when present), generate daily/weekly summaries and top expensive sessions, and run budget checks (exit code on breach). Use to monitor spend, enforce budgets via cron/alerts, and apply a token-saving playbook to reduce output/tool-call cost.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

OpenClaw Cost Guard

Use this skill when you need:

accurate cost reports (daily/weekly/lifetime)
top expensive sessions
guardrails to reduce token burn (without changing config unless user asks)

1) Data source (important)

Prefer session JSONL logs (they contain per-call usage, often with real USD cost):

OpenClaw: ~/.openclaw/agents/*/sessions/*.jsonl
Legacy/compat: ~/.clawdbot/agents/*/sessions/*.jsonl

Do not estimate from “current context window” style token fields.

2) Quick commands

Daily costs (last 7 days)

python3 {baseDir}/scripts/extract_cost.py --last-days 7

Today / yesterday

python3 {baseDir}/scripts/extract_cost.py --today
python3 {baseDir}/scripts/extract_cost.py --yesterday

Top expensive sessions

python3 {baseDir}/scripts/extract_cost.py --top-sessions 10

JSON output (for dashboards)

python3 {baseDir}/scripts/extract_cost.py --last-days 30 --json

3) If cost is missing (fallback estimate)

Some providers may omit usage.cost. You can provide per-1M-token prices:

export PRICE_INPUT=1.75
export PRICE_OUTPUT=14
export PRICE_CACHE_READ=0.175
export PRICE_CACHE_WRITE=0
python3 {baseDir}/scripts/extract_cost.py --last-days 7

4) Budget alerts

The extractor can run as a budget check:

python3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5

If budget is exceeded, it prints an ALERT and exits with code 2 (default).
For non-failing checks:

python3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5 --budget-mode warn

Wiring it to a cron alert (recommended)

Run it daily (or hourly) and if exit code is 2, send yourself a Telegram message. (Implementation depends on your OpenClaw channel setup; do not embed secrets in scripts.)

5) Token-saving playbook (teach the AI)

When the user says “use as few tokens as possible”, apply:

Default response budget: 1–6 lines, bullets > paragraphs
Ask 1 question max (only if truly blocking)
Progressive disclosure: offer details only if asked
Tool calls: batch; avoid repeated status/browser calls
No log dumps into chat; summarize + point to file path
Hard limits: max 3 web iterations (search/fetch) per task

Optional phrasing to keep yourself in check:

"Answer in <=6 lines. If more is needed, ask permission."

---name: openclaw-cost-guarddescription: Track OpenClaw/Clawdbot token and cost usage from session JSONL logs (prefer real usage.cost when present), generate daily/weekly summaries and top expensive sessions, and run budget checks (exit code on breach). Use to monitor spend, enforce budgets via cron/alerts, and apply a token-saving playbook to reduce output/tool-call cost.---# OpenClaw Cost GuardUse this skill when you need:- **accurate cost reports** (daily/weekly/lifetime)- **top expensive sessions**- **guardrails to reduce token burn** (without changing config unless user asks)## 1) Data source (important)Prefer **session JSONL** logs (they contain per-call `usage`, often with **real USD cost**):- OpenClaw: `~/.openclaw/agents/*/sessions/*.jsonl`- Legacy/compat: `~/.clawdbot/agents/*/sessions/*.jsonl`Do **not** estimate from “current context window” style token fields.## 2) Quick commands### Daily costs (last 7 days)```bashpython3 {baseDir}/scripts/extract_cost.py --last-days 7```### Today / yesterday```bashpython3 {baseDir}/scripts/extract_cost.py --todaypython3 {baseDir}/scripts/extract_cost.py --yesterday```### Top expensive sessions```bashpython3 {baseDir}/scripts/extract_cost.py --top-sessions 10```### JSON output (for dashboards)```bashpython3 {baseDir}/scripts/extract_cost.py --last-days 30 --json```## 3) If cost is missing (fallback estimate)Some providers may omit `usage.cost`. You can provide per-1M-token prices:```bashexport PRICE_INPUT=1.75export PRICE_OUTPUT=14export PRICE_CACHE_READ=0.175export PRICE_CACHE_WRITE=0python3 {baseDir}/scripts/extract_cost.py --last-days 7```## 4) Budget alertsThe extractor can run as a **budget check**:```bashpython3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5```- If budget is exceeded, it prints an **ALERT** and exits with code **2** (default).- For non-failing checks:```bashpython3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5 --budget-mode warn```### Wiring it to a cron alert (recommended)Run it daily (or hourly) and if exit code is 2, send yourself a Telegram message.(Implementation depends on your OpenClaw channel setup; do not embed secrets in scripts.)## 5) Token-saving playbook (teach the AI)When the user says “use as few tokens as possible”, apply:- **Default response budget:** 1–6 lines, bullets > paragraphs- **Ask 1 question max** (only if truly blocking)- **Progressive disclosure:** offer details only if asked- **Tool calls:** batch; avoid repeated `status`/browser calls- **No log dumps** into chat; summarize + point to file path- **Hard limits:** max 3 web iterations (search/fetch) per taskOptional phrasing to keep yourself in check:> "Answer in <=6 lines. If more is needed, ask permission."

Frequently asked questions