TokenLab Sağlayıcı Kurulumu

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 `api`	En uygun	baseUrl
`tokenlab`	`openai-completions`	GPT, DeepSeek, Qwen ve çoğu OpenAI-uyumlu çağrı	`https://api.tokenlab.sh/v1`
`tokenlab-responses`	`openai-responses`	`/v1/responses` semantiğini bekleyen OpenAI Responses iş akışları	`https://api.tokenlab.sh/v1`
`tokenlab-claude`	`anthropic-messages`	Claude için yerel Messages API’si	`https://api.tokenlab.sh`
`tokenlab-gemini`	`google-generative-ai`	Gemini için yerel API formatı	`https://api.tokenlab.sh`
`tokenlab-minimax`	`anthropic-messages`	MiniMax için yerel yönlendirme	`https://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
`tokenlab`	`tokenlab/gpt-4o`	OpenAI-uyumlu rota
`tokenlab`	`tokenlab/deepseek-r1`	DeepSeek akıl yürütme modeli
`tokenlab-responses`	`tokenlab-responses/gpt-4o`	Responses API rotası
`tokenlab-claude`	`tokenlab-claude/claude-sonnet-4-6`	Claude Messages için yerel rota
`tokenlab-gemini`	`tokenlab-gemini/gemini-3.5-flash`	Gemini için yerel rota
`tokenlab-minimax`	`tokenlab-minimax/minimax-m3`	MiniMax 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

Hâlâ eski üst düzey providers dizisini mi kullanıyorsunuz?

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.

`tokenlab-responses` için /v1'i unutmak

openai-responses TokenLab’nın /v1/responses yoluna eşlenir, bu nedenle tokenlab-responses https://api.tokenlab.sh/v1 kullanmalıdır.

`tokenlab-claude`, `tokenlab-gemini` veya `tokenlab-minimax`'e /v1 eklemek

anthropic-messages ve google-generative-ai /v1 olmadan https://api.tokenlab.sh kullanmalıdır. /v1 eklemek yanlış istek yolları üretebilir.

OpenClaw hâlâ native Gemini'yi destekliyor mu?

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:

API Formatları — 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
Hata İşleme — yaygın başarısızlık modlarını ve toparlanma desenlerini öğrenin
Model genel bakışı — ajanlara bağlamadan önce model ID’lerini inceleyin

Uyumluluk matrisi

Kodlama araçları

Native SDK'lar

Framework'ler ve platformlar

Sohbet uygulamaları

TokenLab Sağlayıcı Kurulumu

Önerilen: eklentiyi yükleyin

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

Önkoşullar

Yapılandırma

Modellerin Kullanımı

Model Örnekleri

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

Yaygın Hatalar

Kurulumu Doğrulama

Sonraki Adımlar

​Önerilen: eklentiyi yükleyin

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

​Önkoşullar

​Yapılandırma

​Modellerin Kullanımı

​Model Örnekleri

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

​Yaygın Hatalar

​Kurulumu Doğrulama

​Sonraki Adımlar

Önerilen: eklentiyi yükleyin

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

Önkoşullar

Yapılandırma

Modellerin Kullanımı

Model Örnekleri

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

Yaygın Hatalar

Kurulumu Doğrulama

Sonraki Adımlar