OpenRouter

OpenRouter 提供統一 API，可透過單一端點和 API 金鑰將請求路由到許多模型。它相容於 OpenAI，因此大多數 OpenAI SDK 只要切換基礎 URL 即可使用。

# 開始使用

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

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

# 設定範例

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

# 模型參照

內建後援範例：

# 圖像生成

OpenRouter 也可以支援 image_generate 工具。請在 agents.defaults.imageGenerationModel 下使用 OpenRouter 圖像模型：

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

OpenClaw 會使用 modalities: ["image", "text"] 將圖像請求傳送到 OpenRouter 的 chat completions 圖像 API。Gemini 圖像模型會透過 OpenRouter 的 image_config 接收支援的 aspectRatio 和 resolution 提示。對於較慢的 OpenRouter 圖像模型，請使用 agents.defaults.imageGenerationModel.timeoutMs；image_generate 工具每次呼叫的 timeoutMs 參數仍會優先套用。

# 影片生成

OpenRouter 也可以透過其非同步 /videos API 支援 video_generate 工具。請在 agents.defaults.videoGenerationModel 下使用 OpenRouter 影片模型：

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

OpenClaw 會將文字轉影片和圖像轉影片工作提交給 OpenRouter，輪詢傳回的 polling_url，並從 OpenRouter 的 unsigned_urls 或記載的工作內容端點下載完成的影片。參考圖像預設會作為首格/末格圖像傳送；標記為 reference_image 的圖像會作為 OpenRouter 輸入參考傳送。內建的 google/veo-3.1-fast 預設會宣告目前支援的 4/6/8 秒長度、720P/1080P 解析度，以及 16:9/9:16 長寬比。OpenRouter 未註冊影片轉影片，因為上游影片生成 API 目前接受文字與圖像參考。

# 文字轉語音

OpenRouter 也可以透過其相容 OpenAI 的 /audio/speech 端點作為 TTS provider 使用。

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

如果省略 messages.tts.providers.openrouter.apiKey，TTS 會重用 models.providers.openrouter.apiKey，再使用 OPENROUTER_API_KEY。

# 驗證與標頭

OpenRouter 底層會使用搭配你 API 金鑰的 Bearer token。

在實際的 OpenRouter 請求（https://openrouter.ai/api/v1）上，OpenClaw 也會加入 OpenRouter 文件記載的應用程式歸因標頭：

# 進階設定

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

# 相關