Providers
ClawRouter
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.
| Properti | Nilai |
|---|---|
| Penyedia | clawrouter |
| Paket | @openclaw/clawrouter |
| Autentikasi | CLAWROUTER_API_KEY |
| URL default | https://clawrouter.openclaw.ai |
| Katalog model | Bercakupan kredensial melalui /v1/catalog |
| Kuota | Anggaran bulanan dan penggunaan melalui /v1/usage |
Memulai
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.
Konfigurasikan OpenClaw
export CLAWROUTER_API_KEY="..."openclaw onboard --auth-choice clawrouter-api-keyopenclaw plugins enable clawrouterPlugin 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.
Cantumkan model yang diberikan
openclaw models list --all --provider clawrouterGunakan 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.
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 katalog | Transport OpenClaw |
|---|---|
| Chat kompatibel OpenAI | openai-completions |
| Responses kompatibel OpenAI | openai-responses |
| Messages Anthropic native | anthropic-messages |
| Streaming Google Gemini native | google-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 --usageopenclaw models statusSnapshot 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
| Gejala | Periksa |
|---|---|
| Tidak ada model ClawRouter | Pastikan Plugin diaktifkan dan diizinkan oleh plugins.allow, lalu periksa bahwa kredensial aktif dan memberikan setidaknya satu penyedia yang siap. |
| Model ClawRouter yang dikonfigurasi hilang | Periksa 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 penggunaan |
Terbitkan ulang atau cakup ulang kredensial ClawRouter; OpenClaw tidak fallback ke kunci penyedia upstream. |
| Panggilan model gagal setelah penemuan | Periksa koneksi penyedia dan kesehatan upstream di ClawRouter, lalu coba lagi setelah status kesiapannya pulih. |
| Penggunaan memiliki total tetapi tidak ada persentase | Kebijakan 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.
