100K+ GitHub stars. The AI coding agent that's changing how developers work. One session can make hundreds of API calls — and token costs spiral fast.
A typical debugging session? 50+ Claude calls. A refactoring task? 100+ calls. Using Opus for everything means $3-10+ per task in API fees.
Route between any model seamlessly
POST /v1/messagesAny SDK respecting BASE_URL redirects through the local proxy
→ claude-3-5-haikuAnalyzes prompt, infers task type, selects optimal model for cost/quality
← SSE streamDirect connection to provider. Response streams back. Outcome logged.
Once the skill is installed, your agent can use these commands directly.
npx clawhub@latest install RelayPlane/relayplanerelayplane telemetry onEnable anonymized telemetry (for Relay Network)
relayplane telemetry offDisable telemetry completely
relayplane telemetry statusShow current telemetry settings
relayplane dashboardOpen the cloud dashboard in browser
relayplane statsShow local routing statistics
relayplane statusShow proxy status and configuration
relayplane modelsList available routing models and providers
All commands work inside your OpenClaw agent session. Just ask your agent to run them.
RelayPlane doesn't just route — it learns from every request. Track outcomes, detect patterns, and continuously improve routing for your specific codebase.
autoAnalyzes prompt complexity, routes simple tasks to Sonnet and complex tasks to Opus. Best balance of cost and quality.
simple → sonnet complex → opus
cascadeStarts with cheapest viable model, escalates on rate limits or errors. Maximum savings with automatic fallback.
start → sonnet # escalate on rate_limit
qualityRoutes everything to Opus. Maximum quality, no cost optimization.
everything → opus # no downgrade
RelayPlane analyzes your prompts and infers task types to make optimal routing decisions.
code_generationWriting new code
code_reviewReviewing, debugging
summarizationCondensing text
analysisDeep reasoning
question_answeringDirect questions
data_extractionStructured parsing
creative_writingStories, copy
translationLanguage conversion
Config file: ~/.relayplane/config.json — hot-reloads on save.
{
"enabled": true,
"routing": {
"mode": "auto",
"complexity": {
"enabled": true,
"simple": "claude-sonnet-4-6",
"moderate": "claude-sonnet-4-6",
"complex": "claude-opus-4-6"
},
"cascade": {
"enabled": true,
"escalateOn": "rate_limit",
"maxEscalations": 1,
"fallbackProvider": "ollama"
}
},
"reliability": {
"cooldowns": {
"enabled": true,
"allowedFails": 5,
"windowSeconds": 120,
"cooldownSeconds": 30
}
}
}"auto" — Complexity-based routing (simple/moderate/complex)
"cascade" — Start cheap, escalate on rate limits or errors
"quality" — Always use the best model
"rate_limit" — Escalate on rate limits or errors
"error" — Escalate on API errors only
Automatically classifies prompts as simple/moderate/complex and routes to the configured model for each tier.
Auto-disable failing providers. 5 failures in 120s triggers 30s cooldown.
/control/statusProxy status and current configuration
{ "enabled": true, "mode": "cascade", "modelOverrides": {} }/control/statsAggregated statistics and routing counts
{ "totalRequests": 142, "successRate": "97.2%", "avgLatencyMs": 1203, "modelCounts": {...} }/control/enableEnable routing (returns { enabled: true })
{ "enabled": true }/control/disableDisable routing — passthrough mode
{ "enabled": false }/control/configUpdate config (merges with existing, hot-reload)
{ "ok": true, "config": {...} }POST /v1/messagesNative Anthropic API — for Claude Code and direct Claude integrations
POST /v1/chat/completionsOpenAI-compatible API — works with any OpenAI SDK
Start it with verbose mode to see what's happening:
npx @relayplane/proxy --port 4100 -v
Check that your BASE_URL is set correctly:
echo $ANTHROPIC_BASE_URL # Should be http://localhost:4100
Unset the BASE_URL or add the bypass header:
unset ANTHROPIC_BASE_URL # Or use header: X-RelayPlane-Bypass: true
Check the stats endpoint or look at proxy logs:
curl http://localhost:4100/control/stats
Make sure your API key is set:
export ANTHROPIC_API_KEY="sk-ant-..."