Configuração do Provedor TokenLab

Deixar meu agente fazer a configuraçãoCopy Anchor Link

Copie esta tarefa para um agente que já esteja funcionando no seu computador:

Leia este guia e me ajude a conectar OpenClaw ao TokenLab:
https://tokenlab.sh/docs/pt/guides/tokenlab-provider
Verifique primeiro minha versão instalada e a configuração ativa.
Preserve as contas, os provedores, as permissões e os demais ajustes existentes.
Faça backup dos arquivos locais e mostre as alterações propostas.
Deixe que eu insira localmente as chaves de API necessárias; nunca as solicite, exiba ou cole no chat.
Verifique primeiro se a configuração é carregada corretamente.
Explique separadamente o custo de qualquer teste com requisições pagas antes de executá-lo.

Recomendado: instale o pluginCopy Anchor Link

Opcional: instale o plugin publicado 0.1.0. Forneça TOKENLAB_API_KEY no ambiente Gateway descrito abaixo e escolha o modelo somente para a sessão. O assistente altera o modelo padrão; por isso, este guia não executa openclaw onboard. Preserve plugins e permissões existentes e confira o carregamento e a lista de modelos antes de enviar uma solicitação.

Revise as capacidades solicitadas pelo instalador e siga as confirmações do cliente. Não conceda permissões sem relação nem altere as de plugins existentes.

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab

/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

Configuração manual do provedorCopy Anchor Link

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.

Pré-requisitosCopy Anchor Link

• Uma instância OpenClaw self-hosted
• O OpenClaw 2026.9.4 requer Node.js >=24.16.0 <25 || >=26.1.0 (requisitos de versão). Para outras versões do OpenClaw, verifique os requisitos da versão correspondente.
• Uma API Key do TokenLab — Obtenha uma aqui

ConfiguraçãoCopy Anchor Link

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 ativo e faça uma cópia da configuração. Guarde TOKENLAB_API_KEY no .env global confiável ou ambiente do serviço. Export no terminal ou .env do projeto pode não chegar ao processo em segundo plano. Veja o ambiente.

Faça backup da configuração ativa. Adicione apenas a entrada TokenLab e preserve provedores, contas, modelo padrão e permissões existentes. Se o nome já estiver em uso, escolha outro e ajuste os comandos. Para desfazer, remova apenas a entrada adicionada ou restaure seu 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-reasoner", name: "DeepSeek Reasoner" },
          { 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.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: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Usando ModelosCopy Anchor Link

O OpenClaw continua referenciando modelos no formato provider/model:

No OpenClaw 2026.9.4, escolha o modelo apenas para a sessão atual com -s. Preserve agents.defaults.model, padrões do agente e permissões. Use /model default -s para retornar esta sessão ao modelo padrão configurado.

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

Exemplos de ModelosCopy Anchor Link

Consulte todos os modelos disponíveis em tokenlab.sh/models.

Quando usar cada provedorCopy Anchor Link

• 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 comunsCopy Anchor Link

Verificar a configuraçãoCopy Anchor Link

Reinicie a mesma instância e confira modelo e provedor. models status sem --probe não testa chamada de modelo. Sondas reais e mensagens podem consumir tokens. Compare resposta e registro TokenLab. Para restaurar, selecione o modelo anterior e remova somente entradas adicionadas.

openclaw gateway restart
openclaw models status

Próximos passosCopy Anchor Link

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