Cómo Conectar Google Workspace CLI con OpenClaw

TL;DR

Google Workspace CLI (gws) es una herramienta de línea de comandos que brinda a los agentes de IA acceso directo a Gmail, Drive, Calendar, Sheets, Docs y a cada API de Google Workspace a través de un resultado JSON estructurado. Con soporte nativo de OpenClaw y más de 100 habilidades de agente predefinidas, puedes automatizar todo tu flujo de trabajo de Workspace a través de aplicaciones de mensajería como WhatsApp o Discord. La configuración toma 5 minutos con npm install -g @googleworkspace/cli seguido de gws auth setup.

Introducción

¿Qué pasaría si tu agente de IA pudiera leer tu Gmail, actualizar tu Calendario y organizar tu Google Drive sin que tuvieras que mover un dedo?

La mayoría de las herramientas de automatización de Google Workspace requieren configuraciones de API complejas, código personalizado o servicios de terceros costosos. Los desarrolladores dedican horas a luchar con flujos de OAuth, límites de velocidad y documentación desactualizada. Mientras tanto, los agentes de IA permanecen inactivos porque carecen de acceso directo a las herramientas que usamos todos los días.

Los ingenieros de Google acaban de lanzar algo que lo cambia todo. La CLI de Google Workspace (gws) ya ha acumulado más de 12,400 estrellas en GitHub y viene con más de 100 habilidades de agente predefinidas. Está construida en Rust, lee el Servicio de Descubrimiento de Google en tiempo de ejecución y genera un JSON estructurado que cualquier agente de IA puede analizar.

¿Qué es Google Workspace CLI?

Google Workspace CLI (gws) es una única herramienta de línea de comandos que envuelve cada API de Google Workspace en comandos limpios y componibles. Cubre Gmail, Google Drive, Calendar, Sheets, Docs, Slides, Chat, Tasks, Meet, Forms, Keep, Classroom, Admin y básicamente todas las APIs de Google Workspace existentes.

Esto es lo que la hace diferente de otras herramientas CLI que has usado.

La mayoría de las herramientas de desarrollo se envían con una lista fija de comandos. Cuando Google añade un nuevo endpoint de API, alguien tiene que actualizar manualmente la herramienta, lanzar una nueva versión y esperar que todos la actualicen. Es una cinta de correr de mantenimiento que nunca termina. La mayoría de los wrappers de Google Workspace que has visto ya están desactualizados en el momento en que los instalas.

gws resuelve esto de una manera fundamentalmente diferente. En lugar de codificar comandos, se comunica directamente con el Servicio de Descubrimiento de Google. Piensa en esto como el propio catálogo en vivo de Google de cada acción disponible en todas sus aplicaciones de Workspace. Cada API, cada método, cada parámetro. Google mantiene este catálogo por sí mismo, y siempre está actualizado.

Cuando ejecutas gws, lo primero que hace es extraer este catálogo en vivo y construir toda su estructura de comandos sobre la marcha a partir de lo que Google dice que está disponible en ese momento. Si Google lanza una nueva función de Sheets a las 2 pm de hoy, tu CLI ya la soporta a las 2:01 pm. Sin actualización. Sin nueva versión. Sin esperar a que un mantenedor se ponga al día.

La herramienta literalmente no puede quedarse atrás porque lee de la fuente de la verdad cada vez.

Ejemplo rápido

# Listar los 10 archivos más recientes
gws drive files list --params '{"pageSize": 10}'

# Crear una hoja de cálculo
gws sheets spreadsheets create --json '{"properties": {"title": "Presupuesto Q1"}}'

# Enviar un mensaje de Chat
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Despliegue completado."}'

Cada respuesta se devuelve como JSON estructurado. No HTML. No texto formateado. Datos limpios, predecibles y legibles por máquina con los que un agente de IA puede razonar y actuar de inmediato.

Por qué gws es importante para los agentes de IA

La comunidad de agentes de IA está entusiasmada con gws por razones técnicas específicas.

Salida JSON estructurada: Cada respuesta se devuelve como JSON estructurado. Tu agente no necesita analizar HTML ni adivinar el formato. Obtiene datos limpios con los que puede trabajar de inmediato.

No se requieren herramientas personalizadas: La mayoría de las configuraciones de agentes de IA requieren que construyas herramientas personalizadas para cada API a la que desees acceder. Con gws, las herramientas ya están construidas. Tu agente solo necesita saber cómo ejecutar comandos de shell.

Más de 100 habilidades de agente predefinidas: El repositorio incluye más de 100 archivos SKILL.md, uno para cada API compatible, además de ayudas de alto nivel para flujos de trabajo comunes y 50 recetas seleccionadas para Gmail, Drive, Docs, Calendar y Sheets.

Soporte nativo de OpenClaw: Google incluyó las instrucciones de configuración de OpenClaw directamente en el README. Esto no es un truco o una solución alternativa de la comunidad. Es un soporte de primera clase, integrado.

Servidor MCP incorporado: gws incluye un servidor de Protocolo de Contexto de Modelo (MCP) que expone las APIs de Google Workspace como herramientas estructuradas. Cualquier cliente compatible con MCP (Claude Desktop, Gemini CLI, VS Code) puede llamar a estas herramientas directamente.

La infraestructura de la economía de agentes

Estamos viendo la aparición de la infraestructura de agentes más rápido de lo que la mayoría de la gente se da cuenta. Herramientas como gws representan la fontanería que impulsará los flujos de trabajo autónomos. En lugar de construir integraciones personalizadas para cada plataforma SaaS, los agentes pueden depender de CLIs estandarizadas con formatos de salida consistentes.

Esto importa porque reduce la barrera de entrada. No necesitas un equipo de ingenieros para construir automatización de IA para tu Workspace. Necesitas npm y 5 minutos.

Cómo funciona gws: La arquitectura

gws utiliza una estrategia de análisis de dos fases que vale la pena entender.

Fase 1: Identificación del servicio

Cuando ejecutas gws drive files list, la CLI lee el primer argumento (drive) para identificar el servicio.

Fase 2: Construcción dinámica de comandos

La CLI obtiene el Documento de Descubrimiento del servicio de Google (caché durante 24 horas). Construye un árbol de `clap::Command` a partir de los recursos y métodos del documento. Aquí es donde ocurre la magia: toda la superficie de comandos se genera a partir de la propia especificación de la API de Google.

Fase 3: Ejecución de la solicitud

La CLI vuelve a analizar los argumentos restantes, se autentica utilizando tus credenciales configuradas, construye la solicitud HTTP y la ejecuta.

Toda la salida (respuestas exitosas, errores, metadatos de descarga) es JSON estructurado.

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  Obtener Documento de Descubrimiento (caché 24h)       │
│       ↓                                                 │
│  Construir árbol clap::Command a partir de recursos y métodos │
│       ↓                                                 │
│  Volver a analizar los argumentos restantes             │
│       ↓                                                 │
│  Autenticar → Construir Solicitud HTTP → Ejecutar      │
│       ↓                                                 │
│  Salida: JSON estructurado                             │
└─────────────────────────────────────────────────────────┘

Esta arquitectura significa que gws puede soportar cada API de Google Workspace sin codificar un solo comando. El Documento de Descubrimiento es la fuente de la verdad, y gws lo lee en vivo cada vez.

Integración con OpenClaw: Paso a paso

OpenClaw es un marco de agente de IA autoalojado que se conecta a aplicaciones de mensajería como WhatsApp, Telegram y Discord. Cuando integras gws con OpenClaw, obtienes un asistente de IA que puede administrar todo tu Google Workspace a través de mensajes de texto.

Google literalmente incluyó instrucciones de configuración de OpenClaw en el README. Así es como puedes empezar.

Opción 1: Crear enlaces simbólicos para todas las habilidades (Recomendado para el desarrollo)

# Clonar el repositorio
git clone https://github.com/googleworkspace/cli.git
cd cli

# Crear enlaces simbólicos para todas las habilidades en tu directorio de habilidades de OpenClaw
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Esto mantiene todo sincronizado con el repositorio. Cuando Google actualiza las habilidades, recibes las actualizaciones automáticamente.

Opción 2: Copiar habilidades específicas

# Solo toma lo que necesitas
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

Opción 3: Usar la CLI de habilidades

# Instalar todas las habilidades de una vez
npx skills add https://github.com/googleworkspace/cli

# O elegir habilidades individuales
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

La habilidad gws-shared

La habilidad `gws-shared` es especialmente inteligente. Incluye un bloque de instalación que instala automáticamente la CLI a través de npm si gws no está ya en tu PATH. Tu agente OpenClaw puede autoiniciarse: comprueba si la herramienta existe, la instala si es necesario y comienza a trabajar. No se requiere configuración manual.

Uso de gws a través de WhatsApp

Una vez integrado, puedes enviar mensajes como:

"Check my calendar for today's meetings" (Revisa mi calendario para las reuniones de hoy)
"Find unread emails from my boss" (Encuentra correos no leídos de mi jefe)
"Create a new spreadsheet called Q2 Budget" (Crea una nueva hoja de cálculo llamada Presupuesto del Q2)
"Upload this PDF to the Projects folder" (Sube este PDF a la carpeta de Proyectos)

OpenClaw recibe tu mensaje, determina qué comando gws ejecutar, lo ejecuta y envía los resultados, todo a través de WhatsApp.

Desglose de más de 100 habilidades de agente

El repositorio incluye más de 100 archivos SKILL.md organizados en cuatro categorías. Si no estás familiarizado con el formato SKILL.md, es el estándar emergente para proporcionar a los agentes de IA capacidades estructuradas y componibles. Piensa en las habilidades como aplicaciones, pero para el conocimiento del agente y el acceso a herramientas.

Habilidades de Servicio (más de 25)

Una habilidad por cada API de Google Workspace. Estas son tus bloques de construcción:

Habilidades adicionales cubren Cloud Identity, Alert Center, Group Settings, Licensing, Reseller y Model Armor para filtrado de seguridad.

Habilidades de Persona (10 roles de agente predefinidos)

Google creó 10 paquetes de persona listos para usar que definen roles completos de agente:

Cada persona agrupa las habilidades de servicio correctas, los comandos de ayuda y los patrones de flujo de trabajo para ese rol específico. No tienes que averiguar qué combinación de habilidades de Gmail + Calendar + Drive + Sheets necesita tu agente. Simplemente dale la persona y sabrá qué hacer.

Habilidades de ayuda

Estos son comandos abreviados para las operaciones más comunes:

• `gws-drive-upload` para cargas rápidas de archivos
• `gws-gmail-send` para enviar correos electrónicos
• `gws-modelarmor-sanitize-prompt` para limpiar las indicaciones antes de que lleguen a tu agente

Habilidades de Recetas (50 flujos de trabajo seleccionados)

Secuencias de tareas de varios pasos con comandos reales incorporados. Los ejemplos incluyen:

• Auditar archivos de Drive compartidos externamente
• Enviar correos electrónicos personalizados a partir de datos de Sheets
• Crear agendas de reuniones a partir de eventos de Calendar
• Generar informes de estado semanales a partir de múltiples fuentes

Estos son los flujos de trabajo de "copiar y pegar" que ahorran horas de ingeniería de prompts.

Flujos de trabajo de automatización del mundo real

Aquí tienes ejemplos concretos de lo que puedes automatizar con gws y OpenClaw.

Automatización de Gmail

# Busca en tu bandeja de entrada correos no leídos de un remitente específico
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# Lee un correo electrónico específico
gws gmail users.messages get --params '{"userId": "me", "id": "ID_DEL_MSG"}'

# Envía un correo electrónico (el asistente maneja toda la codificación)
gws gmail +send --to alice@company.com --subject 'Informe Q2 Listo' \
  --body 'Hola Alice, el informe del Q2 está listo para revisión.'

# Triar tu bandeja de entrada no leída (resumen amigable para el agente)
gws gmail +triage --max 5 --query 'from:boss'

Gestión de Calendario

# Mira lo que hay en tu calendario hoy
gws calendar +agenda

# Crea una reunión con asistentes
gws calendar +insert --summary 'Reunión semanal' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# Crea un evento recurrente con todos los detalles
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Reunión semanal",
    "start": {"dateTime": "2026-03-10T09:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T09:30:00", "timeZone": "America/Vancouver"},
    "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO"],
    "attendees": [{"email": "team@company.com"}]
  }'

# Reprograma un evento y notifica a los asistentes
gws calendar events patch \
  --params '{"calendarId": "primary", "eventId": "ID_DEL_EVENTO", "sendUpdates": "all"}' \
  --json '{
    "start": {"dateTime": "2026-03-10T14:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T15:00:00", "timeZone": "America/Vancouver"}
  }'

Gestión de Archivos de Drive

# Lista tus 10 archivos más recientes
gws drive files list --params '{"pageSize": 10}'

# Sube un archivo a una carpeta específica
gws drive +upload --file ./informe.pdf --parent ID_DE_CARPETA

# Crea una nueva carpeta de proyecto
gws drive files create \
  --json '{"name": "Proyecto Q2", "mimeType": "application/vnd.google-apps.folder"}'

# Descarga un archivo
gws drive files get \
  --params '{"fileId": "ID_DE_ARCHIVO", "alt": "media"}' -o informe.pdf

# Exporta un Google Doc como PDF
gws drive files export \
  --params '{"fileId": "ID_DE_ARCHIVO", "mimeType": "application/pdf"}' -o documento.pdf

# Comparte una carpeta con un colega
gws drive permissions create \
  --params '{"fileId": "ID_DE_CARPETA"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colega@empresa.com"}'

Operaciones de Hojas de Cálculo

# Leer datos de un rango específico
gws sheets +read --spreadsheet-id ID_DE_HOJA --range 'Contactos!A2:C'

# Añadir una nueva fila de datos
gws sheets +append --spreadsheet-id ID_DE_HOJA --range 'Hoja1' \
  --values '["2026-03-05", "Marketing", "Gasto en publicidad", "1500"]'

# Crear una hoja de cálculo nueva
gws drive files create \
  --json '{"name": "Seguimiento de Gastos 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

Creación de Docs y Contenido

# Crear un nuevo documento
gws docs documents create --json '{"title": "Notas de Reunión - Marzo 2026"}'

# Escribir contenido en un documento existente
gws docs +write --document-id ID_DE_DOCUMENTO \
  --text '## Proyecto: Lanzamiento Q2\n\n### Objetivo\nLanzar la nueva característica a finales del Q2.'

Chat, Meet, Formularios y más

# Enviar una notificación al equipo en Google Chat
gws chat +send --space spaces/ESPACIO_DE_EQUIPO \
  --text 'Importante: Por favor, revisa tu correo electrónico para ver la política actualizada.'

# Crear una sala de Google Meet
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# Crear un formulario de comentarios
gws forms forms create \
  --json '{"info": {"title": "Comentarios del Evento", "documentTitle": "Formulario de Comentarios del Evento"}}'

# Crear una presentación
gws slides presentations create --json '{"title": "Revisión Trimestral Q2"}'

Observa el patrón. Cada acción es una línea. Los comandos de ayuda con `+` (como +send, +upload, +agenda, +triage, +read, +append, +write) manejan toda la codificación y el formato complicados que normalmente tomarían 10 líneas de código repetitivo. Tu agente no necesita saber sobre el formato de correo electrónico RFC 2822 o la codificación base64. Simplemente dice lo que quiere hacer y gws se encarga del resto.

Seguridad y Model Armor

Aquí hay algo a lo que no se le presta suficiente atención. El repositorio incluye la integración con Google Cloud Model Armor para la sanitización de respuestas.

¿Qué es Model Armor?

Cuando tu agente lee datos de Gmail o Drive, esos datos podrían contener ataques de inyección de prompts. Alguien podría crear un correo electrónico diseñado específicamente para manipular el comportamiento de tu agente. Model Armor escanea las respuestas de la API antes de que lleguen a tu agente y filtra el contenido potencialmente malicioso.

gws gmail users messages get --params '...' \
  --sanitize "projects/P/locations/L/templates/T"

Modos de sanitización

Por qué esto importa

El equipo de seguridad de IA de Cisco descubrió que el 26% de las más de 31,000 habilidades en ClawHub contienen vulnerabilidades. SecurityScorecard informó que el 63% de las instancias expuestas de OpenClaw están mal configuradas. La seguridad de los agentes no es un problema teórico. Está sucediendo ahora mismo.

Tener un filtrado de seguridad integrado en el pipeline de datos es una jugada inteligente por parte de Google.

Variables de entorno para seguridad

# Plantilla predeterminada de Model Armor
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# Modo de sanitización (warn o block)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws vs Alternativas

Compareamos gws con otros enfoques que podrías considerar.

gws vs gcloud CLI

Usa gcloud para la gestión de infraestructura. Usa gws para la automatización de Workspace.

gws vs Google Apps Script

Apps Script destaca en la automatización de flujos de trabajo dentro de Google Workspace. gws destaca en dar acceso a herramientas externas y agentes de IA a Workspace.

gws vs Herramientas de terceros (Zapier, Make)

Las herramientas de terceros tienen sentido para usuarios no técnicos. gws tiene sentido para desarrolladores y configuraciones de agentes de IA.

Guía de inicio

¿Listo para probar esto? Aquí tienes la ruta más rápida para una configuración funcional.

Requisitos previos

• Node.js 18+ (para `npm install`)
• Un proyecto de Google Cloud (para credenciales de OAuth)
• Una cuenta de Google con acceso a Google Workspace
• gcloud CLI instalado (opcional pero recomendado para una configuración más rápida)

Paso 1: Instalar gws

npm install -g @googleworkspace/cli

El paquete npm incluye binarios nativos precompilados para tu sistema operativo y arquitectura. No se requiere una cadena de herramientas de Rust.

Paso 2: Configurar la autenticación

gws auth setup

Esto te guiará a través de la configuración del proyecto de Google Cloud. Crea un proyecto en la nube, habilita las API e inicia sesión.

Si no tienes gcloud instalado, puedes configurar OAuth manualmente a través de la Consola de Google Cloud.

Paso 3: Iniciar sesión

gws auth login

Esto abre un navegador para la selección de alcance de OAuth y el inicio de sesión.

Paso 4: Prueba tu configuración

gws drive files list --params '{"pageSize": 5}'

Deberías ver una respuesta JSON con tus archivos recientes.

Paso 5: Integrar con OpenClaw

# Clonar el repositorio
git clone https://github.com/googleworkspace/cli.git
cd cli

# Crear enlaces simbólicos para todas las habilidades
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Paso 6: Empezar a usar a través de mensajería

Envía un mensaje a través de tu plataforma de mensajería OpenClaw configurada:

"Listar mis 5 archivos más recientes de Drive"

OpenClaw ejecutará el comando gws apropiado y enviará los resultados.

Resolución de problemas comunes

"Acceso bloqueado" o 403 durante el inicio de sesión

Tu aplicación OAuth está en modo de prueba y tu cuenta no aparece como usuario de prueba.

Solución: Abre la pantalla de consentimiento de OAuth en tu proyecto de GCP, ve a Usuarios de prueba, agrega el correo electrónico de tu cuenta de Google y luego vuelve a intentar gws auth login.

"Google no ha verificado esta aplicación"

Esperado cuando tu aplicación está en modo de prueba. Haz clic en Avanzado, luego en "Ir a (no seguro)" para continuar. Esto es seguro para uso personal.

Error de demasiados alcances

Las aplicaciones no verificadas (en modo de prueba) están limitadas a aproximadamente 25 alcances de OAuth. El preset de alcances recomendado incluye muchos alcances y excederá este límite.

Solución: Selecciona solo los alcances que necesitas:

gws auth login --scopes drive,gmail,calendar

API no habilitada

Si una API de Google requerida no está habilitada para tu proyecto de GCP, verás un error 403 con la razón `accessNotConfigured`.

gws imprime una sugerencia útil con un enlace para habilitar la API. Haz clic en el enlace, habilítala, espera unos 10 segundos y vuelve a intentarlo.

Conclusión

Google Workspace CLI representa algo significativo para el ecosistema de agentes de IA. No es solo otro wrapper CLI. Es una infraestructura que hace que la automatización de IA sea accesible para cualquiera con npm instalado.

La arquitectura es sólida. La cobertura de habilidades es impresionante. El hecho de que Google haya incorporado la compatibilidad con OpenClaw desde el primer día te indica hacia dónde creen que se dirige el ecosistema de agentes.

Para los desarrolladores que construyen sobre OpenClaw, Claude Code o cualquier plataforma de agentes, gws es una de esas herramientas que querrás tener en tu caja de herramientas. Maneja la complejidad de las APIs de Google Workspace para que tu agente pueda centrarse en lo que importa: hacer el trabajo.

La economía de agentes está obteniendo su infraestructura. Y está sucediendo más rápido de lo que la mayoría de la gente se da cuenta.

Preguntas Frecuentes

P: ¿Es gws de uso gratuito?

R: Sí, gws es de código abierto bajo la licencia Apache-2.0. Solo pagas por el uso de la API de Google si excedes las cuotas gratuitas.

P: ¿Necesito una cuenta de Google Workspace?

R: Una cuenta estándar de Google funciona para la mayoría de las funciones. Algunas API de administración requieren una suscripción a Workspace.

P: ¿Puedo usar gws sin OpenClaw?

R: Absolutamente. gws funciona como una herramienta CLI independiente. La integración de OpenClaw es opcional para el acceso basado en mensajería.

P: ¿Cómo actualizo gws?

R: Ejecuta npm update -g @googleworkspace/cli para obtener la última versión. La CLI lee el Servicio de Descubrimiento de Google en tiempo de ejecución, por lo que siempre tiene acceso a las API más recientes.

P: ¿Están mis datos seguros con gws?

R: gws almacena las credenciales cifradas en reposo usando AES-256-GCM con claves en el llavero de tu sistema operativo. La integración de Model Armor proporciona seguridad adicional para los flujos de trabajo de los agentes.

P: ¿Puedo usar gws en pipelines de CI/CD?

R: Sí. Exporta tus credenciales con gws auth export --unmasked > credentials.json y establece GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE en tu entorno CI.

P: ¿Cuál es la diferencia entre gws y el Explorador de APIs de Google?

R: gws es una herramienta CLI diseñada para la automatización y la integración de agentes de IA. El Explorador de APIs es una herramienta de prueba basada en la web. gws genera JSON estructurado y admite scripting.

P: ¿Funciona gws con cuentas de servicio?

R: Sí. Establece `GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE` en tu archivo de clave JSON de cuenta de servicio. No se requiere inicio de sesión interactivo.

P: ¿Puedo contribuir a gws?

R: Sí, el proyecto es de código abierto en GitHub. Tenga en cuenta que las solicitudes de extracción de no colaboradores están temporalmente deshabilitadas según los mantenedores del repositorio.

P: ¿Qué plataformas soporta gws?

R: gws distribuye binarios precompilados para macOS, Linux y Windows. El paquete npm maneja la instalación de binarios nativos automáticamente.