Kodlama araçları

TokenLab Sağlayıcı Kurulumu

Kendi kendine barındırılan (self-hosted) bir OpenClaw örneğini TokenLab'e bağlayın

Bırakın agent'ım bunu kursun

Bu görevi bilgisayarınızda halihazırda çalışan bir agent'a kopyalayın:

Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/tr/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Bu kılavuz self-hosted OpenClaw içindir. TokenLab eklentisi en kısa kurulum yöntemidir; belirli bir API formatına ihtiyaç duyduğunuzda manuel yapılandırma da mevcuttur.

Eklentiyi yükleyin

İsteğe bağlı: yayınlanmış sağlayıcı eklentisi 0.1.3'ü yükleyin. TOKENLAB_API_KEY değerini aşağıda açıklanan aynı Gateway ortamı aracılığıyla sağlayın ve yalnızca oturuma özel model seçimini kullanın. Eklenti kurulum sihirbazı varsayılan modeli değiştirdiğinden, bu kılavuz openclaw onboard komutunu çalıştırmaz. Mevcut eklenti girişlerini ve izinlerini koruyun. Bir istekte bulunmadan önce yüklü eklentiyi ve model listesini kontrol edin.

Yükleyici tarafından talep edilen yetenekleri gözden geçirin ve istemcinin onay istemlerini takip edin. İlgisiz izinler vermeyin veya mevcut eklentilerin izinlerini değiştirmeyin.

openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab
/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

Sağlayıcıları manuel olarak yapılandırın

models.providers kısmını yalnızca OpenClaw'un Responses, Claude Messages, Gemini veya MiniMax formatlarına ayrı ayrı ihtiyaç duyduğu durumlarda kullanın. Normal sohbet için tokenlab girişi yeterlidir.

SağlayıcıOpenClaw apiEn uygun olduğu durumbaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen ve çoğu OpenAI uyumlu çağrıhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responses/v1/responses semantiği bekleyen OpenAI Responses iş akışlarıhttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesYerel Claude Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiYerel Gemini API formatıhttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesMessages formatı üzerinden MiniMax modellerihttps://api.tokenlab.sh

/v1 sonekini yalnızca openai-completions ve openai-responses için kullanın.

anthropic-messages ve google-generative-ai gibi yerel sağlayıcılar /v1 olmadan https://api.tokenlab.sh kullanmalıdır, aksi takdirde OpenClaw yanlış sağlayıcı yolu oluşturabilir.

Ön koşullar

  • Self-hosted bir OpenClaw örneği
  • OpenClaw 2026.9.4 için Node.js >=24.16.0 <25 || >=26.1.0 kullanın (sürüm gereksinimleri). Diğer OpenClaw sürümleri için ilgili sürümün gereksinimlerini kontrol edin.
  • Bir TokenLab API Key — Buradan alın

Yapılandırma

OpenClaw yapılandırmanızı düzenleyin:

  • Self-hosted: ~/.openclaw/openclaw.json

TokenLab sağlayıcılarını models.providers altına ekleyin:

Çalışan Gateway ile aynı profili, OPENCLAW_STATE_DIR ve OPENCLAW_CONFIG_PATH değerlerini kullanın. Birleştirmeden önce aktif yapılandırmayı yedekleyin. TOKENLAB_API_KEY değerini o örneğin güvenilir global .env dosyasına veya servis ortamına yerleştirin; terminal dışa aktarımı veya sadece proje .env dosyası arka plan Gateway'ine ulaşmayabilir. Ortam yönetimi bölümüne bakın.

Aktif yapılandırmayı yedekleyin. Yalnızca TokenLab girişini ekleyin ve mevcut sağlayıcıları, hesapları, varsayılan model seçimini ve izinleri koruyun. Eğer isim zaten kullanılıyorsa, başka bir isim seçin ve komutları güncelleyin. Kurulumu geri almak için yalnızca eklediğiniz girişi kaldırın veya önceki yedeği geri yükleyin.

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gemini-3.6-flash", name: "Gemini 3.6 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Her 5 sağlayıcı da aynı API Key'i kullanır. Sadece bir TokenLab hesabına ihtiyacınız vardır.

Yukarıdaki models dizileri yalnızca yaygın örnekleri gösterir. Gerektiğinde her sağlayıcıya daha fazla model ID'si ekleyin.

Modelleri Kullanma

OpenClaw modelleri hala provider/model formatıyla referans alır:

OpenClaw 2026.9.4 için, modeli yalnızca -s ile mevcut oturum için seçin. agents.defaults.model, agent varsayılanlarını ve izinlerini değiştirmeden bırakın. Bu oturumu yapılandırılmış varsayılanına döndürmek için /model default -s kullanın.

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

Model Örnekleri

SağlayıcıModel referansıAçıklama
tokenlabtokenlab/gpt-5.6-terraOpenAI uyumlu (Chat Completions)
tokenlab-responsestokenlab-responses/gpt-5.6-terraResponses API
tokenlab-claudetokenlab-claude/claude-sonnet-5Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.6-flashGemini
tokenlab-minimaxtokenlab-minimax/minimax-m3Messages üzerinden MiniMax

Tüm mevcut modellere tokenlab.sh/models adresinden göz atın.

Hangi Sağlayıcı Ne Zaman Kullanılır

  • tokenlab: çoğu genel amaçlı agent 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ğlı olduğunda kullanın.
  • tokenlab-claude: Claude'un yerel Messages davranışını istediğinizde kullanın.
  • tokenlab-gemini: Gemini'a özgü istek/yanıt formatlamasını veya mevcut Gemini tarzı entegrasyonları istediğinizde kullanın.
  • tokenlab-minimax: Messages formatı üzerinden MiniMax modellerini istediğinizde kullanın.

Gemini'a özgü davranışa ihtiyacınız yoksa, Gemini modellerini OpenAI uyumlu formatta tokenlab/gemini-* üzerinden yine de çağırabilirsiniz.

Yaygın Hatalar

Kurulumu Doğrulayın

Örneği yeniden başlatın, ardından seçilen modelini ve sağlayıcısını inceleyin. --probe olmadan models status komutu bir model çağrısı testi yapmaz. Canlı bir --probe veya sohbet mesajı token tüketebilir. Kurulumun çalıştığını beyan etmeden önce gerçek bir yanıtı eşleşen TokenLab isteğiyle karşılaştırın. Geri yüklemek için önceki modeli seçin ve yalnızca eklediğiniz TokenLab girişlerini kaldırın.

openclaw gateway restart
openclaw models status

Aynı agent içinde görsel ve video oluşturun

OpenClaw ayrıca TokenLab MCP server ile görseller ve kısa videolar oluşturabilir. Her üretim aynı TokenLab bakiyesinden ödenir.

openclaw mcp add tokenlab \
  --command npx \
  --arg -y \
  --arg @tokenlabai/mcp-server@0.6.48 \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlab

Tek tırnak işaretlerini koruyun. OpenClaw daha sonra anahtarı değil, değişkenin bir referansını saklar ve sunucuyu başlattığında TOKENLAB_API_KEY değerini çalıştığı ortamdan okur. Probe, TokenLab araçlarını listeler. Ardından şunu deneyin:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video bir görev kimliği (task ID) döndürür. Agent, video hazır olana kadar get_task_status komutunu çağırır.

Sonraki Adımlar

OpenClaw bağlandıktan sonra, bu kılavuzlar TokenLab'i daha etkili kullanmanıza yardımcı olur:

  • API Formats — OpenAI, Responses, Anthropic ve Gemini rotaları arasındaki farkları anlayın
  • IDE / SDK Compatibility — /v1/responses yolunun ne zaman daha uygun olduğunu görün
  • Error Handling — yaygın hata modlarını ve kurtarma modellerini öğrenin
  • Models Overview — model ID'lerini agent'lara bağlamadan önce göz atın

Bu sayfada