Openrouter Toolkit

通过 Python 命令行脚本调用 OpenRouter，按任务类型推荐模型、比较多个模型的输出与成本、构建自动回退链，并用本地 SQLite 记录调用花费、按日/周/月汇总及设置预算提醒。运行需 OPENROUTER_API_KEY 与 Python 3.10+ 环境。

aiwithabidi

热度 79.83

最近更新 2026-05-10 17:41:24

分类：开发依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：API 集成 / 自动化脚本 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openrouter-toolkit

Metadata

name: openrouter-toolkit
description: 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.
homepage: https://www.agxntsix.ai
license: MIT
compatibility: Python 3.10+, OpenRouter API key
metadata: {"openclaw":{"emoji":"🔀","requires":{"env":["OPENROUTER_API_KEY"]},"primaryEnv":"OPENROUTER_API_KEY","homepage":"https://www.agxntsix.ai"}}

🔀 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