Connecter Google Workspace CLI à OpenClaw

En bref

Google Workspace CLI (gws) est un outil en ligne de commande qui donne aux agents IA un accès direct à Gmail, Drive, Agenda, Sheets, Docs et à toutes les API Google Workspace via une sortie JSON structurée. Grâce au support natif d'OpenClaw et à plus de 100 compétences d'agent pré-intégrées, vous pouvez automatiser l'ensemble de votre flux de travail Workspace via des applications de messagerie comme WhatsApp ou Discord. La configuration prend 5 minutes avec npm install -g @googleworkspace/cli suivi de gws auth setup.

Introduction

Et si votre agent IA pouvait lire votre Gmail, mettre à jour votre Agenda et organiser votre Google Drive sans que vous ayez à lever le petit doigt ?

La plupart des outils d'automatisation Google Workspace nécessitent des configurations API complexes, du code personnalisé ou des services tiers coûteux. Les développeurs passent des heures à se débattre avec les flux OAuth, les limites de débit et une documentation obsolète. Pendant ce temps, les agents IA restent inactifs parce qu'ils n'ont pas d'accès direct aux outils que nous utilisons tous les jours.

Les ingénieurs de Google viennent de publier quelque chose qui change tout. Le Google Workspace CLI (gws) a déjà accumulé plus de 12 400 étoiles sur GitHub et est livré avec plus de 100 compétences d'agent pré-intégrées. Il est construit en Rust, lit le service de découverte de Google à l'exécution et produit une sortie JSON structurée que tout agent IA peut analyser.

Qu'est-ce que Google Workspace CLI ?

Google Workspace CLI (gws) est un outil en ligne de commande unique qui encapsule toutes les API Google Workspace en commandes claires et composables. Il couvre Gmail, Google Drive, Agenda, Sheets, Docs, Slides, Chat, Tasks, Meet, Forms, Keep, Classroom, Admin, et pratiquement toutes les API Google Workspace existantes.

Voici ce qui le distingue des autres outils CLI que vous avez utilisés.

La plupart des outils de développement sont livrés avec une liste fixe de commandes. Lorsque Google ajoute un nouveau point de terminaison API, quelqu'un doit mettre à jour manuellement l'outil, publier une nouvelle version et espérer que tout le monde mette à niveau. C'est un cycle d'entretien sans fin. La plupart des wrappers Google Workspace que vous avez vus sont déjà obsolètes au moment où vous les installez.

gws résout ce problème d'une manière fondamentalement différente. Au lieu de coder en dur les commandes, il communique directement avec le service de découverte de Google. Considérez cela comme le catalogue en direct de Google de chaque action disponible sur toutes ses applications Workspace. Chaque API, chaque méthode, chaque paramètre. Google maintient ce catalogue lui-même, et il est toujours à jour.

Lorsque vous exécutez gws, la première chose qu'il fait est de récupérer ce catalogue en direct et de construire l'intégralité de sa structure de commandes à la volée à partir de ce que Google indique être disponible à ce moment précis. Si Google livre une nouvelle fonctionnalité Sheets à 14h aujourd'hui, votre CLI la prendra déjà en charge à 14h01. Pas de mise à jour. Pas de nouvelle version. Pas d'attente qu'un mainteneur se mette à jour.

L'outil ne peut littéralement pas prendre de retard car il lit la source de vérité à chaque fois.

Exemple rapide

# List the 10 most recent files
gws drive files list --params '{"pageSize": 10}'

# Create a spreadsheet
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

# Send a Chat message
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Deploy complete."}'

Chaque réponse est renvoyée sous forme de JSON structuré. Pas de HTML. Pas de texte formaté. Des données propres, prévisibles et lisibles par machine qu'un agent IA peut immédiatement analyser et sur lesquelles il peut agir.

Pourquoi gws est important pour les agents IA

La communauté des agents IA est enthousiasmée par gws pour des raisons techniques spécifiques.

Sortie JSON structurée : Chaque réponse est renvoyée sous forme de JSON structuré. Votre agent n'a pas besoin d'analyser le HTML ou de deviner le formatage. Il obtient des données propres avec lesquelles il peut travailler immédiatement.

Aucun outil personnalisé requis : La plupart des configurations d'agents IA vous obligent à créer des outils personnalisés pour chaque API à laquelle vous souhaitez accéder. Avec gws, l'outillage est déjà intégré. Votre agent a juste besoin de savoir comment exécuter des commandes shell.

Plus de 100 compétences d'agent pré-intégrées : Le dépôt est livré avec plus de 100 fichiers SKILL.md – un pour chaque API prise en charge, plus des aides de haut niveau pour les flux de travail courants et 50 recettes sélectionnées pour Gmail, Drive, Docs, Agenda et Sheets.

Prise en charge native d'OpenClaw : Google a inclus des instructions de configuration d'OpenClaw directement dans le README. Ce n'est pas un hack ou une solution de contournement communautaire. C'est un support intégré de première classe.

Serveur MCP intégré : gws inclut un serveur Model Context Protocol qui expose les API Google Workspace en tant qu'outils structurés. Tout client compatible MCP (Claude Desktop, Gemini CLI, VS Code) peut appeler ces outils directement.

L'infrastructure de l'économie des agents

Nous assistons à l'émergence d'une infrastructure d'agents plus rapidement que la plupart des gens ne le réalisent. Des outils comme gws représentent la tuyauterie qui alimentera les flux de travail autonomes. Au lieu de créer des intégrations personnalisées pour chaque plateforme SaaS, les agents peuvent s'appuyer sur des CLI standardisées avec des formats de sortie cohérents.

C'est important car cela abaisse la barrière à l'entrée. Vous n'avez pas besoin d'une équipe d'ingénieurs pour créer une automatisation IA pour votre Workspace. Vous avez besoin de npm et de 5 minutes.

Comment fonctionne gws : l'architecture

gws utilise une stratégie d'analyse en deux phases qui mérite d'être comprise.

Phase 1 : Identification du service

Lorsque vous exécutez gws drive files list, la CLI lit le premier argument (drive) pour identifier le service.

Phase 2 : Construction dynamique des commandes

La CLI récupère le document de découverte du service auprès de Google (mis en cache pendant 24 heures). Elle construit un arbre clap::Command à partir des ressources et des méthodes du document. C'est là que la magie opère – toute la surface de commande est générée à partir de la spécification API propre à Google.

Phase 3 : Exécution de la requête

La CLI ré-analyse les arguments restants, s'authentifie à l'aide de vos identifiants configurés, construit la requête HTTP et l'exécute.

Toutes les sorties – réponses de succès, erreurs, métadonnées de téléchargement – sont des JSON structurés.

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  Récupérer le document de découverte (mis en cache 24h) │
│       ↓                                                 │
│  Construire l'arbre clap::Command à partir des ressources et méthodes │
│       ↓                                                 │
│  Ré-analyser les arguments restants                      │
│       ↓                                                 │
│  Authentifier → Construire la requête HTTP → Exécuter   │
│       ↓                                                 │
│  Sortie : JSON structuré                                │
└─────────────────────────────────────────────────────────┘

Cette architecture signifie que gws peut prendre en charge toutes les API Google Workspace sans coder en dur une seule commande. Le document de découverte est la source de vérité, et gws le lit en direct à chaque fois.

Intégration OpenClaw : étape par étape

OpenClaw est un framework d'agents IA auto-hébergé qui se connecte à des applications de messagerie comme WhatsApp, Telegram et Discord. Lorsque vous intégrez gws à OpenClaw, vous obtenez un assistant IA qui peut gérer l'ensemble de votre Google Workspace via des messages texte.

Google a littéralement inclus les instructions de configuration d'OpenClaw dans le README. Voici comment commencer.

Option 1 : Créer des liens symboliques pour toutes les compétences (recommandé pour le développement)

# Clone the repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# Symlink all skills into your OpenClaw skills directory
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Cela maintient tout synchronisé avec le dépôt. Lorsque Google met à jour les compétences, vous obtenez les mises à jour automatiquement.

Option 2 : Copier des compétences spécifiques

# Only grab what you need
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

Option 3 : Utiliser la CLI des compétences

# Install all skills at once
npx skills add https://github.com/googleworkspace/cli

# Or pick individual skills
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 compétence gws-shared

La compétence gws-shared est particulièrement intelligente. Elle inclut un bloc d'installation qui installe automatiquement la CLI via npm si gws n'est pas déjà dans votre PATH. Votre agent OpenClaw peut s'amorcer lui-même – il vérifie l'outil, l'installe si nécessaire et commence à fonctionner. Aucune configuration manuelle requise.

Utiliser gws via WhatsApp

Une fois intégré, vous pouvez envoyer des messages comme :

"Vérifier mon agenda pour les réunions d'aujourd'hui"
"Trouver les e-mails non lus de mon patron"
"Créer une nouvelle feuille de calcul appelée Budget T2"
"Télécharger ce PDF dans le dossier Projets"

OpenClaw reçoit votre message, détermine quelle commande gws exécuter, l'exécute et renvoie les résultats – le tout via WhatsApp.

Répartition des plus de 100 compétences d'agent

Le dépôt est livré avec plus de 100 fichiers SKILL.md organisés en quatre catégories. Si vous n'êtes pas familier avec le format SKILL.md, c'est la norme émergente pour donner aux agents IA des capacités structurées et composables. Considérez les compétences comme des applications, mais pour les connaissances et l'accès aux outils des agents.

Compétences de service (25+)

Une compétence par API Google Workspace. Ce sont vos éléments de base :

Des compétences supplémentaires couvrent Cloud Identity, Alert Center, Group Settings, Licensing, Reseller et Model Armor pour le filtrage de sécurité.

Compétences de Persona (10 rôles d'agent pré-établis)

Google a créé 10 ensembles de persona prêts à l'emploi qui définissent des rôles d'agent complets :

Chaque persona regroupe les bonnes compétences de service, les commandes d'aide et les modèles de flux de travail pour ce rôle spécifique. Vous n'avez pas à déterminer quelle combinaison de compétences Gmail + Agenda + Drive + Sheets votre agent a besoin. Donnez-lui simplement le persona et il saura quoi faire.

Compétences d'aide

Ce sont des commandes raccourcies pour les opérations les plus courantes :

• gws-drive-upload pour des téléchargements rapides de fichiers
• gws-gmail-send pour envoyer des e-mails
• gws-modelarmor-sanitize-prompt pour nettoyer les invites avant qu'elles n'atteignent votre agent

Compétences de recette (50 flux de travail organisés)

Séquences de tâches en plusieurs étapes avec des commandes réelles intégrées. Les exemples incluent :

• Auditer les fichiers Drive partagés en externe
• Envoyer des e-mails personnalisés à partir de données Sheets
• Créer des ordres du jour de réunion à partir d'événements d'agenda
• Générer des rapports d'état hebdomadaires à partir de plusieurs sources

Ce sont les flux de travail « copier-coller et exécuter » qui économisent des heures d'ingénierie d'invite.

Flux de travail d'automatisation concrets

Voici des exemples concrets de ce que vous pouvez automatiser avec gws et OpenClaw.

Automatisation de Gmail

# Search your inbox for unread emails from a specific sender
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# Read a specific email
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'

# Send an email (the helper handles all the encoding)
gws gmail +send --to alice@company.com --subject 'Q2 Report Ready' \
  --body 'Hey Alice, the Q2 report is ready for review.'

# Triage your unread inbox (agent-friendly summary)
gws gmail +triage --max 5 --query 'from:boss'

Gestion du calendrier

# See what's on your calendar today
gws calendar +agenda

# Create a meeting with attendees
gws calendar +insert --summary 'Weekly Standup' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# Create a recurring event with all the details
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Weekly Standup",
    "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"}]
  }'

# Reschedule an event and notify attendees
gws calendar events patch \
  --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}' \
  --json '{
    "start": {"dateTime": "2026-03-10T14:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T15:00:00", "timeZone": "America/Vancouver"}
  }'

Gestion des fichiers Drive

# List your 10 most recent files
gws drive files list --params '{"pageSize": 10}'

# Upload a file to a specific folder
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# Create a new project folder
gws drive files create \
  --json '{"name": "Q2 Project", "mimeType": "application/vnd.google-apps.folder"}'

# Download a file
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# Export a Google Doc as PDF
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# Share a folder with a colleague
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

Opérations sur les feuilles de calcul

# Read data from a specific range
gws sheets +read --spreadsheet-id SHEET_ID --range 'Contacts!A2:C'

# Append a new row of data
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sheet1' \
  --values '["2026-03-05", "Marketing", "Ad spend", "1500"]'

# Create a brand new spreadsheet
gws drive files create \
  --json '{"name": "Expense Tracker 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

Création de Docs et de contenu

# Create a new document
gws docs documents create --json '{"title": "Meeting Notes - March 2026"}'

# Write content to an existing doc
gws docs +write --document-id DOC_ID \
  --text '## Project: Q2 Launch\n\n### Objective\nLaunch the new feature by end of Q2.'

Chat, Meet, Forms, et plus encore

# Send a team notification in Google Chat
gws chat +send --space spaces/TEAM_SPACE \
  --text 'Important: Please check your email for the updated policy.'

# Create a Google Meet room
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# Create a feedback form
gws forms forms create \
  --json '{"info": {"title": "Event Feedback", "documentTitle": "Event Feedback Form"}}'

# Create a presentation
gws slides presentations create --json '{"title": "Quarterly Review Q2"}'

Remarquez le motif. Chaque action est sur une seule ligne. Les commandes d'aide + (comme +send, +upload, +agenda, +triage, +read, +append, +write) gèrent tout l'encodage et le formatage complexes qui prendraient normalement 10 lignes de code répétitif. Votre agent n'a pas besoin de connaître le formatage d'e-mail RFC 2822 ou l'encodage base64. Il dit simplement ce qu'il veut faire et gws s'occupe du reste.

Sécurité et Model Armor

Voici quelque chose qui ne reçoit pas assez d'attention. Le dépôt inclut l'intégration avec Google Cloud Model Armor pour l'assainissement des réponses.

Qu'est-ce que Model Armor ?

Lorsque votre agent lit des données de Gmail ou Drive, ces données peuvent contenir des attaques par injection d'invite. Quelqu'un pourrait concevoir un e-mail spécifiquement pour manipuler le comportement de votre agent. Model Armor scanne les réponses de l'API avant qu'elles n'atteignent votre agent et filtre le contenu potentiellement malveillant.

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

Modes de désinfection

Pourquoi c'est important

L'équipe de sécurité IA de Cisco a constaté que 26 % des plus de 31 000 compétences sur ClawHub contiennent des vulnérabilités. SecurityScorecard a rapporté que 63 % des instances OpenClaw exposées sont mal configurées. La sécurité des agents n'est pas un problème théorique. Cela se produit en ce moment même.

Avoir un filtrage de sécurité intégré au pipeline de données est une décision intelligente de la part de Google.

Variables d'environnement pour la sécurité

# Default Model Armor template
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# Sanitization mode (warn or block)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws vs Alternatives

Comparons gws à d'autres approches que vous pourriez envisager.

gws vs gcloud CLI

Utilisez gcloud pour la gestion de l'infrastructure. Utilisez gws pour l'automatisation de Workspace.

gws vs Google Apps Script

Apps Script excelle dans l'automatisation des flux de travail au sein de Google Workspace. gws excelle dans l'accès aux outils externes et aux agents IA à Workspace.

gws vs Outils tiers (Zapier, Make)

Les outils tiers ont du sens pour les utilisateurs non techniques. gws a du sens pour les développeurs et les configurations d'agents IA.

Guide de démarrage rapide

Prêt à essayer cela ? Voici le chemin le plus rapide vers une configuration fonctionnelle.

Prérequis

• Node.js 18+ (pour l'installation npm)
• Un projet Google Cloud (pour les identifiants OAuth)
• Un compte Google avec accès à Google Workspace
• gcloud CLI installé (facultatif mais recommandé pour une configuration plus rapide)

Étape 1 : Installer gws

npm install -g @googleworkspace/cli

Le package npm regroupe des binaires natifs pré-construits pour votre OS et votre architecture. Aucune chaîne d'outils Rust n'est requise.

Étape 2 : Configurer l'authentification

gws auth setup

Cela vous guide à travers la configuration du projet Google Cloud. Cela crée un projet Cloud, active les API et vous connecte.

Si vous n'avez pas gcloud installé, vous pouvez configurer OAuth manuellement via la Google Cloud Console.

Étape 3 : Connexion

gws auth login

Cela ouvre un navigateur pour la sélection des portées OAuth et la connexion.

Étape 4 : Tester votre configuration

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

Vous devriez voir une réponse JSON avec vos fichiers récents.

Étape 5 : Intégrer avec OpenClaw

# Clone the repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# Symlink all skills
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Étape 6 : Commencer à utiliser via la messagerie

Envoyez un message via votre plateforme de messagerie OpenClaw configurée :

"Lister mes 5 fichiers Drive les plus récents"

OpenClaw exécutera la commande gws appropriée et renverra les résultats.

Dépannage des problèmes courants

« Accès bloqué » ou 403 lors de la connexion

Votre application OAuth est en mode test et votre compte n'est pas répertorié comme utilisateur de test.

Correction : Ouvrez l'écran de consentement OAuth dans votre projet GCP, accédez à Utilisateurs de test, ajoutez l'e-mail de votre compte Google, puis réessayez gws auth login.

« Google n'a pas vérifié cette application »

Prévu lorsque votre application est en mode test. Cliquez sur Avancé, puis sur « Accéder à (non sécurisé) » pour continuer. Ceci est sûr pour une utilisation personnelle.

Erreur : trop de portées (scopes)

Les applications non vérifiées (en mode test) sont limitées à environ 25 portées OAuth. Le préréglage de portées recommandé inclut de nombreuses portées et dépassera cette limite.

Correction : Sélectionnez uniquement les portées dont vous avez besoin :

gws auth login --scopes drive,gmail,calendar

API non activée

Si une API Google requise n'est pas activée pour votre projet GCP, vous verrez une erreur 403 avec la raison accessNotConfigured.

gws affiche un indice exploitable avec un lien pour activer l'API. Cliquez sur le lien, activez-le, attendez environ 10 secondes, puis réessayez.

Conclusion

Google Workspace CLI représente quelque chose de significatif pour l'écosystème des agents IA. Ce n'est pas juste un autre wrapper CLI. C'est une infrastructure qui rend l'automatisation IA accessible à toute personne ayant npm installé.

L'architecture est solide. La couverture des compétences est impressionnante. Le fait que Google ait intégré la compatibilité OpenClaw dès le premier jour vous indique la direction que, selon eux, l'écosystème des agents prend.

Pour les développeurs qui créent sur OpenClaw, Claude Code ou toute autre plateforme d'agents, gws est l'un de ces outils que vous voudrez avoir dans votre boîte à outils. Il gère la complexité des API Google Workspace afin que votre agent puisse se concentrer sur l'essentiel : accomplir le travail.

L'économie des agents est en train de se doter de son infrastructure. Et cela se passe plus vite que la plupart des gens ne le réalisent.

FAQ

Q : gws est-il gratuit ?

R : Oui, gws est open source sous licence Apache-2.0. Vous ne payez l'utilisation de l'API Google que si vous dépassez les quotas gratuits.

Q : Ai-je besoin d'un compte Google Workspace ?

R : Un compte Google standard fonctionne pour la plupart des fonctionnalités. Certaines API d'administration nécessitent un abonnement Workspace.

Q : Puis-je utiliser gws sans OpenClaw ?

R : Absolument. gws fonctionne comme un outil CLI autonome. L'intégration OpenClaw est facultative pour un accès basé sur la messagerie.

Q : Comment mettre à jour gws ?

R : Exécutez npm update -g @googleworkspace/cli pour obtenir la dernière version. La CLI lit le service de découverte de Google à l'exécution, elle a donc toujours accès aux dernières API.

Q : Mes données sont-elles sécurisées avec gws ?

R : gws stocke les identifiants chiffrés au repos à l'aide d'AES-256-GCM avec des clés dans le trousseau de votre système d'exploitation. L'intégration de Model Armor offre une sécurité supplémentaire pour les flux de travail des agents.

Q : Puis-je utiliser gws dans les pipelines CI/CD ?

R : Oui. Exportez vos identifiants avec gws auth export --unmasked > credentials.json et définissez GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE dans votre environnement CI.

Q : Quelle est la différence entre gws et l'explorateur d'API Google ?

R : gws est un outil CLI conçu pour l'automatisation et l'intégration d'agents IA. L'explorateur d'API est un outil de test basé sur le Web. gws produit du JSON structuré et prend en charge les scripts.

Q : gws fonctionne-t-il avec les comptes de service ?

R : Oui. Définissez GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE sur le fichier de clé JSON de votre compte de service. Aucune connexion interactive n'est requise.

Q : Puis-je contribuer à gws ?

R : Oui, le projet est open source sur GitHub. Notez que les pull requests des non-collaborateurs sont temporairement désactivées selon les mainteneurs du dépôt.

Q : Quelles plateformes gws prend-il en charge ?

R : gws fournit des binaires pré-construits pour macOS, Linux et Windows. Le package npm gère automatiquement l'installation des binaires natifs.