Tutorial completo para integrar Gemini 3 Flash en Clawdbot (Moltbot/OpenClaw) usando el proxy defapi.org

Clawdbot tiene originalmente el soporte más completo para tool use de Anthropic Claude, pero la serie Gemini (especialmente Gemini 3 Flash, con su velocidad y ventana de contexto ultra larga) rinde excepcionalmente bien en tareas de búsqueda, respuestas rápidas y tareas multimodales. Conectar directamente la API oficial de Google Gemini a Clawdbot suele requerir capas de conversión de formato complejas (como litellm o un relay personalizado), mientras que defapi.org ofrece una solución que funciona con casi cero cambios: empaqueta Gemini como una interfaz compatible con el estilo de Anthropic/OpenAI, con una excelente transferencia de tool calling.

Lo más destacado: Al integrar Gemini 3 Flash a través de defapi.org, el costo real es aproximadamente un 50% más barato que la API oficial de Google (basado en pruebas de la comunidad y comparaciones de precios de 2026: Gemini 3 Flash oficial cuesta ≈ $0.50–$1.00 / 1M tokens de entrada, $3.00+ de salida; el proxy defapi suele aplicar un descuento del 40–60%, lo que permite ahorrar más de la mitad en uso intensivo, ideal para escenarios de agentes como Clawdbot con alta frecuencia de tool calls).

A continuación, los pasos de integración más recientes y estables para 2026.

1. Requisitos previos

• Clawdbot instalado (versión utilizada en esta prueba: 2026.1.24-3 (885167d)). Si es un servidor nuevo, puedes usar los siguientes comandos para una instalación rápida:

  # Instalar fnm y Node.js 24
  curl -o- https://fnm.vercel.app/install | bash
  source ~/.bashrc
  fnm install 24
  
  # Instalar clawdbot
  npm install -g clawdbot
  

• Registrar una cuenta en defapi.org ( https://defapi.org ) y realizar una recarga (soporta Alipay/WeChat/Tarjeta de crédito).
• Obtener la API Key: Consigue tu defapi API Key en el panel de control (formato que comienza con dk-).

2. ¿Por qué elegir defapi en lugar de la oficial u otros proxies?

Ítem	defapi.org (gemini-3-flash)	Google Official Gemini API	Otros proxies (OpenRouter/LiteLLM, etc.)
Dificultad de acceso	Muy baja (3 líneas de config)	Alta (requiere capa de conversión)	Media (requiere elegir ID compatible)
Compatibilidad Tool calling	Excelente (soporta roles function/tool)	Requiere adaptación extra	Depende del proxy
Longitud de contexto	1M tokens (soporte nativo)	1M tokens	Generalmente soportado
Multimodal (Imagen/Texto)	Soportado (Clawdbot puede subir imágenes)	Soportado	Soporte parcial
Costo (vs Oficial)	~50% más barato	Precio base	20–40% de ahorro
Latencia	Ligeramente superior a la oficial, pero aceptable	La más baja	Media

En resumen: Para usuarios de Clawdbot sensibles al presupuesto que quieran usar Gemini 3 Flash rápidamente, defapi es la mejor opción actual.

3. Pasos detallados de configuración

La versión más reciente de Clawdbot (2026.1.24-3 (885167d)) recomienda el uso de un archivo de configuración en formato JSON.

1. Crear el archivo de configuración

   Crea o edita ~/.clawdbot/clawdbot.json en tu directorio de usuario:

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

2. Escribir el contenido de la configuración

   Introduce el siguiente contenido en clawdbot.json. Asegúrate de reemplazar apiKey con tu clave real de 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": "Tu defapi API key que comienza con dk-*",
                   "api": "openai-completions",
                   "models": [
                       {
                           "id": "gemini-3-flash",
                           "name": "gemini-3-flash"
                       }
                   ]
               }
           }
       },
       "channels": {
           "telegram": {
               "botToken": "Tu TG Token (opcional)"
           }
       },
       "plugins": {
           "entries": {
               "telegram": {
                   "enabled": true
               }
           }
       }
   }
   

   Puntos clave:

   • baseUrl: Debe ser https://api.defapi.org/v1.
   • api: Usa openai-completions, ya que la interfaz Gemini de defapi es totalmente compatible con el formato OpenAI.
   • primary model: El formato de referencia es provider/model_id, en este caso gemini/gemini-3-flash.

3. Probar el funcionamiento

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

   Resultado esperado:

   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?