Conectar OpenClaw a Gmail, Calendario y Búsqueda Web — Guía de integración

"Una IA que solo puede chatear frente a otra que puede leer tus correos, gestionar tu calendario y buscar en la web: la diferencia no es el IQ, son las manos. Hoy le damos manos."

Objetivo de hoy

De "puede hablar" a "puede hacer"

Tu asistente ya sabe chatear. Hoy empieza a actuar sobre datos reales.

En OpenClaw, cada nueva capacidad viene de un skill, un conjunto de archivos que le dice al asistente cómo interactuar con un servicio externo. Hoy conectarás cuatro:

Conecta las cuatro integraciones principales

Gmail

• Lo que necesitas primero: Un proyecto de Google Cloud con Gmail API habilitada y credenciales OAuth de escritorio guardadas como credentials.json.
• Comando de instalación: clawhub install gog
• Qué hacer: Ejecuta el instalador, completa una vez el flujo OAuth en el navegador y confirma que OpenClaw crea token.json.
• Prompt de prueba: "What are my top 3 emails today?"

Google Calendar

• Lo que necesitas primero: El mismo proyecto de Google Cloud, esta vez con Google Calendar API también habilitada.
• Comando de instalación: clawhub install gog
• Qué hacer: Reutiliza la misma autorización de Google de Gmail para que OpenClaw pueda leer tus eventos reales.
• Prompt de prueba: "What meetings do I have this week?"

Configuración de Gmail + Calendario (5 pasos):

1. Ve a console.cloud.google.com → crea un proyecto nuevo
2. Habilita "Gmail API" y "Google Calendar API" (búscalas en API Library)
3. Ve a "Credentials" → Create OAuth client ID → Desktop app → descarga credentials.json
4. Mueve credentials.json a ~/.openclaw/workspace/credentials.json
5. Ejecuta clawhub install gog - se abrirá una ventana del navegador para la autorización

Después de autorizar, se crea automáticamente un archivo token.json. Mantenlo privado: chmod 600 ~/.openclaw/workspace/token.json

Todas las integraciones de channels →

Búsqueda web

• Lo que necesitas primero: Una cuenta en un proveedor de búsqueda como Brave Search y una API key válida.
• Comando de instalación: openclaw configure --section web
• Qué hacer: Pega la API key en el asistente y guarda la configuración del proveedor antes de probar.
• Prompt de prueba: "What's happening in AI this week?"

Browser

• Lo que necesitas primero: Una instalación funcional de OpenClaw (la capacidad de navegador viene integrada, no necesita instalación aparte).
• Comando de activación: openclaw browser --browser-profile openclaw status
• Qué hacer: Comprueba el estado del navegador. Si aparece "disabled", actívalo en la configuración y reinicia el gateway con openclaw gateway restart.
• Prompt de prueba: "What does https://example.com say?"

Skill de Browser: configuración y uso →

Por qué esto lo cambia todo

Antes del Día 4, "Help me write an email" producía un borrador genérico. Después del Día 4, "Check my email and draft a reply to the partner inquiry" puede leer el hilo real, revisar tu calendario para el timing, buscar el contexto que falta y sacar detalles de una página web en vivo.

La diferencia no es mejor prompting. La diferencia son entradas reales.

Seguridad primero

Con Gmail, calendario y navegador conectados, tu asistente puede tocar datos privados. Mantén estos hábitos desde el primer día:

1. No pongas API keys en Git. Usa variables de entorno o archivos .env.
2. Protege los tokens OAuth. Ejecuta chmod 600 ~/.openclaw/workspace/token.json para que solo tu usuario pueda leerlo.
3. Aplica mínimo privilegio. Si solo necesitas leer Gmail, no concedas permiso para enviar.
4. Escribe límites en SOUL.md. Por ejemplo: "External messages must be confirmed before sending."

Monitoreo de auth y credenciales →

Criterios mínimos de éxito

• Gmail: pregunta "What are my top 3 emails today?" y recibe resultados reales
• Calendar: pregunta "What meetings do I have this week?" y ve tus eventos reales
• Search: pregunta "What's happening in AI this week?" y recibe noticias actuales
• Browser: pregunta "What does [any URL] say?" y recibe contenido extraído

Ver las 50+ integraciones

Hoy cubres las cuatro conexiones más útiles para casi cualquiera. OpenClaw admite 50+ en total:

openclaw.ai/integrations - directorio completo de integraciones →

Allí están listados channels, proveedores de modelo e integraciones de tools.

Problemas comunes

• Error de permisos del token OAuth: Si la auth de Google funciona pero las peticiones fallan, elimina el ~/.openclaw/workspace/token.json obsoleto, vuelve a ejecutar clawhub install gog y después aplica chmod 600 ~/.openclaw/workspace/token.json.
• La Search API key no se reconoce: Vuelve a ejecutar openclaw configure --section web, pega exactamente la key del proveedor elegido y repite el prompt de prueba de búsqueda en una conversación nueva.
• Browser no responde: Si OpenClaw no puede acceder a un navegador, ejecuta openclaw browser --browser-profile openclaw status para comprobarlo y reinicia con openclaw gateway restart. Luego pregunta: "What does https://example.com say?"
• El calendario aparece vacío: Asegúrate de que Calendar API esté habilitada en el mismo proyecto de Google Cloud usado para Gmail OAuth y vuelve a probar con "What meetings do I have this week?"

Lo que acaba de cambiar

Tu asistente ya puede moverse entre la bandeja de entrada, el calendario, resultados de búsqueda y páginas web en vivo. Mañana ampliarás estas tools básicas y empezarás a instalar los skills que encajan con tu propio flujo de trabajo.