Ana içeriğe atla
Bu kılavuz, AI Sonar’yı AI sağlayıcısı olarak bağlamak isteyen self-hosted OpenClaw kullanıcıları içindir.

​
Genel Bakış

Mevcut OpenClaw sürümleri için önerilen yöntem AI Sonar’yı models.providers üzerinden yapılandırmaktır. Hızlıca başlamak istiyorsanız, yalnızca aisonaryı yapılandırmak yeterlidir. Diğer sağlayıcıları yalnızca açıkça Responses API, Claude native, Gemini native veya MiniMax native davranışına ihtiyaç duyduğunuzda ekleyin.
SağlayıcıOpenClaw apiEn uygunbaseUrl
aisonaropenai-completionsGPT, DeepSeek, Qwen ve çoğu OpenAI-uyumlu çağrıhttps://api.aisonar.dev/v1
aisonar-responsesopenai-responses/v1/responses semantiğini bekleyen OpenAI Responses iş akışlarıhttps://api.aisonar.dev/v1
aisonar-claudeanthropic-messagesClaude için yerel Messages API’sihttps://api.aisonar.dev
aisonar-geminigoogle-generative-aiGemini için yerel API formatıhttps://api.aisonar.dev
aisonar-minimaxanthropic-messagesMiniMax için yerel yönlendirmehttps://api.aisonar.dev
Sadece openai-completions ve openai-responses için /v1 son ekini kullanın.anthropic-messages ve google-generative-ai gibi yerel sağlayıcılar https://api.aisonar.dev’yi /v1 olmadan kullanmalıdır; aksi takdirde OpenClaw yanlış üst akış yolunu oluşturabilir.

​
Önkoşullar

  • Bir self-hosted OpenClaw örneği
  • Bir AI Sonar API Key — Get one here

​
Yapılandırma

OpenClaw yapılandırmanızı düzenleyin:
  • Kendi barındırılan: ~/.openclaw/openclaw.json
AI Sonar sağlayıcılarını models.providers altında ekleyin: 
{
  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" }
        ]
      }
    }
  }
}
Tüm 5 sağlayıcı aynı API Key’i kullanır. Sadece bir AI Sonar hesabına ihtiyacınız var.
Yukarıdaki models dizileri sadece yaygın örnekleri gösterir. Gerektikçe her sağlayıcıya daha fazla model ID’si ekleyin.

​
Modellerin Kullanımı

OpenClaw hâlâ modelleri provider/model formatıyla referans gösterir: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
Model Örnekleri

SağlayıcıModel referansıAçıklama
aisonaraisonar/gpt-4oOpenAI-uyumlu rota
aisonaraisonar/deepseek-r1DeepSeek akıl yürütme modeli
aisonar-responsesaisonar-responses/gpt-4oResponses API rotası
aisonar-claudeaisonar-claude/claude-sonnet-4-6Claude Messages için yerel rota
aisonar-geminiaisonar-gemini/gemini-2.5-flashGemini için yerel rota
aisonar-minimaxaisonar-minimax/minimax-m1MiniMax için yerel rota
Mevcut tüm modellere göz atın: aisonar.dev/models.

​
Hangi Sağlayıcı Ne Zaman Kullanılmalı

  • aisonar: çoğu genel amaçlı ajan ve sohbet kullanım durumu için varsayılan seçim.
  • aisonar-responses: OpenClaw iş akışınız açıkça OpenAI Responses semantiğine bağımlıysa kullanın.
  • aisonar-claude: Claude’un yerel Messages davranışını istiyorsanız kullanın.
  • aisonar-gemini: Gemini’ye özgü istek/yanıt formatlaması veya mevcut Gemini tarzı entegrasyonlar istiyorsanız kullanın.
  • aisonar-minimax: MiniMax’i yerel rotasında kullanmak istiyorsanız tercih edin.
Gemini’ye özgü davranışa ihtiyacınız yoksa, Gemini modellerini yine de OpenAI-uyumlu rota üzerinden aisonar/gemini-* ile çağırabilirsiniz.

​
Yaygın Hatalar

Güncel OpenClaw dokümantasyonu models.providers kullanır. Eski üst düzey providers dizi formatını kullanmaya devam ederseniz, OpenClaw yapılandırmayı yok sayabilir veya sağlayıcı ön eklerini beklenildiği gibi çözemeyebilir.
openai-responses AI Sonar’nın /v1/responses yoluna eşlenir, bu nedenle aisonar-responses https://api.aisonar.dev/v1 kullanmalıdır.
anthropic-messages ve google-generative-ai /v1 olmadan https://api.aisonar.dev kullanmalıdır. /v1 eklemek yanlış istek yolları üretebilir.
Evet. Güncel OpenClaw dokümantasyonu hâlâ dahili google sağlayıcısını içerir ve ayrıca api: "google-generative-ai" kullanan özel sağlayıcıları da destekler. Bu yüzden aisonar-gemini OpenClaw kullanıcıları için geçerli bir native Gemini rotası olmaya devam eder.

​
Kurulumu Doğrulama

Yapılandırmayı kaydettikten sonra OpenClaw örneğinizi yeniden başlatın ve basit bir mesajla test edin. Bir yanıt görüyorsanız, sağlayıcı doğru şekilde yapılandırılmış demektir. 
# Kendi barındırılan: servisi yeniden başlat
systemctl --user restart openclaw    # Linux
launchctl stop cc.aisonar.openclaw && launchctl start cc.aisonar.openclaw  # macOS

​
Sonraki Adımlar

OpenClaw bağlandıktan sonra, bu rehberler AI Sonar’yı daha etkili kullanmanıza yardımcı olur: