> ## 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.
# Configuração do Provedor TokenLab
> Configure o TokenLab como um provedor personalizado no OpenClaw usando rotas compatíveis com OpenAI, Responses, Anthropic e Gemini
Este guia é para usuários do **OpenClaw self-hosted** que desejam conectar o TokenLab como seu provedor de IA.
## Recomendado: instale o plugin
Para a execução padrão de agentes no OpenClaw, instale o plugin de provedor do TokenLab:
```bash theme={null}
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
```
O plugin consulta o catálogo ativo de modelos de chat do TokenLab e mantém 18 modelos de fallback para descoberta offline. Os modelos usam o formato `tokenlab/`.
[Pacote npm](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [Página no ClawHub](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [Código-fonte](https://github.com/hedging8563/tokenlab-openclaw-provider)
## Configuração manual do provedor
Use as entradas manuais de `models.providers` abaixo somente quando precisar explicitamente de rotas separadas para **Responses API**, **Claude nativo**, **Gemini nativo** ou **MiniMax nativo**.
Se você escolher a configuração manual, configurar apenas `tokenlab` já é suficiente. Adicione os outros provedores somente quando precisar explicitamente do comportamento **Responses API**, **Claude nativo**, **Gemini nativo** ou **MiniMax nativo**.
| Provedor | OpenClaw `api` | Indicado para | baseUrl |
| -------------------- | ---------------------- | --------------------------------------------------------------------------- | ---------------------------- |
| `tokenlab` | `openai-completions` | GPT, DeepSeek, Qwen e a maioria das chamadas compatíveis com OpenAI | `https://api.tokenlab.sh/v1` |
| `tokenlab-responses` | `openai-responses` | Fluxos de trabalho OpenAI Responses que esperam a semântica `/v1/responses` | `https://api.tokenlab.sh/v1` |
| `tokenlab-claude` | `anthropic-messages` | API nativa Claude Messages | `https://api.tokenlab.sh` |
| `tokenlab-gemini` | `google-generative-ai` | Formato nativo da API Gemini | `https://api.tokenlab.sh` |
| `tokenlab-minimax` | `anthropic-messages` | Roteamento nativo MiniMax | `https://api.tokenlab.sh` |
Use o sufixo `/v1` somente para `openai-completions` e `openai-responses`.
Provedores nativos como `anthropic-messages` e `google-generative-ai` devem usar `https://api.tokenlab.sh` sem `/v1`, caso contrário o OpenClaw pode construir um caminho upstream incorreto.
## Pré-requisitos
* Uma instância OpenClaw self-hosted
* Uma API Key do TokenLab — [Obtenha uma aqui](https://tokenlab.sh/dashboard)
## Configuração
Edite sua configuração do OpenClaw:
* **Auto-hospedado**: `~/.openclaw/openclaw.json`
Adicione os provedores TokenLab em `models.providers`:
```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" }
]
}
}
}
}
```
Todos os 5 provedores usam a **mesma API Key**. Você precisa de apenas uma conta TokenLab.
Os arrays `models` acima mostram apenas exemplos comuns. Adicione mais IDs de modelo a cada provedor conforme necessário.
## Usando Modelos
O OpenClaw continua referenciando modelos no formato `provider/model`:
```json5 theme={null}
{
agents: {
defaults: {
model: {
primary: "tokenlab-gemini/gemini-3.5-flash"
}
}
}
}
```
### Exemplos de Modelos
| Provedor | Referência do modelo | Descrição |
| -------------------- | ----------------------------------- | ----------------------------- |
| `tokenlab` | `tokenlab/gpt-4o` | Rota compatível com OpenAI |
| `tokenlab` | `tokenlab/deepseek-r1` | Modelo de raciocínio DeepSeek |
| `tokenlab-responses` | `tokenlab-responses/gpt-4o` | Rota Responses API |
| `tokenlab-claude` | `tokenlab-claude/claude-sonnet-4-6` | Rota nativa Claude Messages |
| `tokenlab-gemini` | `tokenlab-gemini/gemini-3.5-flash` | Rota nativa Gemini |
| `tokenlab-minimax` | `tokenlab-minimax/minimax-m3` | Rota nativa MiniMax |
Consulte todos os modelos disponíveis em [tokenlab.sh/models](https://tokenlab.sh/pt/models).
## Quando usar cada provedor
* `tokenlab`: escolha padrão para a maioria dos casos de uso gerais de agentes e chat.
* `tokenlab-responses`: use quando seu fluxo no OpenClaw depender explicitamente da semântica do OpenAI Responses.
* `tokenlab-claude`: use quando você quiser o comportamento nativo de Claude Messages.
* `tokenlab-gemini`: use quando você quiser formatação de requisição/resposta nativa do Gemini ou integrações já existentes no estilo Gemini.
* `tokenlab-minimax`: use quando quiser o MiniMax em sua rota nativa.
Se você não precisa do comportamento nativo do Gemini, ainda pode chamar modelos Gemini através de `tokenlab/gemini-*` pela rota compatível com OpenAI.
## Erros comuns
A documentação atual do OpenClaw usa `models.providers`. Se você mantiver o formato antigo `providers` no nível superior, o OpenClaw pode ignorar a configuração ou falhar ao resolver os prefixos dos provedores como esperado.
`openai-responses` mapeia para o caminho `/v1/responses` do TokenLab, então `tokenlab-responses` deve usar `https://api.tokenlab.sh/v1`.
`anthropic-messages` e `google-generative-ai` devem usar `https://api.tokenlab.sh` sem `/v1`. Adicionar `/v1` pode gerar caminhos de requisição incorretos.
Sim. A documentação atual do OpenClaw ainda inclui o provedor interno `google` e também suporta provedores personalizados usando `api: "google-generative-ai"`. Portanto, `tokenlab-gemini` continua sendo uma rota Gemini nativa válida para usuários do OpenClaw.
## Verificar a configuração
Após salvar a configuração, reinicie sua instância OpenClaw e teste com uma mensagem simples. Se você receber uma resposta, o provedor está configurado corretamente.
```bash theme={null}
# Auto-hospedado: reinicie o serviço
systemctl --user restart openclaw # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw # macOS
```
## Próximos passos
Depois que o OpenClaw estiver conectado, estes guias ajudam você a usar o TokenLab de forma mais eficaz:
* [Formatos de API](/guides/api-formats) — entenda as diferenças entre as rotas OpenAI, Responses, Anthropic e Gemini
* [Compatibilidade IDE / SDK](/guides/ide-sdk-compatibility) — veja quando `/v1/responses` é a opção mais adequada
* [Tratamento de Erros](/guides/error-handling) — aprenda modos de falha comuns e padrões de recuperação
* [Visão geral dos Modelos](https://tokenlab.sh/pt/models) — consulte os IDs dos modelos antes de conectá-los aos agentes