OpenRouter

OpenRouter fornece uma API unificada que roteia solicitações para muitos modelos por trás de um único endpoint e chave de API. Ela é compatível com OpenAI, portanto a maioria dos SDKs da OpenAI funciona ao trocar a URL base.

# Primeiros passos

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

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

# Exemplo de configuração

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

# Referências de modelo

Exemplos de fallback incluídos:

# Geração de imagens

OpenRouter também pode respaldar a ferramenta image_generate. Use um modelo de imagem do OpenRouter em 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 envia solicitações de imagem para a API de imagens de chat completions do OpenRouter com modalities: ["image", "text"]. Modelos de imagem Gemini recebem dicas de aspectRatio e resolution compatíveis por meio de image_config do OpenRouter. Use agents.defaults.imageGenerationModel.timeoutMs para modelos de imagem do OpenRouter mais lentos; o parâmetro timeoutMs por chamada da ferramenta image_generate ainda prevalece.

# Geração de vídeo

OpenRouter também pode respaldar a ferramenta video_generate por meio de sua API assíncrona /videos. Use um modelo de vídeo do OpenRouter em agents.defaults.videoGenerationModel:

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

OpenClaw envia trabalhos de texto para vídeo e imagem para vídeo para o OpenRouter, faz polling da polling_url retornada e baixa o vídeo concluído a partir de unsigned_urls do OpenRouter ou do endpoint documentado de conteúdo do trabalho. Imagens de referência são enviadas por padrão como imagens do primeiro/último quadro; imagens marcadas com reference_image são enviadas como referências de entrada do OpenRouter. O padrão incluído google/veo-3.1-fast anuncia as durações atualmente compatíveis de 4/6/8 segundos, resoluções 720P/1080P e proporções de aspecto 16:9/9:16. Vídeo para vídeo não é registrado para o OpenRouter porque a API upstream de geração de vídeo atualmente aceita texto e referências de imagem.

# Texto para fala

OpenRouter também pode ser usado como provedor de TTS por meio de seu endpoint /audio/speech compatível com OpenAI.

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

Se messages.tts.providers.openrouter.apiKey for omitido, TTS reutiliza models.providers.openrouter.apiKey e depois OPENROUTER_API_KEY.

# Autenticação e cabeçalhos

OpenRouter usa um token Bearer com sua chave de API por baixo dos panos.

Em solicitações reais ao OpenRouter (https://openrouter.ai/api/v1), OpenClaw também adiciona os cabeçalhos documentados de atribuição de app do OpenRouter:

# Configuração avançada

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

# Relacionado