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

​
Önerilen: eklentiyi yükleyin

Standart OpenClaw agent çalıştırma için TokenLab sağlayıcı eklentisini yükleyin: 
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
Eklenti, TokenLab’ın canlı sohbet modeli kataloğunu getirir ve çevrimdışı keşif için 18 yedek model tutar. Modeller tokenlab/<model-id> biçimini kullanır. npm paketi · ClawHub kaydı · Kaynak kod

​
Manuel sağlayıcı yapılandırması

Aşağıdaki manuel models.providers girdilerini yalnızca ayrı Responses API, Claude native, Gemini native veya MiniMax native rotalarına açıkça ihtiyaç duyduğunuzda kullanın. Manuel yapılandırmayı seçerseniz yalnızca tokenlabyı 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
tokenlabopenai-completionsGPT, DeepSeek, Qwen ve çoğu OpenAI-uyumlu çağrıhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responses/v1/responses semantiğini bekleyen OpenAI Responses iş akışlarıhttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesClaude için yerel Messages API’sihttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiGemini için yerel API formatıhttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesMiniMax için yerel yönlendirmehttps://api.tokenlab.sh
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.tokenlab.sh’yi /v1 olmadan kullanmalıdır; aksi takdirde OpenClaw yanlış üst akış yolunu oluşturabilir.

​
Önkoşullar

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

​
Yapılandırma

OpenClaw yapılandırmanızı düzenleyin:
  • Kendi barındırılan: ~/.openclaw/openclaw.json
TokenLab sağlayıcılarını models.providers altında ekleyin: 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}
Tüm 5 sağlayıcı aynı API Key’i kullanır. Sadece bir TokenLab 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: "tokenlab-gemini/gemini-3.5-flash"
      }
    }
  }
}

​
Model Örnekleri

SağlayıcıModel referansıAçıklama
tokenlabtokenlab/gpt-4oOpenAI-uyumlu rota
tokenlabtokenlab/deepseek-r1DeepSeek akıl yürütme modeli
tokenlab-responsestokenlab-responses/gpt-4oResponses API rotası
tokenlab-claudetokenlab-claude/claude-sonnet-4-6Claude Messages için yerel rota
tokenlab-geminitokenlab-gemini/gemini-3.5-flashGemini için yerel rota
tokenlab-minimaxtokenlab-minimax/minimax-m3MiniMax için yerel rota
Mevcut tüm modellere göz atın: tokenlab.sh/models.

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

  • tokenlab: çoğu genel amaçlı ajan ve sohbet kullanım durumu için varsayılan seçim.
  • tokenlab-responses: OpenClaw iş akışınız açıkça OpenAI Responses semantiğine bağımlıysa kullanın.
  • tokenlab-claude: Claude’un yerel Messages davranışını istiyorsanız kullanın.
  • tokenlab-gemini: Gemini’ye özgü istek/yanıt formatlaması veya mevcut Gemini tarzı entegrasyonlar istiyorsanız kullanın.
  • tokenlab-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 tokenlab/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 TokenLab’nın /v1/responses yoluna eşlenir, bu nedenle tokenlab-responses https://api.tokenlab.sh/v1 kullanmalıdır.
anthropic-messages ve google-generative-ai /v1 olmadan https://api.tokenlab.sh 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 tokenlab-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.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS

​
Sonraki Adımlar

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