Configuração do Provedor TokenLab

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:

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/<model-id>. Pacote npm · Página no ClawHub · Código-fonte

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

Configuração

Edite sua configuração do OpenClaw:

Auto-hospedado: ~/.openclaw/openclaw.json

Adicione os provedores TokenLab em models.providers:

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

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

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

Ainda usando o array antigo de providers no nível superior

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.

Esquecer de colocar /v1 no tokenlab-responses

openai-responses mapeia para o caminho /v1/responses do TokenLab, então tokenlab-responses deve usar https://api.tokenlab.sh/v1.

Adicionar /v1 em tokenlab-claude, tokenlab-gemini ou tokenlab-minimax

anthropic-messages e google-generative-ai devem usar https://api.tokenlab.sh sem /v1. Adicionar /v1 pode gerar caminhos de requisição incorretos.

O OpenClaw ainda suporta Gemini nativo?

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.

# 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 — entenda as diferenças entre as rotas OpenAI, Responses, Anthropic e Gemini
Compatibilidade IDE / SDK — veja quando /v1/responses é a opção mais adequada
Tratamento de Erros — aprenda modos de falha comuns e padrões de recuperação
Visão geral dos Modelos — consulte os IDs dos modelos antes de conectá-los aos agentes

​Recomendado: instale o plugin

​Configuração manual do provedor

​Pré-requisitos

​Configuração

​Usando Modelos

​Exemplos de Modelos

​Quando usar cada provedor

​Erros comuns

​Verificar a configuração

​Próximos passos

Recomendado: instale o plugin

Configuração manual do provedor

Pré-requisitos

Configuração

Usando Modelos

Exemplos de Modelos

Quando usar cada provedor

Erros comuns

Verificar a configuração

Próximos passos