Tutorial de integración de la API de PicoClaw Gemini

PicoClaw es un asistente AI ultraligero que puede funcionar en hardware de 10 dólares, con un uso de memoria de <10MB. Este tutorial describirá cómo configurar la API de Gemini para PicoClaw.

Introducción

PicoClaw admite varias formas de conectar la API de Gemini:

• Plataforma Defapi (recomendada): descuento del 50%, sin necesidad de usar VPN, acceso directo desde el país
• API oficial de Google Gemini: conexión directa al servicio oficial
• OpenRouter: acceso a través de un router de terceros

Método 1: Defapi (recomendado)

Defapi es una plataforma de agregación de APIs de AI, con precios a solo la mitad de los oficiales, ideal para desarrolladores individuales y proyectos pequeños. El modelo de Gemini de Defapi es compatible con el protocolo OpenAI v1/chat/completions, y se puede usar directamente.

1. Obtener la clave de API de Defapi

1. Visita el sitio web de Defapi y regístrate
2. Obtén la clave de API en tu centro personal

2. Configurar PicoClaw

Edita el archivo de configuración ~/.picoclaw/config.json:

{
  "agents": {
    "defaults": {
      "model": "google/gemini-2.0-flash"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "Tu clave de Defapi",
      "api_base": "https://api.defapi.org"
    }
  }
}

3. Modelos de Gemini compatibles

4. Ventajas de Defapi

• Descuento del 50%: 50% más barato que el precio oficial
• Sin necesidad de VPN: acceso directo desde el país
• Estable y rápido: servicio estable de nivel empresarial
• Buena compatibilidad: compatible con el protocolo OpenAI v1/chat/completions

---

Método 2: API oficial de Gemini

1. Obtener la clave de API

1. Visita Google AI Studio
2. Crea tu clave de API

2. Configurar PicoClaw

{
  "agents": {
    "defaults": {
      "model": "gemini-2.0-flash"
    }
  },
  "providers": {
    "gemini": {
      "api_key": "tu-clave-de-api-gemini"
    }
  }
}

Si necesitas un proxy:

{
  "providers": {
    "gemini": {
      "api_key": "tu-clave-de-api-gemini",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

Método 3: OpenRouter

1. Obtener la clave de API

Visita OpenRouter para obtener tu clave de API.

2. Configurar PicoClaw

{
  "agents": {
    "defaults": {
      "model": "google/gemini-2.0-flash"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    }
  }
}

Si necesitas un proxy:

{
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

Verificar si PicoClaw está funcionando correctamente

Método 1: Prueba de mensajes directos

# Accede al directorio de PicoClaw
cd picoclaw

# Prueba si Gemini está funcionando correctamente
picoclaw agent -m "Hola, por favor responde hello"

Si devuelve una respuesta normal, ¡la configuración fue exitosa!

Método 2: Iniciar prueba del Gateway

# Inicia el gateway
picoclaw gateway

# Luego envía un mensaje de prueba a través del canal de chat configurado (Telegram/Discord, etc.)

Método 3: Consultar registros

# Verifica los registros de PicoClaw
docker compose logs -f picoclaw-gateway

---

Casos de uso comunes de PicoClaw

1. Asistente de conversación inteligente

Configura un bot de Telegram o Discord para crear un asistente de conversación AI siempre disponible.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "TU_TOKEN_DEL_BOT"
    }
  }
}

2. Asistente de revisión de código

PicoClaw puede leer archivos de código, ayudando a revisar y optimizar el código.

# Pide a la AI que revise el código
picoclaw agent -m "Por favor revisa la calidad del código del archivo src/main.go"

3. Generación de documentos

Utiliza AI para generar automáticamente documentación de proyectos, documentación de API, etc.

# Genera README
picoclaw agent -m "Genera un README.md para este proyecto"

4. Tareas programadas

Configura tareas de latido para que AI realice chequeos o informes periódicamente.

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

5. Despliegue multicanal

Configura múltiples canales de chat simultáneamente para lograr un asistente AI multiplataforma.

{
  "channels": {
    "telegram": { "enabled": true },
    "discord": { "enabled": true },
    "qq": { "enabled": true }
  }
}

---

Preguntas frecuentes

1. Retorna "no API key configured"

Verifica que api_key esté correctamente configurada en el archivo de configuración.

2. Modelo no compatible

Asegúrate de que el nombre del modelo utilizado sea correcto y prueba con el modelo predeterminado gemini-2.0-flash.

3. Problemas de conexión de red

Si necesitas un proxy, añade el campo proxy en la configuración del proveedor correspondiente.

---

Enlaces relacionados

• Repositorio oficial de PicoClaw
• Sitio web de Defapi
• Google AI Studio
• OpenRouter