OpenRouter

OpenRouter kieruje żądania do wielu modeli za pośrednictwem jednego API i jednego klucza. Jest zgodny z OpenAI, dlatego OpenClaw komunikuje się z nim za pomocą tego samego transportu w stylu openai-completions, który jest używany w przypadku innych dostawców proxy.

Pierwsze kroki

openclaw onboard --auth-choice openrouter-oauth

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

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

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

Przykład konfiguracji

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

Odwołania do modeli

Wbudowane modele rezerwowe używane, gdy dynamiczne wykrywanie katalogu jest niedostępne:

Każde inne odwołanie openrouter/<provider>/<model>, w tym openrouter/openrouter/fusion (zobacz router Fusion), jest rozpoznawane dynamicznie na podstawie aktualnego katalogu modeli OpenRouter.

Generowanie obrazów

OpenRouter może obsługiwać narzędzie image_generate. Ustaw model obrazów OpenRouter w agents.defaults.imageGenerationModel:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",        timeoutMs: 180_000,      },    },  },}

OpenClaw wysyła żądania generowania obrazów do API obrazów chat-completions OpenRouter z modalities: ["image", "text"]. Modele obrazów Gemini otrzymują dodatkowo wskazówki aspectRatio i resolution za pośrednictwem image_config OpenRouter; inne modele obrazów ich nie otrzymują. W przypadku wolniejszych modeli użyj agents.defaults.imageGenerationModel.timeoutMs; wartość timeoutMs dla pojedynczego wywołania narzędzia image_generate nadal ma pierwszeństwo.

Generowanie filmów

OpenRouter może obsługiwać narzędzie video_generate za pośrednictwem asynchronicznego API /videos. Ustaw model wideo OpenRouter w agents.defaults.videoGenerationModel:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      videoGenerationModel: {        primary: "openrouter/google/veo-3.1-fast",      },    },  },}

OpenClaw przesyła zadania generowania filmu z tekstu i obrazu, odpytuje zwrócony polling_url, a następnie pobiera gotowy film z unsigned_urls OpenRouter lub z punktu końcowego zawartości zadania. Obrazy referencyjne są domyślnie używane jako pierwsza lub ostatnia klatka; obrazy oznaczone jako reference_image są zamiast tego wysyłane jako referencje wejściowe. Domyślny, wbudowany model google/veo-3.1-fast obsługuje czas trwania 4/6/8 sekund, rozdzielczości 720P/1080P oraz proporcje obrazu 16:9/9:16. Generowanie filmu na podstawie filmu nie jest obsługiwane: nadrzędne API akceptuje wyłącznie tekst i obrazy referencyjne.

Generowanie muzyki

OpenRouter może obsługiwać narzędzie music_generate za pośrednictwem dźwięku wyjściowego chat-completions. Ustaw model audio OpenRouter w agents.defaults.musicGenerationModel:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      musicGenerationModel: {        primary: "openrouter/google/lyria-3-pro-preview",        timeoutMs: 180_000,      },    },  },}

Wbudowany dostawca muzyki OpenRouter używa domyślnie modelu google/lyria-3-pro-preview i udostępnia również google/lyria-3-clip-preview. OpenClaw wysyła modalities: ["text", "audio"], przesyła strumieniowo odpowiedź, zbiera fragmenty dźwięku i zapisuje wynik jako wygenerowane multimedia do dostarczenia przez kanał. Modele Lyria przyjmują jeden obraz referencyjny za pośrednictwem wspólnego parametru music_generate image=.... Strumieniowy dźwięk, przechowywanie transkrypcji oraz pochodna otoczka zdarzeń SSE są ograniczone przez agents.defaults.mediaMaxMb (domyślny limit dźwięku wynosi 16 MB).

Zamiana tekstu na mowę

OpenRouter może działać jako dostawca TTS za pośrednictwem zgodnego z OpenAI punktu końcowego /audio/speech.

{  messages: {    tts: {      auto: "always",      provider: "openrouter",      providers: {        openrouter: {          model: "hexgrad/kokoro-82m",          speakerVoice: "af_alloy",          responseFormat: "mp3",        },      },    },  },}

Jeśli pominięto messages.tts.providers.openrouter.apiKey, TTS korzysta kolejno z models.providers.openrouter.apiKey, a następnie OPENROUTER_API_KEY.

Zamiana mowy na tekst (przychodzący dźwięk)

OpenRouter może transkrybować przychodzące załączniki głosowe/dźwiękowe za pośrednictwem wspólnej ścieżki tools.media.audio, używając swojego punktu końcowego STT (/audio/transcriptions). Dotyczy to każdego pluginu kanału, który przekazuje przychodzący głos/dźwięk do wstępnego etapu rozpoznawania multimediów.

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],      },    },  },}

OpenClaw wysyła żądania STT do OpenRouter jako JSON z dźwiękiem zakodowanym w base64 w polu input_audio (zgodnie z kontraktem STT OpenRouter), a nie jako wieloczęściowe dane formularza OpenAI.

Router Fusion

OpenRouter Fusion wysyła jedno odwołanie do modelu OpenClaw równolegle do kilku modeli OpenRouter, zleca OpenRouter ocenę ich odpowiedzi i zwraca jedną ostateczną odpowiedź przez standardowy punkt końcowy OpenRouter. Identyfikator modelu po stronie usługi nadrzędnej to openrouter/fusion, dlatego odwołanie do modelu OpenClaw zawiera zarówno prefiks dostawcy OpenClaw, jak i przestrzeń nazw nadrzędnego OpenRouter:

openclaw models set openrouter/openrouter/fusion

Skonfiguruj panel i model oceniający Fusion za pomocą params.extraBody modelu; pola te są przekazywane bezpośrednio do treści żądania uzupełniania czatu OpenRouter. Fusion działa zarówno z wdrażaniem przez OAuth, jak i przez klucz API; jeśli używasz OAuth, pomiń poniższy wiersz env.OPENROUTER_API_KEY.

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      model: { primary: "openrouter/openrouter/fusion" },      models: {        "openrouter/openrouter/fusion": {          params: {            extraBody: {              plugins: [                {                  id: "fusion",                  analysis_models: [                    "google/gemini-3.5-flash",                    "moonshotai/kimi-k2.6",                    "deepseek/deepseek-v4-pro",                  ],                  model: "google/gemini-3.5-flash",                },              ],            },          },        },      },    },  },}

analysis_models to panel modeli działających równolegle; model wewnątrz konfiguracji pluginu Fusion to model oceniający. W zwykłych turach agenta/czatu nie ustawiaj tool_choice najwyższego poziomu na "required" w celu wymuszenia Fusion: tury OpenClaw mogą zawierać własne definicje narzędzi, a wymagany wybór narzędzia najwyższego poziomu może wskazać jedno z nich zamiast routera Fusion. Gdy ta konfiguracja pluginu Fusion jest obecna, OpenClaw dodaje do komunikatu systemowego oczyszczoną notatkę z listą skonfigurowanych modeli analitycznych i modelu oceniającego, dzięki czemu agent może odpowiadać na pytania dotyczące własnego panelu Fusion. Inne pola extraBody nie są kopiowane do komunikatu.

Fusion jest z założenia wolniejszy: OpenRouter rozsyła komunikat do wielu modeli analitycznych, a następnie wykonuje etap oceny/syntezy, więc opóźnienie jest większe niż w przypadku bezpośredniego żądania do jednego modelu. Używaj go do przemyślanych odpowiedzi wysokiej jakości lub ścieżek eskalacji, a nie jako domyślnej opcji wrażliwej na opóźnienia. Utrzymuj niewielki panel i wybieraj szybsze modele analityczne/oceniające, aby uzyskać krótszy czas odpowiedzi.

Przetestuj skonfigurowane odwołanie za pomocą jednorazowego wywołania lokalnego:

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Reply with exactly: FUSION_OK" \  --json

Uwierzytelnianie i nagłówki

OpenRouter używa tokenu Bearer pochodzącego z Twojego klucza API. OAuth OpenRouter to proces logowania PKCE, który wystawia klucz API OpenRouter, dlatego OpenClaw zapisuje wynik w tym samym profilu uwierzytelniania kluczem API openrouter:default, którego używa ręczna konfiguracja klucza API.

Aby zalogować się lub zmienić zapisany klucz w istniejącej instalacji bez ponownego wykonywania pełnego wdrażania:

openclaw models auth login --provider openrouter --method oauthopenclaw models auth login --provider openrouter --method api-key

Do zweryfikowanych żądań OpenRouter (https://openrouter.ai/api/v1) OpenClaw dodaje udokumentowane przez OpenRouter nagłówki identyfikujące aplikację:

Konfiguracja zaawansowana

{  agents: {    defaults: {      models: {        "openrouter/auto": {          params: {            responseCache: true,            responseCacheTtlSeconds: 300,          },        },      },    },  },}

{  models: {    providers: {      openrouter: {        params: {          provider: {            sort: "latency",            require_parameters: true,            data_collection: "deny",          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openrouter/anthropic/claude-sonnet-4-6": {          params: {            provider: {              order: ["anthropic"],              allow_fallbacks: false,            },          },        },      },    },  },}

Powiązane