> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# TokenLab Sağlayıcı Kurulumu
> OpenClaw'da TokenLab'yı OpenAI, Responses, Anthropic ve Gemini uyumlu yolları kullanarak özel bir sağlayıcı olarak yapılandırma
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:
```bash theme={null}
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/` biçimini kullanır.
[npm paketi](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [ClawHub kaydı](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [Kaynak kod](https://github.com/hedging8563/tokenlab-openclaw-provider)
## 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 `tokenlab`yı 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](https://tokenlab.sh/dashboard)
## 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:
```json5 theme={null}
{
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:
```json5 theme={null}
{
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](https://tokenlab.sh/tr/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.
```bash theme={null}
# 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ı](/guides/api-formats) — OpenAI, Responses, Anthropic ve Gemini yolları arasındaki farkları anlayın
* [IDE / SDK Compatibility](/guides/ide-sdk-compatibility) — `/v1/responses`'in ne zaman daha uygun olduğunu görün
* [Hata İşleme](/guides/error-handling) — yaygın başarısızlık modlarını ve toparlanma desenlerini öğrenin
* [Model genel bakışı](https://tokenlab.sh/tr/models) — ajanlara bağlamadan önce model ID'lerini inceleyin