Ferramentas de código
Configuração do Provedor TokenLab
Conecte uma instância do OpenClaw auto-hospedada ao TokenLab
Deixe meu agente configurar isso
Copie esta tarefa para um agente que já esteja sendo executado no seu computador:
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/pt/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.Este guia é para o OpenClaw auto-hospedado. O plugin TokenLab é a configuração mais rápida; a configuração manual está disponível quando você precisar de um formato de API específico.
Instalar o plugin
Opcional: instale o plugin de provedor publicado 0.1.3. Forneça a TOKENLAB_API_KEY através do mesmo ambiente de Gateway descrito abaixo e use a seleção de modelo apenas para a sessão. O assistente de integração do plugin altera o modelo padrão, portanto, este guia não executa openclaw onboard. Mantenha as entradas e permissões de plugins existentes. Verifique o plugin instalado e a lista de modelos antes de fazer uma solicitação.
Revise as capacidades solicitadas pelo instalador e siga os prompts de confirmação do cliente. Não conceda permissões não relacionadas nem altere as permissões de plugins existentes.
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 -sConfigurar provedores manualmente
Use models.providers apenas quando o OpenClaw precisar dos formatos Responses, Claude Messages, Gemini ou MiniMax separadamente. Para chat comum, a entrada tokenlab é suficiente.
| Provedor | api do OpenClaw | Ideal 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 de OpenAI Responses que esperam 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 | Modelos MiniMax via formato Messages | https://api.tokenlab.sh |
Use o sufixo /v1 apenas 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 o caminho do provedor incorretamente.
Pré-requisitos
- Uma instância do OpenClaw auto-hospedada
- Para o OpenClaw 2026.9.4, use Node.js
>=24.16.0 <25 || >=26.1.0(requisitos de versão). Para outras versões do OpenClaw, verifique os requisitos daquela versão. - Uma chave de API do TokenLab — Obtenha uma aqui
Configuração
Edite sua configuração do OpenClaw:
- Auto-hospedado:
~/.openclaw/openclaw.json
Adicione os provedores TokenLab em models.providers:
Use o mesmo perfil, OPENCLAW_STATE_DIR e OPENCLAW_CONFIG_PATH do Gateway em execução. Faça backup da configuração ativa antes de mesclar. Coloque a TOKENLAB_API_KEY no .env global confiável ou no ambiente de serviço daquela instância; um export de terminal ou um .env de projeto isolado pode não alcançar o Gateway em segundo plano. Veja manipulação de ambiente.
Faça backup da configuração ativa. Adicione apenas a entrada do TokenLab e preserve os provedores, contas, seleção de modelo padrão e permissões existentes. Se o nome já estiver sendo usado, escolha outro nome e atualize os comandos. Para desfazer a configuração, remova apenas a entrada que você adicionou ou restaure o backup anterior.
{
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" }
]
}
}
}
}Todos os 5 provedores usam a mesma chave de API. Você só precisa de 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 ainda referencia modelos com o formato provider/model:
Para o OpenClaw 2026.9.4, selecione o modelo apenas para a sessão atual com -s. Mantenha agents.defaults.model, padrões de agente e permissões inalterados. Use /model default -s para retornar esta sessão ao seu padrão configurado.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sExemplos de Modelos
| Provedor | Referência do modelo | Descrição |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | Compatível com OpenAI (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | API de Responses |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | MiniMax via Messages |
Navegue por todos os modelos disponíveis em tokenlab.sh/models.
Quando usar cada provedor
tokenlab: escolha padrão para a maioria dos casos de uso de agentes e chat de propósito geral.tokenlab-responses: use quando seu fluxo de trabalho no OpenClaw depender explicitamente da semântica de OpenAI Responses.tokenlab-claude: use quando quiser o comportamento nativo de Messages do Claude.tokenlab-gemini: use quando quiser a formatação de solicitação/resposta nativa do Gemini ou integrações existentes no estilo Gemini.tokenlab-minimax: use quando quiser modelos MiniMax via formato Messages.
Se você não precisar do comportamento nativo do Gemini, ainda pode chamar modelos Gemini através de tokenlab/gemini-* no formato compatível com OpenAI.
Erros Comuns
Verificar a configuração
Reinicie a instância e, em seguida, inspecione o modelo e o provedor selecionados. models status sem --probe não realiza um teste de chamada de modelo. Um --probe ao vivo ou uma mensagem de chat pode consumir tokens. Verifique uma resposta real em relação à solicitação TokenLab correspondente antes de declarar que a configuração está funcionando. Para restaurar, escolha o modelo anterior e remova apenas as entradas TokenLab que você adicionou.
openclaw gateway restart
openclaw models statusGerar imagens e vídeos no mesmo agente
O OpenClaw também pode criar imagens e vídeos curtos com o servidor MCP do TokenLab. Cada geração é paga a partir do mesmo saldo do TokenLab.
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 tokenlabMantenha as aspas simples. O OpenClaw então armazena uma referência à variável, não à chave, e lê a TOKENLAB_API_KEY do ambiente em que é executado quando inicia o servidor. O probe lista as ferramentas do TokenLab. Em seguida, tente:
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 retorna um ID de tarefa. O agente chama get_task_status até que o vídeo esteja pronto.
Próximos passos
Uma vez que o OpenClaw esteja conectado, estes guias ajudam você a usar o TokenLab de forma mais eficaz:
- Formatos de API — entenda as diferenças entre as rotas OpenAI, Responses, Anthropic e Gemini
- Compatibilidade com IDE / SDK — veja quando
/v1/responsesé a melhor opção - Tratamento de Erros — aprenda modos de falha comuns e padrões de recuperação
- Visão Geral dos Modelos — navegue pelos IDs de modelo antes de conectá-los aos agentes