Langsung ke konten utama
Panduan ini ditujukan untuk pengguna self-hosted OpenClaw yang ingin menghubungkan AI Sonar sebagai penyedia AI mereka.

​
Ikhtisar

Untuk versi OpenClaw saat ini, pendekatan yang direkomendasikan adalah mengonfigurasi AI Sonar melalui models.providers. Jika Anda hanya ingin mulai dengan cepat, mengonfigurasi aisonar saja sudah cukup. Tambahkan penyedia lain hanya ketika Anda secara eksplisit membutuhkan perilaku Responses API, Claude native, Gemini native, atau MiniMax native.
PenyediaOpenClaw apiCocok untukbaseUrl
aisonaropenai-completionsGPT, DeepSeek, Qwen, dan sebagian besar panggilan yang kompatibel dengan OpenAIhttps://api.aisonar.dev/v1
aisonar-responsesopenai-responsesAlur kerja OpenAI Responses yang mengharapkan semantik /v1/responseshttps://api.aisonar.dev/v1
aisonar-claudeanthropic-messagesAPI Pesan Claude Nativehttps://api.aisonar.dev
aisonar-geminigoogle-generative-aiFormat API Gemini nativehttps://api.aisonar.dev
aisonar-minimaxanthropic-messagesRouting MiniMax nativehttps://api.aisonar.dev
Gunakan sufiks /v1 hanya untuk openai-completions dan openai-responses.Penyedia native seperti anthropic-messages dan google-generative-ai harus menggunakan https://api.aisonar.dev tanpa /v1, jika tidak OpenClaw mungkin menyusun path upstream yang salah.

​
Prasyarat

​
Konfigurasi

Edit konfigurasi OpenClaw Anda:
  • Hosting sendiri: ~/.openclaw/openclaw.json
Tambahkan penyedia AI Sonar di bawah models.providers: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      aisonar: {
        api: "openai-completions",
        baseUrl: "https://api.aisonar.dev/v1",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-32b", name: "Qwen 3 32B" }
        ]
      },
      "aisonar-responses": {
        api: "openai-responses",
        baseUrl: "https://api.aisonar.dev/v1",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "aisonar-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "aisonar-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "aisonar-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
Kelima penyedia menggunakan API Key yang sama. Anda hanya membutuhkan satu akun AI Sonar.
Array models di atas hanya menampilkan contoh umum. Tambahkan lebih banyak ID model ke masing-masing penyedia sesuai kebutuhan.

​
Menggunakan Model

OpenClaw masih merujuk model dengan format provider/model: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
Contoh Model

PenyediaReferensi modelDeskripsi
aisonaraisonar/gpt-4oRute yang kompatibel dengan OpenAI
aisonaraisonar/deepseek-r1Model penalaran DeepSeek
aisonar-responsesaisonar-responses/gpt-4oRute Responses API
aisonar-claudeaisonar-claude/claude-sonnet-4-6Rute native Claude Messages
aisonar-geminiaisonar-gemini/gemini-2.5-flashRute native Gemini
aisonar-minimaxaisonar-minimax/minimax-m1Rute native MiniMax
Telusuri semua model yang tersedia di aisonar.dev/models.

​
Kapan Menggunakan Penyedia Mana

  • aisonar: pilihan default untuk sebagian besar kasus penggunaan agen dan obrolan umum.
  • aisonar-responses: gunakan ketika alur kerja OpenClaw Anda secara eksplisit bergantung pada semantik OpenAI Responses.
  • aisonar-claude: gunakan ketika Anda menginginkan perilaku Messages native Claude.
  • aisonar-gemini: gunakan ketika Anda menginginkan pemformatan permintaan/respon native Gemini atau integrasi bergaya Gemini yang sudah ada.
  • aisonar-minimax: gunakan ketika Anda menginginkan MiniMax melalui rute native-nya.
Jika Anda tidak memerlukan perilaku Gemini-native, Anda masih dapat memanggil model Gemini melalui aisonar/gemini-* pada rute yang kompatibel dengan OpenAI.

​
Kesalahan Umum

Dokumentasi OpenClaw saat ini menggunakan models.providers. Jika Anda mempertahankan format array providers tingkat atas yang lebih lama, OpenClaw mungkin mengabaikan konfigurasi atau gagal menyelesaikan prefix penyedia sebagaimana diharapkan.
openai-responses memetakan ke path /v1/responses di AI Sonar, jadi aisonar-responses harus menggunakan https://api.aisonar.dev/v1.
anthropic-messages dan google-generative-ai harus menggunakan https://api.aisonar.dev tanpa /v1. Menambahkan /v1 dapat menghasilkan path permintaan yang tidak benar.
Ya. Dokumentasi OpenClaw saat ini masih menyertakan penyedia bawaan google dan juga mendukung penyedia kustom yang menggunakan api: "google-generative-ai". Jadi aisonar-gemini tetap menjadi rute Gemini native yang valid bagi pengguna OpenClaw.

​
Verifikasi Pengaturan

Setelah menyimpan konfigurasi, restart instance OpenClaw Anda dan uji dengan pesan sederhana. Jika Anda melihat respons, penyedia dikonfigurasi dengan benar. 
# Hosting sendiri: mulai ulang layanan
systemctl --user restart openclaw    # Linux
launchctl stop cc.aisonar.openclaw && launchctl start cc.aisonar.openclaw  # macOS

​
Langkah Selanjutnya

Setelah OpenClaw tersambung, panduan berikut membantu Anda menggunakan AI Sonar dengan lebih efektif: