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 -s

npm · GitHub

Configurar 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.

Provedorapi do OpenClawIdeal parabaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen e a maioria das chamadas compatíveis com OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesFluxos de trabalho de OpenAI Responses que esperam semântica /v1/responseshttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesAPI nativa Claude Messageshttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiFormato nativo da API Geminihttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesModelos MiniMax via formato Messageshttps://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 -s

Exemplos de Modelos

ProvedorReferência do modeloDescrição
tokenlabtokenlab/gpt-5.6-terraCompatível com OpenAI (Chat Completions)
tokenlab-responsestokenlab-responses/gpt-5.6-terraAPI de Responses
tokenlab-claudetokenlab-claude/claude-sonnet-5Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.6-flashGemini
tokenlab-minimaxtokenlab-minimax/minimax-m3MiniMax 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 status

Gerar 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 tokenlab

Mantenha 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:

Nesta página