Zeroclaw acessa as APIs de baixo custo do Gemini & Claude através do Defapi

Este tutorial irá guiá-lo sobre como conectar vários modelos de linguagem de grande escala (LLMs) no Zeroclaw através da plataforma Defapi. Com a Defapi, você pode obter uma experiência totalmente compatível com as interfaces oficiais a um custo extremamente acessível.

Introdução

O Zeroclaw é um ambiente de execução (runtime) de Agentes de IA autônomos baseado em Rust, que suporta interação com usuários através de canais como Telegram, Discord, Slack, entre outros. Já a Defapi é uma plataforma que oferece APIs de modelos com alto custo-benefício, com preços que chegam a ser metade dos valores oficiais, suporte a acesso global estável e compatibilidade total com os protocolos de API dos principais fabricantes de modelos (como v1/chat/completions, v1/messages, v1beta/models/, etc.).

Operação Passo a Passo

Conectar modelos via Defapi é muito simples. Abaixo estão as etapas de configuração específicas.

1. Obter a API Key

Primeiro, acesse o site oficial da Defapi e registre uma conta. Na página do modelo que você deseja (por exemplo, modelos Claude ou Gemini), obtenha sua API Key exclusiva.
Exemplos: Página Defapi Claude ou Página Defapi Gemini.

2. Configurar Variáveis de Ambiente

No terminal ou ambiente do seu sistema, configure a variável de ambiente correspondente, inserindo sua API Key:

Para modelos Claude:

export ANTHROPIC_API_KEY="dk-xxxxxxxxxxxxxxxx"

Para modelos Gemini:

export GEMINI_API_KEY="dk-xxxxxxxxxxxxxxxx"

3. Modificar o Arquivo de Configuração

Edite o arquivo de configuração principal do Zeroclaw (geralmente localizado em ~/.zeroclaw/config.toml), ajustando as configurações de acordo com o modelo escolhido.

Usando o modelo Claude (exemplo com Claude Sonnet 4.5):

default_provider = "anthropic-custom:https://api.defapi.org"
api_key = "dk-xxxxxxxxxxxxxxxx"
default_model = "anthropic/claude-sonnet-4.5"
default_temperature = 0.7

Usando o modelo Gemini (exemplo com Gemini 3 Flash):

default_provider = "custom:https://api.defapi.org"
api_key = "dk-xxxxxxxxxxxxxxxx"
default_model = "gemini-3-flash"
default_temperature = 0.7

Dica: A interface da Defapi é perfeitamente compatível com a interface v1/messages oficial da Anthropic e com a interface v1beta/models/*:generateContent do Google. Você pode alternar sem problemas e sem modificar nenhum código subjacente.

Validar se o Zeroclaw está Funcionando Corretamente

Após concluir a configuração, você pode verificar se o Zeroclaw está conectado com sucesso à Defapi através dos seguintes métodos.

Método 1: Teste de Mensagem Direta

Inicie o Zeroclaw no terminal e envie uma mensagem de teste:

zeroclaw agent -m "Hello, can you hear me?"

Se o modelo retornar uma resposta de forma normal e rápida, a configuração foi bem-sucedida.

Método 2: Usar Comandos de Diagnóstico

O Zeroclaw possui comandos de diagnóstico integrados para você verificar o status de execução:

# Verificar o status do sistema
zeroclaw status

# Executar diagnóstico do sistema
zeroclaw doctor

# Listar todos os provedores e modelos disponíveis
zeroclaw providers

Método 3: Teste de Configuração de Canal

Você pode configurar um canal social (como o Telegram) para testes de interação real:

[channels_config.telegram]
bot_token = "123456:your-telegram-token"
allowed_users = ["*"]

5 Casos de Uso Comuns

Combinando a vantagem de baixo custo da Defapi, o Zeroclaw pode ser amplamente aplicado nos seguintes cenários:

Caso 1: Assistente de Revisão de Código

Revisa automaticamente repositórios de código, apontando erros potenciais, vulnerabilidades de segurança e sugestões de otimização.

[agents.code_reviewer]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-sonnet-4.5"
system_prompt = "You are an expert code reviewer. Review the code for bugs, security issues, and best practices."
agentic = false
max_iterations = 1

Caso 2: Robô de Atendimento ao Cliente Inteligente

Oferece suporte de perguntas e respostas rápido e amigável aos usuários 24 horas por dia, 7 dias por semana.

[agents.support]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-haiku-4.5"
system_prompt = "You are a helpful customer support agent. Be concise and friendly."
max_iterations = 3

Caso 3: Assistente de Pesquisa Automatizado

Capaz de pesquisar na web de forma autônoma e organizar os resultados, ideal para investigações profundas e coleta de informações.

[agents.researcher]
provider = "custom:https://api.defapi.org"
model = "gemini-3-flash"
system_prompt = "You are a research assistant. Search the web and summarize findings."
agentic = true
max_depth = 2
allowed_tools = ["web_search", "http_request", "file_read"]
max_iterations = 8

Caso 4: Analista de Dados

Conecta arquivos locais e ferramentas de Shell para ajudar a analisar dados e fornecer insights profundos.

[agents.analyst]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-sonnet-4.5"
system_prompt = "You are a data analyst. Analyze the provided data and provide insights."
agentic = true
allowed_tools = ["shell", "file_read"]

Caso 5: Geração de Conteúdo Multimodal

Combina várias fontes de entrada (como imagens e documentos) para gerar rapidamente textos de marketing criativos ou conteúdo multimídia.

[agents.content_creator]
provider = "custom:https://api.defapi.org"
model = "gemini-3-flash"
system_prompt = "You are a creative content creator. Generate engaging content based on user requests."
agentic = true
allowed_tools = ["web_search", "file_read"]
max_iterations = 3