Tutorial completo de integração do Moltbot ao hub de API: 5 passos para configurar a interface compatível com OpenAI e economizar 60% nos custos

O Moltbot utiliza por padrão a API oficial da Anthropic, mas a API oficial apresenta problemas como restrições de acesso e preços elevados. Este artigo explicará detalhadamente como configurar o Moltbot para se conectar a um proxy de API, utilizando o modo openai-compatible para usar serviços de API de terceiros.

Valor Principal: Ao ler este artigo, você aprenderá a configurar o Moltbot com um intermediário de API, garantindo uma experiência de assistente de IA com custo reduzido e maior estabilidade.

Pontos centrais da configuração do Proxy de API no Moltbot

Antes de começar a configurar, entenda o mecanismo de configuração de API do Moltbot e as vantagens de usar um proxy.

Comparação de métodos de configuração do Moltbot

Preparação para Configuração de Proxy API do Moltbot

Passo 1: Confirmar se o Moltbot está instalado

Primeiro, certifique-se de que você já tem o Moltbot instalado:

# Verificar a versão do Moltbot
moltbot --version

# Se não estiver instalado, execute a instalação
npm install -g moltbot@latest

Requisitos do sistema: Node.js >= 22

Passo 2: Obter a chave do proxy API

Você precisará obter uma API Key de um serviço de proxy (relay) de API.

🚀 Início Rápido: Recomendamos usar o APIYI (apiyi.com) para obter sua chave. Ao se cadastrar, você ganha créditos gratuitos. Eles oferecem suporte aos principais modelos como Claude Sonnet 4, Claude Opus 4.5 e GPT-4o, com preços de 40% a 60% menores que os oficiais.

Após obter a chave, anote as seguintes informações:

Método 1: Configuração via arquivo config.json

Esta é a forma mais recomendada, pois a configuração é feita uma única vez e permanece válida permanentemente.

Localizando o arquivo de configuração do Moltbot

O arquivo de configuração do Moltbot geralmente está localizado em:

Você também pode usar comandos para encontrar:

# Ver a configuração atual
moltbot config list

# Ver o caminho do arquivo de configuração
moltbot config path

Editando o config.json para configurar o Proxy API

Abra o arquivo de configuração e adicione ou modifique a seção models.providers:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-sua-chave-api-aqui",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": ["apiyi/claude-opus-4-5-20251101", "apiyi/gpt-4o"]
    }
  }
}

Detalhes dos parâmetros de configuração

Método de Configuração 2 do Proxy de API Moltbot: Formato YAML

Se você prefere o formato YAML, o Moltbot também suporta o arquivo config.yaml:

# ~/.moltbot/config.yaml
models:
  providers:
    apiyi:
      baseUrl: "https://api.apiyi.com/v1"
      apiKey: "sk-your-api-key-here"
      api: openai-completions
      authHeader: true
      models:
        - id: claude-sonnet-4-20250514
          name: Claude Sonnet 4
          contextWindow: 200000
          maxTokens: 64000
        - id: claude-opus-4-5-20251101
          name: Claude Opus 4.5
          contextWindow: 200000
          maxTokens: 32000

agent:
  model:
    primary: apiyi/claude-sonnet-4-20250514
    fallbacks:
      - apiyi/claude-opus-4-5-20251101
      - apiyi/gpt-4o

Configuração YAML simplificada

Se você precisa apenas de um único modelo, pode usar uma configuração mais enxuta:

# ~/.moltbot/config.yaml - Versão minimalista
llm:
  provider: openai-compatible
  model: claude-sonnet-4-20250514
  apiKey: sk-your-api-key-here
  baseUrl: https://api.apiyi.com/v1

🎯 Dica técnica: Recomendamos usar a configuração completa para poder definir múltiplos modelos e estratégias de fallback, aumentando a estabilidade do serviço. Através do APIYI (apiyi.com), você pode acessar simultaneamente vários modelos como Claude, GPT, Gemini, entre outros.

Método de Configuração 3 do Proxy de API Moltbot: Variáveis de Ambiente

Ideal para testes temporários ou ambientes de CI/CD:

# Configurar variáveis de ambiente
export MOLTBOT_LLM_PROVIDER="openai-compatible"
export MOLTBOT_LLM_MODEL="claude-sonnet-4-20250514"
export MOLTBOT_LLM_API_KEY="sk-your-api-key-here"
export MOLTBOT_LLM_BASE_URL="https://api.apiyi.com/v1"

# Iniciar o Moltbot
moltbot gateway start

Ou configure em um arquivo .env:

# ~/.moltbot/.env
MOLTBOT_LLM_PROVIDER=openai-compatible
MOLTBOT_LLM_MODEL=claude-sonnet-4-20250514
MOLTBOT_LLM_API_KEY=sk-your-api-key-here
MOLTBOT_LLM_BASE_URL=https://api.apiyi.com/v1

Método 4 para Configurar o Proxy da API do Moltbot: Configuração via Linha de Comando

Configure rapidamente usando o comando moltbot config set:

# Configurar o proxy da API
moltbot config set models.providers.apiyi.baseUrl "https://api.apiyi.com/v1"
moltbot config set models.providers.apiyi.apiKey "sk-your-api-key-here"
moltbot config set models.providers.apiyi.api "openai-completions"

# Definir o modelo padrão
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# Validar a configuração
moltbot config list

Script para Configuração em Lote

Crie um script de configuração para definir tudo com um só clique:

#!/bin/bash
# setup-apiyi.sh - Script de configuração do proxy APIYI para o Moltbot

API_KEY="sk-your-api-key-here"
BASE_URL="https://api.apiyi.com/v1"

echo "Configurando o proxy da API do Moltbot..."

# Definir o provedor (provider)
moltbot config set models.providers.apiyi.baseUrl "$BASE_URL"
moltbot config set models.providers.apiyi.apiKey "$API_KEY"
moltbot config set models.providers.apiyi.api "openai-completions"
moltbot config set models.providers.apiyi.authHeader true

# Definir o modelo padrão
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# Reiniciar o gateway
moltbot gateway restart

echo "Configuração concluída! Use 'moltbot doctor' para validar."

Validação da Configuração do Proxy da API do Moltbot

Após concluir a configuração, é necessário verificar se tudo está funcionando corretamente.

Verificação com o comando moltbot doctor

# Executar diagnóstico
moltbot doctor

# Corrigir problemas automaticamente
moltbot doctor --fix

Exemplo de saída normal:

✓ Gateway running on port 18789
✓ Model provider 'apiyi' configured
✓ API key validated
✓ Model 'claude-sonnet-4-20250514' available
✓ Connection test passed

Enviando uma Mensagem de Teste

# Testar a conexão com a API
moltbot test-llm --provider apiyi --model claude-sonnet-4-20250514

# Enviar uma mensagem de teste
moltbot chat "Olá, por favor, apresente-se"

Verificação dos Logs de Chamada da API

# Visualizar logs em tempo real
moltbot logs --follow

# Visualizar as chamadas de API mais recentes
moltbot logs --filter api-call --last 10

Lista de modelos suportados pelo proxy de API do Moltbot

Através do proxy APIYI, você pode utilizar os seguintes modelos no Moltbot:

Série Claude

Série OpenAI

Série Google

💡 Sugestão de escolha: Para o uso diário do Moltbot, recomendamos o Claude Sonnet 4, que oferece um excelente equilíbrio entre desempenho e custo. Através do APIYI apiyi.com, você pode acessar a lista completa de modelos e preços em tempo real.

Configurações Avançadas do Proxy de API Moltbot

Configurar Estratégia de Fallback

Quando o modelo principal estiver indisponível, mude automaticamente para um modelo reserva:

{
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": [
        "apiyi/claude-3-5-sonnet-20241022",
        "apiyi/gpt-4o"
      ],
      "fallbackStrategy": "sequential"
    }
  }
}

Configurar Regras de Roteamento de Modelo

Selecione automaticamente o melhor modelo com base no tipo de tarefa:

{
  "agent": {
    "modelRouting": {
      "coding": "apiyi/claude-sonnet-4-20250514",
      "reasoning": "apiyi/claude-opus-4-5-20251101",
      "quick": "apiyi/claude-3-5-haiku-20241022",
      "default": "apiyi/claude-sonnet-4-20250514"
    }
  }
}

Configurar Limites de Custo

Evite gastos excessivos inesperados:

{
  "agent": {
    "limits": {
      "maxTokensPerRequest": 32000,
      "maxRequestsPerHour": 100,
      "maxCostPerDay": 10.00
    }
  }
}

Perguntas Frequentes (FAQ) do Proxy de API Moltbot

# Validar a API Key
curl -H "Authorization: Bearer sk-your-key" https://api.apiyi.com/v1/models

moltbot config set agent.model.primary "apiyi/claude-opus-4-5-20251101"
moltbot gateway restart

moltbot chat --model apiyi/gpt-4o "Olá"

{
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": ["openrouter/anthropic/claude-3.5-sonnet"]
    }
  }
}

# Ver estatísticas locais
moltbot stats --period today

# Ver uso detalhado
moltbot stats --detailed --period week

Resolução de problemas de configuração do gateway Moltbot API

Erros comuns e soluções

Modo de depuração

Ative os logs detalhados para facilitar a investigação de problemas:

# Ativar modo de depuração
export MOLTBOT_DEBUG=true
moltbot gateway start

# Ou use argumentos de linha de comando
moltbot gateway start --debug --log-level verbose

Comandos de validação de configuração

# Validar a sintaxe da configuração
moltbot config validate

# Testar a conexão com a API
moltbot test-connection --provider apiyi

# Checkup completo de integridade
moltbot doctor --verbose

Comparativo: Gateway Moltbot API vs. API Oficial

🎯 Sugestão de escolha: Para usuários que buscam suporte a múltiplos modelos e cenários de uso flexíveis, recomendamos o acesso ao Moltbot via APIYI (apiyi.com). Além de preços mais competitivos, você garante um serviço mais estável e suporte técnico dedicado.

Resumo: Revisão dos pontos-chave de configuração do gateway de API no Moltbot

Com este tutorial, você aprendeu o método completo de configuração para conectar o Moltbot a um gateway de API:

1. Preparação: Instalar o Moltbot e obter a API Key da APIYI (apiyi.com)
2. Arquivo de Configuração: Editar o config.json ou config.yaml para adicionar a configuração do provider
3. Parâmetros Críticos: baseUrl, apiKey, tipo de api e lista de modelos
4. Teste de Validação: Usar o comando moltbot doctor e comandos de teste para confirmar se a configuração está correta
5. Recursos Avançados: Estratégias de Fallback, roteamento de modelos e limites de custo

Recomendamos obter sua chave de API através da APIYI (apiyi.com) para aproveitar preços mais baixos e um serviço mais estável, permitindo que seu assistente Moltbot entregue o máximo valor.

Referências

1. Documentação Oficial do Moltbot: Referência de configuração do Gateway

   • Link: docs.molt.bot/gateway/configuration

2. Exemplos de Configuração do Moltbot: Modelos de configuração para diversos cenários

   • Link: docs.molt.bot/gateway/configuration-examples

3. Provedores de Modelos do Moltbot: Detalhes da configuração de Provider

   • Link: docs.molt.bot/concepts/model-providers

4. GitHub do Moltbot: Código-fonte do projeto e Issues

   • Link: github.com/moltbot/moltbot

5. Guia de Início do Moltbot: Tutorial de início rápido

   • Link: docs.molt.bot/start/getting-started

📝 Autor: Equipe APIYI
🔗 Suporte Técnico: Se precisar de chaves de API ou ajuda técnica, visite a APIYI em apiyi.com