Conecta OpenClaw con Google Gemini

Manejar los costes de las API de IA y las limitaciones de contexto suele ser frustrante. A veces solo necesitas procesar archivos grandes o mantener conversaciones largas sin que la factura se dispare al final del mes.

Google Gemini es uno de los secretos mejor guardados ahora mismo: su capa gratuita es muy generosa. Mientras otros proveedores cobran por cada token desde el primer momento, Gemini te ofrece 1 millón de tokens de contexto y una base gratuita sólida. Si construyes herramientas que analizan documentos extensos, Gemini es difícil de superar.

Requisitos previos

• Una cuenta de Google para acceder a AI Studio.
• OpenClaw instalado y funcionando.

---

Quick Start (5 minutos)

Paso 1: Obtén tu API Key

1. Ve a Google AI Studio.
2. Inicia sesión con tu cuenta de Google.
3. Haz clic en “Get API Key” → “Create API Key”.
4. Copia la clave.

Paso 2: Configura OpenClaw

Opción A: Variable de entorno

export GEMINI_API_KEY="tu-api-key-aquí"

Opción B: Configuración por CLI

openclaw config set models.providers.gemini.apiKey "tu-api-key-aquí"

Paso 3: Configura Gemini como tu modelo

Edita tu archivo de configuración de OpenClaw:

{
  agents: {
    defaults: {
      model: { primary: "gemini/gemini-2.5-flash" }
    }
  }
}

Ya está. Ya estás usando Gemini.

---

Autenticación OAuth (Alternativa)

Si prefieres una autenticación más segura y sin claves manuales usando tu cuenta de Google:

Opción 1: Durante el asistente de configuración

1. Ejecuta openclaw onboard.
2. Selecciona “Google” como tu AI provider.
3. Elige “OAuth Authentication”.
4. Completa el flujo en tu navegador.
5. OpenClaw guardará el token de forma segura.

Opción 2: Plugin de autenticación por CLI

Si ya tienes OpenClaw instalado, activa el plugin de autenticación:

# Activa el plugin de autenticación de Gemini
openclaw plugins enable google-gemini-cli-auth

# Autentícate y configúralo como proveedor por defecto
openclaw models auth login --provider google-gemini-cli --set-default

Esto abrirá una ventana en tu navegador para el OAuth de Google. Una vez listo, podrás usar Gemini sin gestionar claves API.

Nota: OAuth es ideal para uso personal. Para despliegues en servidores o automatizaciones, usa una API Key.

---

Modelos de Gemini disponibles

Modelo	Ideal para	Context Window
gemini-2.5-flash	Respuestas rápidas	1M tokens
gemini-2.5-pro	Razonamiento complejo	1M tokens
gemini-2.0-flash	Equilibrio	128K tokens

Selección de modelo

{
  agents: {
    defaults: {
      model: {
        primary: "gemini/gemini-2.5-flash",
        fallback: ["gemini/gemini-2.0-flash"]
      }
    }
  }
}

---

Entendiendo la capa gratuita de Gemini

La capa gratuita de Google incluye:

• 60 solicitudes por minuto (modelos Flash).
• 2 solicitudes por minuto (modelos Pro).
• 1 millón de tokens de ventana de contexto.

Para la mayoría de casos de uso personal, esto es más que suficiente.

Rate Limits

Si alcanzas los límites de velocidad, intenta lo siguiente:

• Cambia a modelos Flash para límites más altos.
• Añade pausas entre tus solicitudes.

---

Configuración avanzada

Configuración completa del proveedor

{
  models: {
    providers: {
      gemini: {
        apiKey: "tu-api-key",
        models: [
          {
            id: "gemini-2.5-flash",
            name: "Gemini 2.5 Flash",
            reasoning: false,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

Uso con otros proveedores

Puedes mezclar Gemini con otros modelos:

{
  agents: {
    defaults: {
      model: {
        primary: "gemini/gemini-2.5-flash",  // Rápido y gratuito
        fallback: ["anthropic/claude-sonnet-4"] // Para tareas complejas
      }
    }
  }
}

---

Solución de problemas

”API key not valid”

Revisa tu API Key:

1. Entra en Google AI Studio.
2. Verifica que la clave esté activa.
3. Asegúrate de no haber copiado espacios en blanco extra.

”Quota exceeded”

Has llegado al límite de la capa gratuita. Tienes estas opciones:

• Esperar a que la cuota se reinicie (es diario).
• Cambiar a modelos Flash para tener límites más altos.

”Model not found”

Verifica el ID del modelo con este comando:

openclaw models list

Asegúrate de usar el formato correcto: gemini/nombre-del-modelo.

¿Sigues con problemas? Nuestro AI Setup Assistant conoce toda la documentación de OpenClaw y puede ayudarte a solucionar tu configuración de Gemini en tiempo real.

---

Gemini frente a otros proveedores

Aspecto	Gemini	Claude	OpenAI
Ideal para	Documentos largos	Matices creativos	Coding y análisis
Capa gratuita	✅ Generosa	❌ Ninguna	❌ Ninguna

Mi recomendación: Usa Gemini para procesar documentos y como un fallback económico. Mantén a Claude o GPT para tareas que requieran la máxima calidad de salida.

---

Próximos pasos

• Install OpenClaw → — Guía completa de instalación.
• Use Ollama → — IA local gratuita.
• Connect Telegram → — Controla todo desde tu móvil.
• Docker deployment → — Disponibilidad 24/7.