SkillHub

openrouter-toolkit

v1.0.0

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.

Sourced from ClawHub, Authored by aiwithabidi

Installation

Please help me install the skill `openrouter-toolkit` from SkillHub official store. npx skills add aiwithabidi/openrouter-toolkit

🔀 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