Gmail et OpenClaw : connecter une boîte mail
Connectez Gmail à OpenClaw avec le parcours Pub/Sub officiel, distinguez webhook, outil et skill, puis sécurisez le traitement des emails.
Introduction
Un Gmail skill OpenClaw est utile pour documenter le triage d'emails, mais l'intégration officiellement vérifiée concerne la réception d'événements Gmail par Pub/Sub avec openclaw webhooks gmail. Utilisez ce parcours pour réagir à un message entrant. Pour un simple digest sortant ou une règle de transfert fixe, une automatisation plus simple est souvent préférable.
Le webhook surveille une boîte et livre les notifications au Gateway. Il ne fournit pas à lui seul une API générale d'envoi, de classement ou de suppression. Ces actions demandent un outil externe borné — script, service ou plugin TypeScript audité. Ce tutoriel sépare le webhook, les instructions du skill et les effets de bord afin d'obtenir un traitement testable sans SDK Python inventé.
Résumé rapide
- Installez et configurez OpenClaw avec son Gateway actif.
- Lancez
openclaw webhooks gmail setup --account <email>. - Le parcours configure le watch Gmail, Pub/Sub et la livraison vers le hook OpenClaw ; il peut installer
gcloudetgogs'ils manquent. - Démarrez le watcher avec
openclaw webhooks gmail run. - Testez avec un compte et un label dédiés avant d'ouvrir toute la boîte.
- Pour l'envoi ou la modification d'emails, utilisez une voie générique distincte et imposez une approbation humaine.
Aucun pip install openclaw, credentials.json Python ou import OpenClawAgent n'est requis par ce parcours officiel.
Distinguer webhook, skill, outil et canal
| Élément | Fonction |
|---|---|
| Webhook Gmail | Convertit une notification Pub/Sub en événement livré au Gateway. |
gog watcher | Maintient la surveillance Gmail et son renouvellement. |
| Skill | Fichier SKILL.md qui décrit comment trier, résumer ou escalader un message. |
| Outil | Capacité exécutable appelée par l'agent, par exemple écrire un fichier ou appeler un service autorisé. |
| Script externe | Programme indépendant qui peut envoyer un email ou appliquer un label ; OpenClaw ne le transforme pas automatiquement en skill. |
| Canal | Surface de conversation bidirectionnelle telle que Slack ou Telegram. La réception Gmail par webhook n'est pas présentée comme un canal de chat complet. |
| Plugin | Extension OpenClaw écrite pour son système de plugins, actuellement orienté Node/TypeScript. |
Le webhook informe l'agent qu'un message est arrivé. Le skill peut lui dire de ne lire que le sujet et l'expéditeur, puis de produire une proposition d'action. L'action elle-même dépend des outils réellement disponibles. Ne laissez pas un texte d'email décider seul d'une opération sensible : les boîtes de réception sont une source de contenu non fiable et donc un vecteur d'injection de prompt.
Configurer la réception Gmail officielle
Vérifier le Gateway
Commencez par contrôler l'installation actuelle :
openclaw gateway status
Le Gateway doit rester actif pour recevoir et traiter les événements. La configuration principale se trouve dans ~/.openclaw/openclaw.json, pas dans un fichier YAML inventé.
Lancer l'assistant Gmail
Utilisez la commande documentée avec le compte à surveiller :
openclaw webhooks gmail setup --account vous@exemple.fr
Le parcours prend en charge la préparation du projet, du topic et de la souscription Pub/Sub, démarre le watch Gmail et écrit la configuration hooks.gmail avec les hooks activés. Il affiche ensuite la commande à lancer pour garder le watcher actif. Si vous exploitez déjà un projet Google Cloud précis, ajoutez son identifiant :
openclaw webhooks gmail setup \
--account vous@exemple.fr \
--project mon-projet-gcp
Le label surveillé est INBOX par défaut. Pour réduire le périmètre, choisissez un label dédié pendant la configuration. Le mode JSON permet d'obtenir un résumé exploitable par votre supervision :
openclaw webhooks gmail setup \
--account vous@exemple.fr \
--label OPENCLAW \
--json
Démarrer le watcher
Une fois la configuration terminée :
openclaw webhooks gmail run --account vous@exemple.fr
Cette commande exécute le service de watch gog et renouvelle la surveillance. Pour un usage durable, supervisez ce processus comme le Gateway ; ne supposez pas qu'un terminal fermé continuera à recevoir les événements.
Validez le transport avant le raisonnement. Envoyez un message de test portant le label surveillé, observez l'événement dans les journaux, puis confirmez que le hook déclenche la route attendue. Répétez avec un message hors label : il ne doit pas entrer dans le workflow. Enfin, arrêtez le watcher et vérifiez que l'absence d'événement est détectable par votre monitoring. Ces contrôles prouvent le périmètre, le filtre et la supervision.
Documentez les dépendances installées par l'assistant et le projet Google Cloud utilisé. La rotation d'un credential, un changement de projet ou une expiration du watch peuvent interrompre le flux sans modifier votre skill. Prévoyez donc un contrôle de fraîcheur du dernier événement et une alerte distincte du contenu métier.
Concevoir le traitement des messages
Commencez par une politique à faible risque. Par exemple :
- accepter uniquement les messages portant le label
OPENCLAW; - extraire l'expéditeur, le sujet et un extrait borné ;
- classer le message dans une taxonomie courte ;
- enregistrer une proposition de réponse sans l'envoyer ;
- demander une validation humaine pour tout destinataire externe ou toute pièce jointe.
Le setup Gmail inclut par défaut des extraits de corps bornés. Si votre cas d'usage n'en a pas besoin, désactivez cette inclusion dans la configuration hooks.gmail plutôt que de transmettre inutilement des données au modèle. Les contenus RH, juridiques, financiers ou médicaux devraient rester hors du périmètre initial.
Un skill Markdown peut documenter la procédure :
~/.openclaw/workspace/skills/triage-email/SKILL.md
Son rôle est de décrire les catégories, seuils d'escalade, formats de brouillon et interdictions. Il n'a pas à contenir de code OAuth ni de secrets. Pour comprendre cette structure, consultez les exemples de skills OpenClaw.
Et pour envoyer ou modifier un email ?
La documentation OpenClaw vérifiée ne présente pas openclaw webhooks gmail comme une surface générale d'envoi, de suppression ou de modification de labels. Pour ces actions, utilisez une voie générique explicite : un script local limité, un outil MCP de confiance, un service d'automatisation ou un plugin OpenClaw TypeScript. Exposez des actions métier étroites comme creer_brouillon ou ajouter_label_support, plutôt que l'API Gmail complète.
Pour chaque action sortante, exigez un schéma minimal : identifiant du message source, destinataire autorisé, sujet, corps borné et clé d'idempotence. L'outil doit refuser les domaines non prévus, les pièces jointes trop grandes et les doublons. Après création d'un brouillon ou ajout d'un label, relisez l'objet Gmail exact avant de signaler le succès. Ce contrôle externe empêche qu'une réponse HTTP partielle soit interprétée comme une action terminée.
Exemple concret
Prenons une boîte support dédiée. Un filtre Gmail applique le label OPENCLAW aux demandes reçues sur une adresse précise. Le webhook signale chaque nouveau message au Gateway. L'agent lit les métadonnées, classe la demande en question, incident, facturation ou hors périmètre, puis écrit une fiche de triage locale.
La fiche peut suivre ce format :
- Identifiant du message : valeur fournie par l'événement
- Catégorie : incident
- Priorité proposée : haute
- Résumé : connexion impossible après changement de mot de passe
- Action proposée : ouvrir un ticket et préparer un accusé de réception
- Validation humaine requise : oui
Le premier test doit être observable : envoyez un email depuis une adresse de test, vérifiez la réception de l'événement, inspectez la fiche produite et confirmez qu'aucune réponse n'est partie. Ajoutez ensuite l'outil d'envoi, si nécessaire, avec une liste de destinataires autorisés et une approbation. Une automatisation récurrente peut produire un digest, mais la réception événementielle reste préférable pour les alertes urgentes.
Ce modèle s'intègre à une automatisation OpenClaw sans confondre détection, raisonnement et action.
Bonnes pratiques
- Compte ou label dédié. Réduisez le volume et l'exposition de données personnelles.
- Corps borné. N'envoyez pas une conversation entière au modèle si les métadonnées suffisent.
- Contenu non fiable. Ignorez toute instruction opérationnelle trouvée dans un email tant qu'elle n'est pas confirmée par votre politique.
- Moindre privilège. Une intégration de lecture ne doit pas obtenir de droit d'envoi ou de suppression.
- Brouillon avant envoi. Faites relire les premiers cas et les réponses sensibles.
- Idempotence. Conservez l'identifiant du message pour ne pas traiter deux fois le même événement.
- Journal d'audit. Tracez la décision, l'outil appelé, le résultat et l'approbateur.
- Révocation simple. Sachez arrêter le watcher et révoquer ses accès sans bloquer le reste du Gateway.
Ne promettez pas un retour sur investissement avant d'avoir mesuré le volume, les erreurs, le temps de relecture et le coût fournisseur sur votre propre flux.
Questions fréquentes
Gmail est-il un canal OpenClaw ?
Le parcours vérifié est un webhook Gmail Pub/Sub. Il livre des événements au Gateway, mais la documentation ne le présente pas comme un canal conversationnel général au même titre que Slack.
Faut-il écrire un skill Python ?
Non. Les skills OpenClaw sont des instructions Markdown dans SKILL.md. Une extension exécutable native relève du système de plugins TypeScript ; un script externe reste un script.
Peut-on envoyer des emails avec openclaw webhooks gmail ?
Ce parcours documenté concerne la surveillance et la livraison d'événements. Pour envoyer, utilisez un outil externe borné et audité, avec validation humaine au départ.
Comment éviter qu'un email manipule l'agent ?
Traitez le corps comme une donnée non fiable, limitez les outils disponibles au workflow, interdisez les secrets dans le contexte et exigez une approbation pour les effets de bord.
Articles liés
Le parcours Gmail le plus sûr commence par la réception et une proposition sans effet de bord. Les guides suivants permettent ensuite d'ajouter des outils et automatisations en conservant cette séparation.
Restez informé sur les agents IA
Nouveaux tutoriels, comparatifs et guides pratiques directement dans votre boîte mail.