// dokumentacja openclaw

OpenRouter w OpenClaw — jeden klucz do wielu dostawcow

Czym jest OpenRouter?

OpenRouter to usluga proxy, ktora zapewnia ujednolicony dostep do wielu dostawcow modeli AI za pomoca jednego klucza API. Zamiast zakladac konta u kazdego dostawcy osobno, mozesz uzyc OpenRouter jako posrednika — to szczegolnie wygodne do testowania roznych modeli i porownywania ich mozliwosci.

Konfiguracja

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

Przyklad konfiguracji

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

Format identyfikatorow modeli

Identyfikatory modeli w OpenRouter maja format openrouter/<dostawca>/<model>. Domyslny tryb openrouter/auto pozwala OpenRouter automatycznie wybrac najlepszy model.

Aby zmienic model, uzyj:

openclaw models set openrouter/<dostawca>/<model>

Przyklady identyfikatorow

  • openrouter/anthropic/claude-opus-4-6 — Claude Opus 4.6 przez OpenRouter
  • openrouter/openai/gpt-5.4 — GPT-5.4 przez OpenRouter
  • openrouter/google/gemini-3.1-pro — Gemini 3.1 Pro przez OpenRouter
  • openrouter/auto — automatyczny wybor modelu

Szczegoly techniczne

Uwierzytelnianie

OpenRouter uzywa uwierzytelniania Bearer Token z Twoim kluczem API. Nie musisz konfigurowac osobnych kluczy dla poszczegolnych dostawcow.

Naglowki zapytan

OpenClaw automatycznie dolacza naglowki atrybuacji do zapytan wysylanych przez OpenRouter:

  • HTTP-Referer: https://openclaw.ai
  • X-OpenRouter-Title: OpenClaw
  • X-OpenRouter-Categories: cli-agent

Obsluga cache Anthropic

Przy korzystaniu ze zweryfikowanych referencji modeli Anthropic przez OpenRouter, OpenClaw zachowuje znaczniki cache_control dla lepszego ponownego uzycia cache promptow. Pozwala to obnizac koszty nawet przy dostepe posrednim.

Obsluga rozumowania

System mapuje poziomy myslenia na payloady rozumowania OpenRouter na obslugiwanych trasach. Tryb openrouter/auto i nieobslugiwane modele pomijaja wstrzykiwanie parametrow rozumowania.

Ograniczenia

Routing przez proxy OpenRouter nie obsluguje niektorych funkcji natywnych OpenAI:

  • Brak serviceTier (przetwarzanie priorytetowe)
  • Brak store w Response API (przechowywanie odpowiedzi)
  • Brak natywnych payloadow rozumowania (reasoning)
  • Brak niestandardowych naglowkow atrybuacji

Kiedy uzywac OpenRouter?

  • Testowanie modeli — szybkie porownywanie roznych dostawcow bez zakladania wielu kont.
  • Jeden rachunek — wszystkie koszty na jednej fakturze.
  • Fallback miedzy dostawcami — automatyczne przejscie na inny model, jesli glowny jest niedostepny.
  • Dostep do niszowych modeli — OpenRouter czesto jako pierwszy udostepnia nowe modele.
Wróc do dokumentacji