Panduan konfigurasi OpenClaw
OpenClaw menambahkan model penyedia custom melalui models.providers. ai2save menggunakan antar muka kompatibel OpenAI, dan URL Dasar harus diisi https://ai2save.com/v1.
1. Siapkan OpenClaw dan kunci API
Bila OpenClaw telah terpasang, Anda dapat melewatkan instalasi:
npm install -g openclaw@latest
openclaw --version
- Buka https://ai2save.com/keys.
- Buat Kunci API milik dari grup model OpenAI / GPT.
- Salin komplit
sk-...Kunci.
2. Edit file konfigurasi OpenClaw
Berkas konfigurasi baku untuk OpenClaw adalah:
~/.openclaw/openclaw.json
Windows biasanya mendukung JSON5 di %USERPROFILE%\.openclaw\openclaw.json. berkas, yang dapat digabung ke dalam konfigurasi yang telah ada menurut struktur di bawah:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-your-api-key",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
Keterangan Ruas Kunci:
models.providers.ai2save.baseUrl: Harus termasuk/v1.api: "openai-completions": Tipe antar muka yang dipakai oleh OpenClaw untuk memproksi Kompatibel OpenAI.models[].id: Harus persis konsisten dengan ID model dibuka dalam konsol ai2save.agents.defaults.model.primary: Format adalahprovider-id/model-id.apiKeydapat secara langsung menulis"sk-..."; ketika direferensikan dengan${AI2SAVE_API_KEY}, ini harus didefinisikan dalamenv.vars.
Jika Anda ingin menambahkan beberapa model, terus tambahkan di models array dan perubahan primary ke ai2save/model-id anda ingin menggunakan secara baku.
3. Terapkan dan periksa konfigurasi
Gateway OpenClaw akan mendengarkan perubahan berkas konfigurasi dan menerapkannya secara otomatis. Bila konfigurasi tidak berlaku segera, jalankan:
openclaw gateway restart
Kemudian periksa apakah model telah muncul dalam OpenClaw:
openclaw models list --provider ai2save
Tukar model baku ke ai2save:
openclaw models set ai2save/gpt-5.5
Jika model tidak muncul, jalankan diagnosa dan periksa kesalahan konfigurasi:
openclaw doctor
4. Verifikasi permintaan
- Buka antarmuka obrolan atau WebChat bagi OpenClaw.
- Mulai percakapan baru dan kirim "Halo, silakan laporkan nama model saat ini"
- Konfirmasikan bahwa rute model menunjukkan sebagai
ai2save/gpt-5.5. - Untuk pertama kalinya, hanya verifikasi dengan tugas-tugas teks. Setelah berhasil, kemudian mengaktifkan lebih banyak alat kompleks seperti penanganan berkas, peramban, dan konteks panjang.
OpenClaw secara otomatis akan menangani kompatibilitas proksi OpenAI tidak resmi, jadi tidak perlu secara manual aktif developer role. Jika ada pengecualian dengan panggilan alat, pertama konfirmasi bahwa ID model mendukung panggilan perangkat, kemudian tingkatkan waktu.
5. Kesalahan umum
- 401 / invalid _ api _ key:
AI2SAVE_API_KEYtidak didefinisikan, kunci tidak sepenuhnya disalin, atau pengelompokan kunci tidak cocok. - 404 / model tidak ditemukan:
models[].id,primary, atau nama model yang diminta sebenarnya tidak cocok. - Koneksi gagal / respon kosong: Periksa apakah
baseUrladalahhttps://ai2save.com/v1, dan jangan tulis alamat root. - Daftar model kosong: Konfirmasi
models.mode: "merge", dan memastikan bahwamodels.providers.ai2save.models[]berisi paling tidak satu model. - Konfigurasi tidak berlaku setelah menyimpan: Jalankan ulang
openclaw doctor, dan jika perlu, restart OpenClaw dan Gateway.