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 -sSağ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 api | En uygun olduğu durum | 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ği bekleyen OpenAI Responses iş akışları | https://api.tokenlab.sh/v1 |
tokenlab-claude | anthropic-messages | Yerel Claude Messages API | https://api.tokenlab.sh |
tokenlab-gemini | google-generative-ai | Yerel Gemini API formatı | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | Messages formatı üzerinden MiniMax modelleri | https://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.0kullanı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 -sModel Örnekleri
| Sağlayıcı | Model referansı | Açıklama |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | OpenAI uyumlu (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | Responses API |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | Messages ü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 statusAynı 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 tokenlabTek 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/responsesyolunun 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