Saltar para o conteúdo principal

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.

Este guia é para usuários do OpenClaw self-hosted que desejam conectar o TokenLab como seu provedor de IA.

​
Visão geral

Para as versões atuais do OpenClaw, a abordagem recomendada é configurar o TokenLab através de models.providers. Se você só quer começar rapidamente, configurar apenas tokenlab já é suficiente. Adicione os outros provedores somente quando precisar explicitamente do comportamento Responses API, Claude nativo, Gemini nativo ou MiniMax nativo.
ProvedorOpenClaw apiIndicado parabaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen e a maioria das chamadas compatíveis com OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesFluxos de trabalho OpenAI Responses que esperam a 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-messagesRoteamento nativo MiniMaxhttps://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-32b", name: "Qwen 3 32B" }
        ]
      },
      "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-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
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-2.5-flash"
      }
    }
  }
}

​
Exemplos de Modelos

ProvedorReferência do modeloDescrição
tokenlabtokenlab/gpt-4oRota compatível com OpenAI
tokenlabtokenlab/deepseek-r1Modelo de raciocínio DeepSeek
tokenlab-responsestokenlab-responses/gpt-4oRota Responses API
tokenlab-claudetokenlab-claude/claude-sonnet-4-6Rota nativa Claude Messages
tokenlab-geminitokenlab-gemini/gemini-2.5-flashRota nativa Gemini
tokenlab-minimaxtokenlab-minimax/minimax-m1Rota 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

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. 
# 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: