Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenRouter menyediakan API terpadu yang merutekan permintaan ke banyak model di balik satu endpoint dan kunci API. Ini kompatibel dengan OpenAI, sehingga sebagian besar SDK OpenAI berfungsi dengan mengganti URL dasar.

​
Memulai

1

Get your API key

Buat kunci API di openrouter.ai/keys.
2

Run onboarding

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

(Optional) Switch to a specific model

Onboarding menggunakan default openrouter/auto. Pilih model konkret nanti:
openclaw models set openrouter/<provider>/<model>

​
Contoh konfigurasi

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

​
Referensi model

Ref model mengikuti pola openrouter/<provider>/<model>. Untuk daftar lengkap penyedia dan model yang tersedia, lihat /concepts/model-providers.
Contoh fallback bawaan:
Ref modelCatatan
openrouter/autoPerutean otomatis OpenRouter
openrouter/moonshotai/kimi-k2.6Kimi K2.6 via MoonshotAI
openrouter/moonshotai/kimi-k2.5Kimi K2.5 via MoonshotAI

​
Pembuatan gambar

OpenRouter juga dapat mendukung alat image_generate. Gunakan model gambar OpenRouter di bawah 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 mengirim permintaan gambar ke API gambar chat completions OpenRouter dengan modalities: ["image", "text"]. Model gambar Gemini menerima petunjuk aspectRatio dan resolution yang didukung melalui image_config OpenRouter. Gunakan agents.defaults.imageGenerationModel.timeoutMs untuk model gambar OpenRouter yang lebih lambat; parameter timeoutMs per panggilan milik alat image_generate tetap diutamakan.

​
Pembuatan video

OpenRouter juga dapat mendukung alat video_generate melalui API asinkron /videos miliknya. Gunakan model video OpenRouter di bawah agents.defaults.videoGenerationModel: 
{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "openrouter/google/veo-3.1-fast",
      },
    },
  },
}
OpenClaw mengirim tugas teks-ke-video dan gambar-ke-video ke OpenRouter, melakukan polling pada polling_url yang dikembalikan, dan mengunduh video yang selesai dari unsigned_urls OpenRouter atau endpoint konten tugas yang terdokumentasi. Gambar referensi dikirim sebagai gambar bingkai pertama/terakhir secara default; gambar yang ditandai dengan reference_image dikirim sebagai referensi input OpenRouter. Default bawaan google/veo-3.1-fast mengiklankan durasi 4/6/8 detik yang saat ini didukung, resolusi 720P/1080P, dan rasio aspek 16:9/9:16. Video-ke-video tidak didaftarkan untuk OpenRouter karena API pembuatan video upstream saat ini menerima teks dan referensi gambar.

​
Teks-ke-ucapan

OpenRouter juga dapat digunakan sebagai penyedia TTS melalui endpoint /audio/speech yang kompatibel dengan OpenAI. 
{
  messages: {
    tts: {
      auto: "always",
      provider: "openrouter",
      providers: {
        openrouter: {
          model: "hexgrad/kokoro-82m",
          voice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}
Jika messages.tts.providers.openrouter.apiKey dihilangkan, TTS menggunakan kembali models.providers.openrouter.apiKey, lalu OPENROUTER_API_KEY.

​
Ucapan-ke-teks (audio masuk)

OpenRouter dapat mentranskripsikan lampiran suara/audio masuk melalui jalur bersama tools.media.audio menggunakan endpoint STT miliknya (/audio/transcriptions). Ini berlaku untuk Plugin kanal apa pun yang meneruskan suara/audio masuk ke pra-pemeriksaan pemahaman media. 
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],
      },
    },
  },
}
OpenClaw mengirim permintaan STT OpenRouter sebagai JSON dengan audio base64 di bawah input_audio (kontrak STT OpenRouter), bukan sebagai unggahan formulir multipart OpenAI.

​
Autentikasi dan header

OpenRouter menggunakan token Bearer dengan kunci API Anda di balik layar. Pada permintaan OpenRouter sungguhan (https://openrouter.ai/api/v1), OpenClaw juga menambahkan header atribusi aplikasi yang terdokumentasi oleh OpenRouter:
HeaderNilai
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent
Jika Anda mengarahkan ulang penyedia OpenRouter ke proksi atau URL dasar lain, OpenClaw tidak menyuntikkan header khusus OpenRouter tersebut atau penanda cache Anthropic.

​
Konfigurasi lanjutan

Caching respons OpenRouter bersifat opt-in. Aktifkan per model OpenRouter dengan parameter model:
{
  agents: {
    defaults: {
      models: {
        "openrouter/auto": {
          params: {
            responseCache: true,
            responseCacheTtlSeconds: 300,
          },
        },
      },
    },
  },
}
OpenClaw mengirim X-OpenRouter-Cache: true dan, saat dikonfigurasi, X-OpenRouter-Cache-TTL. responseCacheClear: true memaksa penyegaran untuk permintaan saat ini dan menyimpan respons pengganti. Alias snake_case (response_cache, response_cache_ttl_seconds, dan response_cache_clear) juga diterima.Ini terpisah dari caching prompt penyedia dan dari penanda cache_control Anthropic milik OpenRouter. Ini hanya diterapkan pada rute openrouter.ai terverifikasi, bukan URL dasar proksi kustom.
Pada rute OpenRouter terverifikasi, ref model Anthropic mempertahankan penanda cache_control Anthropic khusus OpenRouter yang digunakan OpenClaw untuk penggunaan ulang cache prompt yang lebih baik pada blok prompt sistem/pengembang.
Pada rute OpenRouter terverifikasi, ref model Anthropic dengan reasoning diaktifkan menghapus giliran prefill asisten di akhir sebelum permintaan mencapai OpenRouter, sesuai dengan persyaratan Anthropic bahwa percakapan reasoning berakhir dengan giliran pengguna.
Pada rute non-auto yang didukung, OpenClaw memetakan level thinking yang dipilih ke payload reasoning proksi OpenRouter. Petunjuk model yang tidak didukung dan openrouter/auto melewati injeksi reasoning tersebut. Hunter Alpha juga melewati reasoning proksi untuk ref model terkonfigurasi yang kedaluwarsa karena OpenRouter dapat mengembalikan teks jawaban akhir dalam kolom reasoning untuk rute yang telah dihentikan tersebut.
Pada rute OpenRouter terverifikasi, openrouter/deepseek/deepseek-v4-flash dan openrouter/deepseek/deepseek-v4-pro mengisi reasoning_content yang hilang pada giliran asisten yang diputar ulang agar percakapan thinking/alat mempertahankan bentuk tindak lanjut yang diperlukan DeepSeek V4. OpenClaw mengirim nilai reasoning_effort yang didukung OpenRouter untuk rute ini; xhigh adalah level tertinggi yang diiklankan, dan override max yang kedaluwarsa dipetakan ke xhigh.
OpenRouter tetap berjalan melalui jalur kompatibel OpenAI bergaya proksi, sehingga pembentukan permintaan khusus OpenAI native seperti serviceTier, Responses store, payload kompatibilitas reasoning OpenAI, dan petunjuk cache prompt tidak diteruskan.
Ref OpenRouter yang didukung Gemini tetap berada di jalur proksi-Gemini: OpenClaw mempertahankan sanitasi tanda tangan pemikiran Gemini di sana, tetapi tidak mengaktifkan validasi replay Gemini native atau penulisan ulang bootstrap.
Jika Anda meneruskan perutean penyedia OpenRouter di bawah parameter model, OpenClaw meneruskannya sebagai metadata perutean OpenRouter sebelum wrapper stream bersama berjalan.

​
Terkait

Model selection

Memilih penyedia, ref model, dan perilaku failover.

Configuration reference

Referensi konfigurasi lengkap untuk agent, model, dan penyedia.