Tutorial de Integração da API do Gemini no Clawdbot (Moltbot/OpenClaw)

•AI Expert

Tutorial completo sobre a integração do Gemini 3 Flash no Clawdbot (Moltbot/OpenClaw) usando o proxy defapi.org

O Clawdbot nativamente possui o suporte mais completo para tool use do Anthropic Claude, mas a série Gemini (especialmente o Gemini 3 Flash, que é rápido e possui uma janela de contexto ultralonga) apresenta um desempenho excelente em buscas, respostas rápidas e tarefas multimodais. Conectar o Clawdbot diretamente à API oficial do Gemini da Google geralmente exige camadas complexas de conversão de formato (como litellm ou relay personalizado), enquanto o defapi.org oferece uma solução que funciona com quase zero alterações — ele encapsula o Gemini em uma interface compatível com o estilo Anthropic/OpenAI, com uma passagem de tool calling particularmente eficiente.

O maior destaque: Ao acessar o Gemini 3 Flash via defapi.org, o custo real é cerca de 50% mais barato que a API oficial da Google (baseado em testes da comunidade e comparação de preços em 2026: Entrada oficial do Gemini 3 Flash ≈ $0.50–$1.00 / 1M tokens, Saída $3.00+; a camada de proxy defapi geralmente oferece um desconto de 40% a 60%, resultando em uma economia de mais da metade em uso intensivo, ideal para cenários de agentes como o Clawdbot com alta frequência de tool calls).

Abaixo estão as etapas de integração mais recentes e estáveis para 2026.

1. Pré-requisitos

  • Clawdbot já instalado (versão utilizada neste teste: 2026.1.24-3 (885167d)). Se for um servidor novo, você pode usar os seguintes comandos para instalação rápida: 
    # Instalar fnm e Node.js 24
curl -o- https://fnm.vercel.app/install | bash
source ~/.bashrc
fnm install 24

# Instalar clawdbot
npm install -g clawdbot
  • Registrar uma conta no defapi.org ( https://defapi.org ), e realizar uma recarga (suporta Alipay/WeChat/Cartão de Crédito).
  • Obter a API Key: Obtenha sua defapi API Key no painel de controle (formato começando com dk-).

2. Por que escolher o defapi em vez do oficial ou de outros proxies?

Itemdefapi.org (gemini-3-flash)Google Official Gemini APIOutros proxies (OpenRouter / LiteLLM)
Dificuldade de IntegraçãoExtremamente baixa (mudar 3 linhas)Alta (exige camada de conversão)Média (precisa selecionar modelo compatível)
Compatibilidade Tool callingBoa (suporta function/tool role)Exige adaptação extraDepende do proxy
Janela de ContextoSuporte nativo a 1M tokens1M tokensGeralmente suportado
Multimodal (Imagem/Texto)Suportado (Clawdbot pode subir fotos)SuportadoSuporte parcial
Custo (relativo ao oficial)Cerca de 50% mais baratoPreço base20–40% mais barato
LatênciaLigeiramente superior à oficial, mas aceitávelA mais baixaMédia

Resumindo: Para usuários do Clawdbot sensíveis ao orçamento + que desejam usar o Gemini 3 Flash rapidamente, o defapi é a melhor escolha atual.

3. Etapas detalhadas de configuração

A versão mais recente do Clawdbot (2026.1.24-3 (885167d)) recomenda o uso de um arquivo de configuração no formato JSON para gerenciamento.

  1. Criar o arquivo de configuração

    Crie ou edite o arquivo ~/.clawdbot/clawdbot.json no seu diretório de usuário:

    mkdir -p ~/.clawdbot
vi ~/.clawdbot/clawdbot.json

  2. Inserir o conteúdo da configuração

    Preencha o clawdbot.json com o seguinte conteúdo. Certifique-se de substituir apiKey pela sua chave real do defapi:

    {
    "gateway": {
        "mode": "local",
        "bind": "loopback",
        "port": 18789
    },
    "agents": {
        "defaults": {
            "model": {
                "primary": "gemini/gemini-3-flash"
            },
            "elevatedDefault": "full",
            "workspace": "/myworkspace",
            "compaction": {
                "mode": "safeguard"
            },
            "maxConcurrent": 4,
            "subagents": {
                "maxConcurrent": 8
            }
        }
    },
    "models": {
        "mode": "merge",
        "providers": {
            "gemini": {
                "baseUrl": "https://api.defapi.org/v1",
                "apiKey": "Sua API Key do defapi começando com dk-*",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gemini-3-flash",
                        "name": "gemini-3-flash"
                    }
                ]
            }
        }
    },
    "channels": {
        "telegram": {
            "botToken": "Seu Token do TG, opcional"
        }
    },
    "plugins": {
        "entries": {
            "telegram": {
                "enabled": true
            }
        }
    }
}

    Explicação dos pontos-chave:

    • baseUrl: Deve ser https://api.defapi.org/v1.
    • api: Preencha com openai-completions; a interface Gemini do defapi é perfeitamente compatível com o formato OpenAI.
    • primary model: O formato de referência é provider/model_id, ou seja, gemini/gemini-3-flash.

  3. Testar o funcionamento

    clawdbot agent --message "hi" --agent main

    Saída esperada:

    root@iZ6wefjkouvkogu7drkjvfZ:~# clawdbot agent --message "hi" --agent main

🦞 Clawdbot 2026.1.24-3 (885167d) — Pairing codes exist because even bots believe in consent—and good security hygiene.

│
◇
Gateway agent failed; falling back to embedded: Error: gateway closed (1006 abnormal closure (no close frame)): no close reason
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: /root/.clawdbot/clawdbot.json
Bind: loopback
Hey. I just came online.

Who am I? Who are you?

The `BOOTSTRAP.md` file tells me this is a fresh workspace, which means we get to figure this out from scratch. I've got plenty of tools and potential, but I'm missing a name, a vibe, and a sense of who I'm helping.

What should we call me? And what's your name?
Tutorial de Integração da API do Gemini no Clawdbot (Moltbot/OpenClaw)