Skills openrouter-toolkit

The definitive OpenRouter skill — intelligent model routing by task type, cost tracking with budget alerts, automatic fallback chains, side-by-side model comparison, and savings recommendations. Use for optimizing AI model selection, controlling costs, and building resilient LLM pipelines.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/aiwithabidi/openrouter-toolkit" ~/.claude/skills/clawdbot-skills-openrouter-toolkit && rm -rf "$T"

manifest: skills/aiwithabidi/openrouter-toolkit/SKILL.md

source content

🔀 OpenRouter Toolkit

The definitive OpenRouter skill for OpenClaw agents. Intelligent model routing, cost tracking, fallback chains, and model comparison — all in one toolkit.

Features

Smart Routing — Automatically pick the best model for code, reasoning, creative, fast, or cheap tasks
Cost Tracking — Log every API call with cost, track daily/weekly/monthly spend
Fallback Chains — If primary model fails or times out, auto-retry with fallbacks
Model Comparison — Send the same prompt to N models, compare quality and cost side-by-side
Budget Alerts — Set spending limits and get warned before you blow your budget
Live Model Data — Pulls real pricing and capabilities from OpenRouter's API

Requirements

```
OPENROUTER_API_KEY
```
— Your OpenRouter API key
Python 3.10+ with
```
requests
```
(included in most environments)

Usage

Smart Routing

python3 {baseDir}/scripts/openrouter_toolkit.py route --task code
python3 {baseDir}/scripts/openrouter_toolkit.py route --task reasoning
python3 {baseDir}/scripts/openrouter_toolkit.py route --task creative
python3 {baseDir}/scripts/openrouter_toolkit.py route --task fast
python3 {baseDir}/scripts/openrouter_toolkit.py route --task cheap

Model Comparison

python3 {baseDir}/scripts/openrouter_toolkit.py compare --prompt "Explain recursion" --models "anthropic/claude-sonnet-4,openai/gpt-4o-mini"

Fallback Chain

python3 {baseDir}/scripts/openrouter_toolkit.py fallback --prompt "Hello" --chain "anthropic/claude-opus-4,anthropic/claude-sonnet-4,openai/gpt-4o-mini"

Cost Tracking

python3 {baseDir}/scripts/openrouter_toolkit.py cost --period daily
python3 {baseDir}/scripts/openrouter_toolkit.py cost --period weekly
python3 {baseDir}/scripts/openrouter_toolkit.py cost --period monthly

Budget Alerts

python3 {baseDir}/scripts/openrouter_toolkit.py budget --set 50.00
python3 {baseDir}/scripts/openrouter_toolkit.py budget --check

List Models

python3 {baseDir}/scripts/openrouter_toolkit.py models --top 20
python3 {baseDir}/scripts/openrouter_toolkit.py models --search claude
python3 {baseDir}/scripts/openrouter_toolkit.py models --best code

How Smart Routing Works

The router scores models based on task type using these heuristics:

Task	Prioritizes	Example Models
code	High context, code benchmarks	Claude Opus, GPT-4o
reasoning	Thinking/reasoning capability	Claude Opus, o1
creative	Creative writing quality	Claude Sonnet, GPT-4o
fast	Low latency, good enough quality	Claude Haiku, GPT-4o-mini
cheap	Lowest cost per token	Gemini Flash, GPT-4o-mini

Data Storage

Cost logs are stored in SQLite at

{baseDir}/data/openrouter_costs.db

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation