Integración de OpenClaw con Gmail: guía completa de administración de correo electrónico

Introducción

La gestión de correo electrónico es una de las funciones más potentes de OpenClaw. Con la integración de Gmail, OpenClaw puede leer sus correos electrónicos, categorizarlos, redactar respuestas, archivar mensajes y ayudarlo a lograr una bandeja de entrada cero, todo desde sus aplicaciones de chat.

Esta guía cubre todo lo que necesita para integrar OpenClaw con Gmail y automatizar su flujo de trabajo de correo electrónico.

Para otras integraciones, consulte nuestras guías:

• Configuración de WhatsApp
• Configuración de Telegram
• Configuración de Discord
• Configuración de Slack

¿Por qué integrar Gmail?

La integración de Gmail ofrece una potente automatización del correo electrónico:

• Administración de la bandeja de entrada: alcance la bandeja de entrada cero automáticamente
• Categorización inteligente: categorizar automáticamente los correos electrónicos
• Respuestas automáticas: redactar y enviar respuestas
• Resúmenes por correo electrónico: obtenga resúmenes diarios/semanales
• Buscar y filtrar: encuentre correos electrónicos rápidamente
• Manejo de archivos adjuntos — Archivos adjuntos de proceso

Requisitos previos

Antes de configurar la integración de Gmail:

1. OpenClaw instalado — Consulte la guía de instalación
2. OpenClaw configurado: ejecuta openclaw onboard para configurar tu modelo de IA.
3. Cuenta de Gmail: cuenta activa de Gmail o Google Workspace
4. Configuración de OAuth: configurará esto en el siguiente paso

Paso 1: configurar Google OAuth

Crear proyecto de Google Cloud

1. Vaya a Google Cloud Console: console.cloud.google.com
2. Crea un nuevo proyecto o selecciona uno existente
3. Ponle un nombre a tu proyecto (por ejemplo, “Integración de OpenClaw Gmail”)
4. Haga clic en “Crear”

Habilitar la API de Gmail

1. Vaya a “API y servicios” → “Biblioteca”
2. Busque “API de Gmail”
3. Haga clic en “API de Gmail”
4. Haga clic en “Activar”

Crear credenciales OAuth

1. Vaya a “API y servicios” → “Credenciales”

2. Haga clic en “Crear credenciales” → “ID de cliente OAuth”

3. Configurar la pantalla de consentimiento de OAuth (si es la primera vez):

   • Tipo de usuario: externo (o interno para el espacio de trabajo)
   • Nombre de la aplicación: “OpenClaw”
   • Correo electrónico de atención al usuario: Su correo electrónico
   • Contacto del desarrollador: Su correo electrónico
   • Alcances: Agregar https://www.googleapis.com/auth/gmail.readonly y https://www.googleapis.com/auth/gmail.modify
   • Guardar y continuar

4. Crear ID de cliente OAuth:

   • Tipo de aplicación: “Aplicación de escritorio” o “Aplicación web”
   • Nombre: “Escritorio OpenClaw”
   • URI de redireccionamiento autorizado: http://localhost:3000/oauth/callback (o su URL de devolución de llamada de OpenClaw)
   • Haga clic en “Crear”

5. Copiar ID de cliente y secreto de cliente: los necesitará

Configurar OpenClaw OAuth

OpenClaw lo guiará a través de OAuth o lo configurará manualmente:

openclaw config set gmail.oauth.clientId "your-client-id"
openclaw config set gmail.oauth.clientSecret "your-client-secret"

Paso 2: Configurar OpenClaw

Ejecutar configuración de integración

Inicie la integración de Gmail:

openclaw integrations gmail

O utilice el comando de integraciones generales:

openclaw integrations
# Select Gmail from the menu

Flujo completo de OAuth

1. OpenClaw abrirá un navegador o proporcionará una URL
2. Inicia sesión con la cuenta de Google que deseas conectar
3. Revisar permisos — Solicitudes de OpenClaw:
   • Lee tus correos electrónicos
   • Enviar correos electrónicos en su nombre
   • Administre la configuración de su correo electrónico
4. Haga clic en “Permitir”
5. Copiar el código de autorización si se proporciona
6. Pegue el código en el indicador del terminal OpenClaw

Verificar conexión

Deberías ver:

✓ Gmail integration configured successfully!
  Account: your.email@gmail.com
  Access: Read & Send

Paso 3: Comience a administrar el correo electrónico

Verificar correo electrónico

Pídele a OpenClaw que revise tu correo electrónico:

Check my email

O sea más específico:

Show me unread emails from the last 24 hours

Leer correo electrónico específico

Read the email from Sarah

O:

Show me the email about the meeting tomorrow

Categorizar correos electrónicos

OpenClaw puede categorizar automáticamente:

Categorize my inbox

Las categorías pueden incluir:

• Importante
• Boletines
• Sociales
• Promociones
• Actualizaciones

Archivar correos electrónicos

Archive all emails older than 30 days

O:

Archive all newsletters

Eliminar correos electrónicos

Delete all promotional emails from last week
```**Nota:** OpenClaw solicitará confirmación antes de eliminar.

## Funciones avanzadas

### Categorización automática

Habilite la categorización automática de correo electrónico:

```bash
openclaw config set gmail.autoCategorize true
openclaw config set gmail.categories ["important", "newsletters", "social", "promotions"]

OpenClaw categorizará automáticamente los correos electrónicos entrantes.

Automatización cero de la bandeja de entrada

Configurar el cero automático de la bandeja de entrada:

openclaw config set gmail.inboxZero.enabled true
openclaw config set gmail.inboxZero.schedule "daily"
openclaw config set gmail.inboxZero.actions.archive true
openclaw config set gmail.inboxZero.actions.delete true

OpenClaw procesará automáticamente su bandeja de entrada diariamente.

Resúmenes por correo electrónico

Obtenga resúmenes diarios o semanales por correo electrónico:

openclaw config set gmail.summaries.enabled true
openclaw config set gmail.summaries.frequency "daily"
openclaw config set gmail.summaries.time "08:00"

OpenClaw enviará resúmenes a través de su aplicación de chat conectada.

Respuestas automáticas

Configurar respuestas automáticas:

openclaw config set gmail.autoReply.enabled true
openclaw config set gmail.autoReply.rules.outOfOffice true

OpenClaw puede redactar y enviar respuestas automáticamente (con su aprobación o envío automático para casos simples).

Filtros inteligentes

Crea filtros inteligentes:

openclaw config set gmail.filters.newsletters.action "archive"
openclaw config set gmail.filters.promotions.action "delete"
openclaw config set gmail.filters.important.action "star"

Procesamiento de archivos adjuntos

OpenClaw puede procesar archivos adjuntos:

• Descargar archivos adjuntos automáticamente
• Extraer texto de archivos PDF
• Imágenes de proceso y documentos
• Resumir el contenido del archivo adjunto

Opciones de configuración

Límites de correo electrónico

Configure cuántos correos electrónicos procesar:

openclaw config set gmail.limits.maxEmailsPerRequest 50
openclaw config set gmail.limits.maxEmailsPerDay 1000

Formato de respuesta

Configure cómo se muestran los correos electrónicos:

openclaw config set gmail.format "summary"

Opciones:

• full — Contenido completo del correo electrónico
• summary — Resumen generado por IA
• snippet: solo fragmento de Gmail

Configuración de privacidad

Configurar privacidad:

openclaw config set gmail.privacy.localOnly true
openclaw config set gmail.privacy.noCloudStorage true

Configuración de notificaciones

Controlar las notificaciones por correo electrónico:

openclaw config set gmail.notifications.enabled true
openclaw config set gmail.notifications.importantOnly true
openclaw config set gmail.notifications.quietHours "22:00-08:00"

Ejemplos de uso

Informe diario

Configure una sesión informativa diaria por correo electrónico:

Send me a daily email briefing at 8 AM

OpenClaw resumirá:

• Correos electrónicos importantes
• Recuento no leído
• Elementos de acción
• Eventos del calendario desde correos electrónicos.

Búsqueda de correo electrónico

Busca en tus correos electrónicos:

Find emails about the project proposal

O:

Show me all emails from John in the last month

Borradores de respuestas

Pídale a OpenClaw que redacte respuestas:

Draft a response to Sarah's email about the meeting

OpenClaw:

1. Lea el correo electrónico original
2. Redactar una respuesta
3. Mostrarle para su aprobación
4. Enviar cuando sea aprobado

Subprocesos de correo electrónico

Manejar hilos de correo electrónico:

Show me the conversation thread about the budget

OpenClaw puede seguir y resumir hilos de conversación completos.

Acciones masivas

Realizar acciones masivas:

Archive all emails from newsletters older than 7 days

O:

Mark all emails from my team as important

Solución de problemas

Errores de OAuth

Si OAuth falla:

1. Verificar credenciales: verificar la identificación y el secreto del cliente
2. Verifique el URI de redireccionamiento: debe coincidir exactamente
3. Verificar alcances: asegúrese de que se soliciten todos los alcances requeridos
4. Volver a autenticar:

   openclaw integrations gmail --reauth

Permiso denegado

Si ve errores de permiso:

1. Verifique los alcances de OAuth: asegúrese de que se otorgue el alcance gmail.modify
2. Reautorizar: completar el flujo de OAuth nuevamente
3. Verifique la cuenta de Google: asegúrese de que esté conectada la cuenta correcta

Correos electrónicos que no se cargan

Si los correos electrónicos no se cargan:

1. Verificar cuota de API: la API de Gmail tiene cuotas diarias

2. Compruebe la conexión:

   openclaw status

3. Verificar registros:

   openclaw logs

4. Pruebe la API de Gmail:

   openclaw test gmail

Limitación de velocidad

Si alcanza los límites de tasa:

1. Reducir la frecuencia de solicitudes:

   openclaw config set gmail.rateLimit 10

2. Utilice operaciones por lotes: procese varios correos electrónicos a la vez

3. Verifique las cuotas de la API de Gmail: monitoree en Google Cloud Console

Mejores prácticas de seguridad

Seguridad de OAuth

• Mantenga las credenciales en secreto: nunca comparta el ID/secreto del cliente

• Usar variables de entorno:

  export GMAIL_CLIENT_ID="your-id"
  export GMAIL_CLIENT_SECRET="your-secret"

• Rotar credenciales: regenerarse si está comprometido

Privacidad del correo electrónico

• Procesamiento local: correos electrónicos procesados localmente cuando sea posible
• Sin almacenamiento en la nube: a menos que se configure explícitamente
• Almacenamiento seguro: credenciales almacenadas de forma segura en ~/.openclaw

Control de acceso- Limitar permisos: solo otorga los alcances necesarios

• Monitorear el uso: verifique los registros de OpenClaw periódicamente
• Revocar acceso: desconéctese si es necesario:

  openclaw integrations gmail --disconnect

Casos de uso avanzados

Gestión de correo electrónico del equipo

Usar para correo electrónico del equipo:

• Bandeja de entrada compartida: administrar la bandeja de entrada del equipo
• Enrutamiento de correo electrónico: enruta los correos electrónicos a los miembros del equipo
• Plantillas de respuesta: respuestas estandarizadas

Atención al cliente

Uso para atención al cliente:

• Respuestas automáticas: responde a preguntas comunes
• Creación de tickets: crea tickets a partir de correos electrónicos
• Escalamiento: escalar problemas complejos

Productividad personal

Uso para productividad personal:

• Bandeja de entrada cero: mantener la bandeja de entrada limpia
• Resúmenes por correo electrónico: resúmenes diarios/semanales
• Respuestas rápidas: manejo rápido del correo electrónico

Comparación con otros servicios de correo electrónico

Gmail frente a IMAP

• Gmail: OAuth, mejor API, funciones específicas de Gmail
• IMAP: funciona con cualquier proveedor de correo electrónico, más básico

OpenClaw es compatible tanto con la API de Gmail como con IMAP.

Próximos pasos

Ahora que Gmail está conectado:

1. Explore otras integraciones: WhatsApp, Telegram, Discord
2. Configurar habilidades — Biblioteca de habilidades
3. Configurar Calendario — Vincular con Google Calendar
4. Lea las preguntas frecuentes — Preguntas comunes

Conclusión

La integración de Gmail transforma OpenClaw en un potente asistente de gestión de correo electrónico. Desde la automatización cero de la bandeja de entrada hasta la categorización inteligente y las respuestas automáticas, OpenClaw puede manejar su flujo de trabajo de correo electrónico de manera eficiente. La configuración de OAuth es sencilla y, una vez conectado, puedes administrar toda tu bandeja de entrada desde tu aplicación de chat favorita.

Para obtener más ayuda, consulte nuestra página de integraciones o Preguntas frecuentes. ¡Feliz gestión de correo electrónico con OpenClaw!