Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

Bu kılavuz, LemonData’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 LemonData’yı models.providers üzerinden yapılandırmaktır. Hızlıca başlamak istiyorsanız, yalnızca lemondatayı 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
lemondataopenai-completionsGPT, DeepSeek, Qwen ve çoğu OpenAI-uyumlu çağrıhttps://api.lemondata.cc/v1
lemondata-responsesopenai-responses/v1/responses semantiğini bekleyen OpenAI Responses iş akışlarıhttps://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesClaude için yerel Messages API’sihttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiGemini için yerel API formatıhttps://api.lemondata.cc
lemondata-minimaxanthropic-messagesMiniMax için yerel yönlendirmehttps://api.lemondata.cc
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.lemondata.cc’yi /v1 olmadan kullanmalıdır; aksi takdirde OpenClaw yanlış üst akış yolunu oluşturabilir.

Önkoşullar

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

Yapılandırma

OpenClaw yapılandırmanızı düzenleyin:
  • Self-hosted: ~/.openclaw/openclaw.json
LemonData sağlayıcılarını models.providers altında 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" }
        ]
      }
    }
  }
}
Tüm 5 sağlayıcı aynı API Key’i kullanır. Sadece bir LemonData 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: "lemondata-gemini/gemini-2.5-flash"
      }
    }
  }
}

Model Örnekleri

SağlayıcıModel 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 için yerel rota
lemondata-geminilemondata-gemini/gemini-2.5-flashGemini için yerel rota
lemondata-minimaxlemondata-minimax/minimax-m1MiniMax için yerel rota
Mevcut tüm modellere göz atın: lemondata.cc/models.

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

  • lemondata: çoğu genel amaçlı ajan ve sohbet kullanım durumu için varsayılan seçim.
  • lemondata-responses: OpenClaw iş akışınız açıkça OpenAI Responses semantiğine bağımlıysa kullanın.
  • lemondata-claude: Claude’un yerel Messages davranışını istiyorsanız kullanın.
  • lemondata-gemini: Gemini’ye özgü istek/yanıt formatlaması veya mevcut Gemini tarzı entegrasyonlar istiyorsanız kullanın.
  • lemondata-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 lemondata/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 LemonData’nın /v1/responses yoluna eşlenir, bu nedenle lemondata-responses 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ı ü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 lemondata-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.
# Self-hosted: restart the service
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

Sonraki Adımlar

OpenClaw bağlandıktan sonra, bu rehberler LemonData’yı daha etkili kullanmanıza yardımcı olur:
  • API Formats — OpenAI, Responses, Anthropic ve Gemini yolları arasındaki farkları anlayın
  • IDE / SDK Compatibility/v1/responses’in ne zaman daha uygun olduğunu görün
  • Error Handling — yaygın başarısızlık modlarını ve toparlanma desenlerini öğrenin
  • Models Overview — ajanlara bağlamadan önce model ID’lerini inceleyin