Langsung ke konten utama
ClawRouter memberi OpenClaw satu kunci bercakupan kebijakan untuk beberapa penyedia model upstream. Plugin bawaan hanya menemukan model yang diizinkan untuk kunci tersebut, merutekan setiap model melalui protokol yang dideklarasikannya, dan melaporkan anggaran kunci serta penggunaan agregat pada permukaan penggunaan OpenClaw. Anda tidak perlu memasang atau mengautentikasi setiap Plugin penyedia upstream pada host OpenClaw. Kredensial upstream dan penerusan khusus penyedia tetap berada di ClawRouter. OpenClaw hanya memerlukan Plugin @openclaw/clawrouter bawaan dan kredensial ClawRouter yang diterbitkan.
PropertiNilai
Penyediaclawrouter
Paket@openclaw/clawrouter
AutentikasiCLAWROUTER_API_KEY
URL defaulthttps://clawrouter.openclaw.ai
Katalog modelBercakupan kredensial melalui /v1/catalog
KuotaAnggaran bulanan dan penggunaan melalui /v1/usage

​
Memulai

1

Dapatkan kredensial bercakupan

Minta administrator ClawRouter Anda untuk kredensial yang kebijakannya mencakup penyedia, model, dan anggaran bulanan yang seharusnya Anda gunakan. Kredensial ditampilkan satu kali saat diterbitkan.
2

Konfigurasikan OpenClaw

export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
Plugin ini dibundel dengan OpenClaw. Jika konfigurasi Anda menetapkan plugins.allow, tambahkan clawrouter ke daftar tersebut sebelum mengaktifkannya. Untuk deployment kustom, tetapkan models.providers.clawrouter.baseUrl ke origin ClawRouter; defaultnya adalah https://clawrouter.openclaw.ai.
3

Cantumkan model yang diberikan

openclaw models list --all --provider clawrouter
Gunakan referensi model yang dikembalikan persis seperti yang ditampilkan. Referensi tersebut mempertahankan namespace upstream, seperti clawrouter/openai/..., clawrouter/anthropic/..., atau clawrouter/google/.... Jika agents.defaults.models adalah allowlist dalam konfigurasi Anda, tambahkan setiap referensi ClawRouter yang dipilih ke sana.
4

Pilih model

openclaw models set clawrouter/<provider>/<model>
Anda juga dapat memilih model yang dikembalikan untuk satu kali eksekusi dengan openclaw agent --model clawrouter/<provider>/<model> --message "...".

​
Penemuan model

GET /v1/catalog adalah sumber kebenaran. OpenClaw tidak mengirimkan daftar kedua yang tetap untuk model ClawRouter. Model yang dikonfigurasi di ClawRouter muncul ketika:
  • kebijakan kredensial memberikan akses ke penyedianya;
  • koneksi penyedia diaktifkan dan siap;
  • model katalog mengiklankan kapabilitas LLM yang didukung; dan
  • katalog mengekspos kontrak transport yang didukung oleh Plugin.
Karena itu, menambahkan model lain ke penyedia ClawRouter yang didukung tidak memerlukan rilis OpenClaw atau Plugin penyedia lain. Penyegaran katalog berikutnya akan menemukannya. Model yang memerlukan protokol wire baru memerlukan dukungan di Plugin ClawRouter sebelum OpenClaw mengiklankannya.

​
Protokol dan Plugin penyedia

Anda tidak perlu memasang Plugin autentikasi setiap perusahaan upstream. ClawRouter memiliki kredensial upstream; katalognya memberi tahu OpenClaw transport mana yang harus digunakan. Plugin mendukung:
Rute katalogTransport OpenClaw
Chat kompatibel OpenAIopenai-completions
Responses kompatibel OpenAIopenai-responses
Messages Anthropic nativeanthropic-messages
Streaming Google Gemini nativegoogle-generative-ai
Plugin juga menerapkan kebijakan replay dan skema alat yang sesuai untuk keluarga tersebut. Baris katalog yang menggunakan format permintaan/stream lain sengaja tidak diiklankan sebagai model teks OpenClaw. Normalisasikan penyedia tersebut ke salah satu kontrak yang didukung di ClawRouter, bukan mengirim payload yang tidak kompatibel.

​
Kuota dan penggunaan

Respons /v1/usage ClawRouter mengisi permukaan penggunaan penyedia OpenClaw normal. /status dan status dasbor terkait menampilkan jendela anggaran bulanan ketika kunci memiliki batas, ditambah total permintaan, token, dan pengeluaran. Kunci tanpa meter tetap menampilkan penggunaan agregat tanpa jendela persentase. Pencarian kuota menggunakan kunci bercakupan yang sama dengan penemuan model. Kegagalan pencarian kuota tidak memblokir eksekusi model. Periksa snapshot live dengan: 
openclaw status --usage
openclaw models status
Snapshot penyedia yang sama tersedia untuk /status di chat dan UI penggunaan OpenClaw. Anggaran berlaku di seluruh kebijakan, jadi permintaan yang dibuat oleh klien lain menggunakan kebijakan ClawRouter yang sama dapat mengubah persentase yang tersisa.

​
Pemecahan masalah

GejalaPeriksa
Tidak ada model ClawRouterPastikan Plugin diaktifkan dan diizinkan oleh plugins.allow, lalu periksa bahwa kredensial aktif dan memberikan setidaknya satu penyedia yang siap.
Model ClawRouter yang dikonfigurasi hilangPeriksa kapabilitas dan format rute /v1/catalog-nya. Kontrak transport yang tidak didukung sengaja difilter.
Unknown model: clawrouter/...Tambahkan referensi katalog persis ke agents.defaults.models ketika peta konfigurasi tersebut digunakan sebagai allowlist.
401 atau 403 dari katalog atau penggunaanTerbitkan ulang atau cakup ulang kredensial ClawRouter; OpenClaw tidak fallback ke kunci penyedia upstream.
Panggilan model gagal setelah penemuanPeriksa koneksi penyedia dan kesehatan upstream di ClawRouter, lalu coba lagi setelah status kesiapannya pulih.
Penggunaan memiliki total tetapi tidak ada persentaseKebijakan tidak bermeter; tambahkan anggaran bulanan di ClawRouter untuk mengekspos jendela persentase.

​
Perilaku keamanan

  • Penemuan katalog dicakup ke kunci proxy yang dikonfigurasi dan di-cache per kunci.
  • Kunci proxy hanya dilampirkan saat pengiriman permintaan; kunci tersebut tidak disimpan dalam metadata model.
  • ID model Anthropic dan Gemini native ditulis ulang ke ID upstream masing-masing hanya saat pengiriman.
  • Baris katalog yang tidak didukung atau tidak diberikan gagal tertutup dan tidak dapat dipilih.

​
Terkait

Penyedia model

Konfigurasi penyedia dan pemilihan model.

Pelacakan penggunaan

Permukaan penggunaan dan status OpenClaw.