Ana içeriğe atla
Bu rehber, LemonData’yı AI provider olarak bağlamak isteyen self-hosted OpenClaw kullanıcıları içindir.
Daha çok barındırılan bir çözüm istiyorsanız bir LemonClaw instance’ı oluşturun. LemonData varsayılan olarak zaten yapılandırılmıştır; bu yüzden doğrudan WebUI üzerinden başlayabilirsiniz.

​
Genel Bakış

Güncel OpenClaw sürümlerinde LemonData’yı bağlamanın önerilen yolu models.providers kullanmaktır. Sadece hızlıca başlamak istiyorsanız tek başına lemondata yeterlidir. Diğer provider’ları yalnızca Responses API, yerel Claude, yerel Gemini veya yerel MiniMax davranışına ihtiyaç duyduğunuzda ekleyin.
ProviderOpenClaw apiEn uygun kullanımbaseUrl
lemondataopenai-completionsGPT, DeepSeek, Qwen ve OpenAI uyumlu çağrıların çoğuhttps://api.lemondata.cc/v1
lemondata-responsesopenai-responses/v1/responses semantiği bekleyen OpenAI Responses iş akışlarıhttps://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesClaude’un yerel Messages API’sihttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiGemini’nin yerel API formatıhttps://api.lemondata.cc
lemondata-minimaxanthropic-messagesMiniMax’in yerel rotasıhttps://api.lemondata.cc
/v1 son ekini yalnızca openai-completions ve openai-responses için kullanın.anthropic-messages ve google-generative-ai gibi yerel provider’lar /v1 olmadan https://api.lemondata.cc kullanmalıdır; aksi halde OpenClaw yanlış upstream yolu oluşturabilir.

​
Ön Koşullar

  • Bir self-hosted OpenClaw instance’ı
  • Bir LemonData API Key — buradan alın

​
Yapılandırma

OpenClaw yapılandırmanızı düzenleyin:
  • Self-hosted: ~/.openclaw/openclaw.json
LemonData provider’larını models.providers altına ekleyin: 
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      lemondata: {
        api: "openai-completions",
        baseUrl: "https://api.lemondata.cc/v1",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-32b", name: "Qwen 3 32B" }
        ]
      },
      "lemondata-responses": {
        api: "openai-responses",
        baseUrl: "https://api.lemondata.cc/v1",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "lemondata-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.lemondata.cc",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "lemondata-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.lemondata.cc",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "lemondata-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.lemondata.cc",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
5 provider’ın tamamı aynı API key’i kullanır. Yalnızca tek bir LemonData hesabına ihtiyacınız vardır.
Yukarıdaki models dizileri sadece yaygın örnekleri gösterir. Gerektikçe her provider’a daha fazla model ID ekleyebilirsiniz.

​
Model Kullanımı

OpenClaw model referansı için hâlâ provider/model formatını kullanır: 
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
Model Örnekleri

ProviderModel referansıAçıklama
lemondatalemondata/gpt-4oOpenAI uyumlu rota
lemondatalemondata/deepseek-r1DeepSeek akıl yürütme modeli
lemondata-responseslemondata-responses/gpt-4oResponses API rotası
lemondata-claudelemondata-claude/claude-sonnet-4-6Claude Messages yerel rotası
lemondata-geminilemondata-gemini/gemini-2.5-flashGemini yerel rotası
lemondata-minimaxlemondata-minimax/minimax-m1MiniMax yerel rotası
Tüm kullanılabilir modelleri lemondata.cc/models adresinde görebilirsiniz.

​
Hangi Provider Ne Zaman Kullanılır?

  • lemondata: çoğu genel chat ve agent senaryosu için varsayılan seçim.
  • lemondata-responses: OpenClaw iş akışınız OpenAI Responses semantiğine açıkça bağlıysa kullanın.
  • lemondata-claude: Claude Messages’ın yerel davranışını istediğinizde kullanın.
  • lemondata-gemini: Gemini’nin yerel formatını veya Gemini için tasarlanmış mevcut entegrasyonları istediğinizde kullanın.
  • lemondata-minimax: MiniMax’i yerel rotası üzerinden kullanmak istediğinizde kullanın.
Gemini’nin yerel davranışına ihtiyacınız yoksa, Gemini modellerini lemondata/gemini-* üzerinden OpenAI uyumlu rotada çağırmaya devam edebilirsiniz.

​
Yaygın Hatalar

Güncel OpenClaw belgeleri models.providers kullanır. Üst seviyedeki eski providers formatında kalırsanız, OpenClaw yapılandırmayı yok sayabilir veya provider öneklerini beklediğiniz gibi çözemeyebilir.
openai-responses, LemonData’nın /v1/responses yoluna gider; bu yüzden lemondata-responses mutlaka https://api.lemondata.cc/v1 kullanmalıdır.
anthropic-messages ve google-generative-ai /v1 olmadan https://api.lemondata.cc kullanmalıdır. /v1 eklemek yanlış istek yolları oluşturabilir.
Evet. Güncel OpenClaw belgeleri hâlâ yerleşik google provider’ını içeriyor ve api: "google-generative-ai" kullanan özel provider’ları da destekliyor. Bu nedenle lemondata-gemini, OpenClaw kullanıcıları için hâlâ geçerli bir yerel Gemini rotasıdır.

​
Yapılandırmayı Doğrulama

Yapılandırmayı kaydettikten sonra OpenClaw instance’ınızı yeniden başlatın ve basit bir mesajla test edin. Yanıt alırsanız provider doğru şekilde yapılandırılmış demektir. 
# Self-hosted: servisi yeniden başlat
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

​
Sonraki Adımlar

OpenClaw bağlandıktan sonra, şu rehberler LemonData’yı daha verimli kullanmanıza yardımcı olur:
  • API Formats — OpenAI, Responses, Anthropic ve Gemini rotaları arasındaki farkları anlayın
  • IDE / SDK Compatibility — /v1/responses ne zaman daha uygun görün
  • Error Handling — yaygın hata türlerini ve kurtarma yollarını öğrenin
  • Modellere Genel Bakış — modelleri agent’lara bağlamadan önce kullanılabilir model ID’lerini inceleyin