openclaw/docs/providers/openrouter.md

1018 B

summary read_when title
Use OpenRouter's unified API to access many models in OpenClaw
You want a single API key for many LLMs
You want to run models via OpenRouter in OpenClaw
OpenRouter

OpenRouter

OpenRouter provides a unified API that routes requests to many models behind a single endpoint and API key. It is OpenAI-compatible, so most OpenAI SDKs work by switching the base URL.

CLI setup

openclaw onboard --auth-choice openrouter-api-key

Config snippet

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/auto" },
    },
  },
}

Notes

  • Model refs are openrouter/<provider>/<model>.
  • Onboarding defaults to openrouter/auto. Switch to a concrete model later with openclaw models set openrouter/<provider>/<model>.
  • For more model/provider options, see /concepts/model-providers.
  • OpenRouter uses a Bearer token with your API key under the hood.