Konfigurasi OpenClaw
OpenClaw adalah alat terminal/Web UI yang ditujukan untuk skenario pemrograman. Alat ini mendukung beberapa protokol model, sehingga fokus konfigurasinya bukan hanya mengisi satu alamat, melainkan mencocokkan baseUrl dan api secara berpasangan.
Informasi resmi Unduhan dan dokumentasi mengacu pada situs resmi.
Mengenal alat ini dan kegunaannya
Pertama, pastikan cara memilih protokol
| Skenario | Cara melihat Base URL | Cara memilih bidang API |
|---|---|---|
| OpenAI Native | Gunakan alamat API OpenAI / kompatibel OpenAI yang disediakan oleh provider, penyertaan /v1 bergantung pada backend | openai-responses |
| Claude Native | Gunakan alamat antarmuka Anthropic / Claude yang disediakan oleh provider | anthropic-messages |
| Gemini Native | Gunakan alamat antarmuka Google / Gemini yang disediakan oleh provider | google-generative-ai |
| Mode Kompatibilitas | Alamat antarmuka kompatibel OpenAI milik provider | openai-completions |
Jika halaman provider memisahkan antarmuka OpenAI, Claude, dan Gemini, jangan hanya menyalin nama domain; salin juga alamat lengkap untuk protokol yang sesuai.
Referensi cuplikan konfigurasi
Berkas konfigurasi biasanya terletak di ~/. openclaw/openclaw.json Jika wizard inisialisasi tidak dapat mengisi alamat provider dengan benar, Anda dapat melewati pemilihan model terlebih dahulu lalu mengedit berkas konfigurasi secara manual.
Cuplikan Contoh Single Provider OpenClaw
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }Cara memeriksa setelah menyimpan
- Pertama, konfigurasikan hanya satu provider, dan jangan langsung menambahkan banyak model sekaligus.
- Masuk ke proyek pengujian dan pilih model yang baru ditambahkan.
- Kirim pertanyaan tersingkat, misalnya 'Harap balas hanya dengan konfigurasi berhasil.'
- Jika terjadi kesalahan protokol, periksa terlebih dahulu apakah bidang api dan Base URL berasal dari jenis antarmuka yang sama.
Pertanyaan Umum untuk Pemula
| Gejala | Pemeriksaan prioritas | Solusi |
|---|---|---|
| Kesalahan terkait protokol | Apakah bidang api cocok dengan Base URL | Jangan mencampuradukkan OpenAI, Claude, dan Gemini; isi sesuai dengan protokol provider terkait |
| Daftar model kosong | Apakah provider mendukung pengambilan daftar model? | Masukkan ID model / nama model yang disediakan backend secara manual jika penarikan gagal |
| Berkas konfigurasi telah diubah tetapi tidak berlaku | Apakah berkas konfigurasi yang sebenarnya dibaca oleh OpenClaw telah diedit | Mulai ulang OpenClaw dan uji kembali; jangan mengubah beberapa pengaturan konfigurasi sekaligus |
| Key sudah benar tetapi tetap gagal | Bidang auth dan apiKey dari Provider saat ini | Pastikan bahwa Key sesuai dengan protokol saat ini dan provider saat ini |
Situs Web Resmi OpenClaw Lihat pengantar dan pintu masuk alat.
Referensi Konfigurasi Provider AI OpenClaw Lihat konsep konfigurasi bidang baseUrl dan api secara berpasangan pada protokol yang berbeda.