#How to use openrouter/free

1 messages · Page 1 of 1 (latest)

honest houndBOT
#

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

lucid elkBOT
#

openrouter/openrouter/free is a model id. The error “unknown profile (auth)” is almost always about an auth profile id being wrong/missing (those look like openrouter:default, anthropic:default, etc. — note the colon, not /).

Common causes + fixes:

  1. You accidentally pinned a profile in the model string
  • If you have anything like ...@openrouter/openrouter/free → that’s wrong.
  • Correct would be openrouter/openrouter/free@openrouter:default (only if you actually have that profile).
  • Easiest: remove any @... and run /new (or reset the session) to clear overrides.
  1. No OpenRouter credentials visible to the Gateway
    Even for “free” OpenRouter models you still need an API key.
  • Put it somewhere the Gateway service can read:
  • ~/.openclaw/.env with OPENROUTER_API_KEY=sk-or-..., or
  • your openclaw.json with env: { OPENROUTER_API_KEY: "sk-or-..." }
  • Then restart the gateway.

Docs: