Model registration

[tropic valve]

My TUI did not ask me about which model to use during onboarding. Re-starting the onboarding does not help. Where can i add my openrouter config?

[coarse saffron]

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

[arctic mica]

You don’t have to redo onboarding for this — model selection can be set (or changed) later.

1) Add your OpenRouter key

Fastest via CLI (writes the credential to the agent’s auth store and updates config as needed):

openclaw models auth paste-token --provider openrouter

Or run onboarding just for OpenRouter auth:

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

Docs: https://docs.openclaw.ai/providers/openrouter
Auth docs: https://docs.openclaw.ai/gateway/authentication

2) Point your default model at OpenRouter (config)

Config is JSON5 at $OPENCLAW_CONFIG_PATH (default: ~/.openclaw/openclaw.json).

Add something like:

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
}