O OpenClaw é um framework para desenvolvimento de agentes inteligentes que suporta a integração de diversos fornecedores de modelos. Utilizar o Taotoken como provedor permite acesso a uma variedade de modelos através de uma API unificada e gerenciamento simplificado de custos. Este guia explica como configurar essa integração, seja via ferramenta CLI oficial ou edição manual de arquivos de configuração.

Pré-requisitos: Credenciais do Taotoken

Antes de iniciar, é necessário obter dois elementos essenciais da plataforma Taotoken:

1. Chave de API: Crie uma nova chave no console do Taotoken, na seção de geernciamento de credenciais. Guarde-a com segurança.
2. ID do Modelo: No catálogo de modelos, identifique o ID único do modelo desejado, como gpt-4o-mini ou claude-3-opus.

Método 1: Configuração Automatizada com a CLI do Taotoken

A ferramenta CLI do Taotoken simplifica a integração com frameworks como o OpenClaw. Para instalar e utilizar:

# Instalação global via npm
npm install -g @taotoken/cli-agent

# Ou execução direta sem instalação
npx @taotoken/cli-agent

Execute o comando taotoken-cli e selecione a opção de configuração para o OpenClaw. O assistente interativo solicitará a chave de API e o ID do modelo.

Alternativamente, use o modo não interativo:

taotoken-cli configure openclaw --api-key SUA_CHAVE --model-id SEU_MODELO_ID

A CLI ajustará automaticamente o provedor para custom, definirá o endpoint da API como https://taotoken.net/api/v1 e formatará o identificador do modelo como taotoken/SEU_MODELO_ID.

Método 2: Configuração Manual no Arquivo do Projeto

Edite o arquivo de configuração do OpenClaw, geralmente openclaw.config.js ou .openclaw.yml. Um exemplo em JavaScript:

// openclaw.config.js
module.exports = {
  runtime: {
    modelProviders: {
      taotoken: {
        type: 'openai-compatível',
        baseUrl: 'https://taotoken.net/api/v1',
        authToken: process.env.TAOTOKEN_AUTH,
      },
    },
    defaultModel: {
      provider: 'taotoken',
      modelId: 'gpt-4o-mini',
    },
  },
};

Pontos-chave na configuração:

• type: Deve ser 'openai-compatível' para alinhar com a API do Taotoken.
• baseUrl: Endpoint obrigatório, incluindo /v1.
• authToken: Recomenda-se armazenar a chave em variáveis de ambiente por segurança.
• modelId: Use apenas o ID do modelo, sem prefixos.

Verificação e Solução de Problemas

Após configurar, execute uma tarefa simples no OpenClaw para validar a conexão. Monitorando os logs, confirme se as requisições alcançam o Taotoken. Erros comuns incluem:

• Endpoint incorreto: Verifique se baseUrl está exatmaente como https://taotoken.net/api/v1.
• Falha de autenticação: Confira a chave de API ou token de autenticação.
• ID de modelo inválido: Certifique-se de que o ID corresponde a um modelo ativo no catálogo.

Com a integração bem-sucedida, é possível alternar entre modelos diretamente no console do Taotoken sem alterar o código do agente, além de acompanhar o consumo de tokens.