1. Pré-requisitos

Antes de conectar o Taotoken ao OpenClaw, é necessário possuir uma conta ativa e uma chave de API válida. No painel do Taotoken, vá até a seção de credenciais e gere uma chave exclusiva para o ambiente OpenClaw. Anote também o identificador do modelo que será utilizado, disponível na página de catálogo de modelos.

2. Configuração via CLI

O Taotoken fornece um utilitário de linha de comando que automatiza a configuração. Para instalá-lo globalmente, execute:

npm install -g @taotoken/taotoken

Depois da instalação, inicie o assistente interativo:

taotoken openclaw

Durante a execução, informe:

• A chave de API do Taotoken
• O identificador do modelo (ex.: claude-sonnet-4-6)
• O endpoint base https://taotoken.net/api/v1

Após a finalização, o utilitário gravará as credenciais no arquivo de configuração padrão do OpenClaw. Para validar, use:

taotoken openclaw --check

3. Configuração manual

É possível editar diretamente o arquivo de configuração do OpenClaw, localizado em ~/.openclaw/config.json no Linux/macOS ou em %USERPROFILE%\.openclaw\config.json no Windows.

Adicione o provedor Taotoken conforme o exemplo abaixo:

{
  "defaults": {
    "model": {
      "primary": "taotoken/claude-sonnet-4-6"
    }
  },
  "providers": {
    "taotoken": {
      "api_key": "SUA_CHAVE_AQUI",
      "base_url": "https://taotoken.net/api/v1"
    }
  }
}

Observação importante: o valor de base_url deve terminar com /v1, pois essa é a versão da API compatível com o formato esperado pelo OpenClaw.

4. Testando a integração

Crie um script para verificar se o OpenClaw consegue se comunicar com o Taotoken:

from openclaw import OpenClaw

client = OpenClaw()
prompt = "Olá, como você está?"
reply = client.chat(prompt)
print(reply)

Se a configuração estiver correta, a resposta do modelo será exibida no terminal. Erros de autenticação indicam problemas na chave de API, enquanto falhas de rota geralmente estão relacionadas a um base_url incompleto.

5. Opções avançadas

É possível sobrescrever o modelo diretamente no código:

from openclaw import OpenClaw

client = OpenClaw()
query = "Analise o seguinte texto"
reply = client.chat(query, model="taotoken/gpt-4-turbo-preview")
print(reply)

Alternativamente, configure modelos de contingência no arquivo JSON:

{
  "defaults": {
    "model": {
      "fallbacks": [
        "taotoken/gpt-4-turbo-preview",
        "taotoken/claude-haiku-4-0"
      ],
      "primary": "taotoken/claude-sonnet-4-6"
    }
  }
}

6. Diagnóstico de problemas

Caso ocorram falhas durante a integração, verifique:

• Se a URL https://taotoken.net está acessível a partir do ambiente
• Se a chave de API está ativa e sem restrições
• Se o identificador do modelo está correto e disponível
• Se a base_url inclui o sufixo /v1
• Se os logs do OpenClaw apresentam mensagens de erro mais detalhadas