Agents & CLIs

OpenClaw

Add RouterPlex as a model provider in OpenClaw.

OpenClaw supports custom OpenAI-compatible providers. Add RouterPlex under models.providers in ~/.openclaw/openclaw.json:

json
{
"models": {
"providers": {
"routerplex": {
"baseUrl": "https://api.routerplex.com/v1",
"apiKey": "${ROUTERPLEX_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "claude-opus-4-8",
"name": "Claude Opus 4.8",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 32000
},
{
"id": "gemini-3.5-flash",
"name": "Gemini 3.5 Flash",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 16000
}
]
}
}
},
"agents": {
"defaults": {
"model": { "primary": "routerplex/claude-opus-4-8" },
"models": {
"routerplex/claude-opus-4-8": { "alias": "Opus" },
"routerplex/gemini-3.5-flash": { "alias": "Flash" }
}
}
}
}

Then export the key and verify connectivity:

bash
export ROUTERPLEX_API_KEY="sk-..."
openclaw models status --probe

Notes:

  • api: "openai-completions" is the right mode — RouterPlex serves /v1/chat/completions (not /v1/responses).
  • Models must appear in the agents.defaults.models allowlist or OpenClaw will reject them.
  • Model references use the provider/model-id form, e.g. routerplex/claude-opus-4-8.