🔀 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:

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