ai2saveai2save

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
  1. Buka https://ai2save.com/keys.
  2. Buat Kunci API milik dari grup model OpenAI / GPT.
  3. 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 adalah provider-id/model-id.
  • apiKey dapat secara langsung menulis "sk-..."; ketika direferensikan dengan ${AI2SAVE_API_KEY}, ini harus didefinisikan dalam env.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

  1. Buka antarmuka obrolan atau WebChat bagi OpenClaw.
  2. Mulai percakapan baru dan kirim "Halo, silakan laporkan nama model saat ini"
  3. Konfirmasikan bahwa rute model menunjukkan sebagai ai2save/gpt-5.5.
  4. 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_KEY tidak 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 baseUrl adalah https://ai2save.com/v1, dan jangan tulis alamat root.
  • Daftar model kosong: Konfirmasi models.mode: "merge", dan memastikan bahwa models.providers.ai2save.models[] berisi paling tidak satu model.
  • Konfigurasi tidak berlaku setelah menyimpan: Jalankan ulang openclaw doctor, dan jika perlu, restart OpenClaw dan Gateway.