# Référence — Gmail (`gog` CLI)

(Déplacé d’AGENTS.md le 26/09/2026 pour la marge de la fiche. Contenu identique, lu à la demande. Les garde-fous de sécurité 4.6/4.7 sont AUSSI répétés dans la fiche.)

## 4. Gmail — `gog` CLI v0.21.0 (OPÉRATIONNEL)

Actif depuis le 9 juin 2026, auth OAuth Google persistée.
Compte : `tallagrand.thierry@gmail.com`. Keyring : `/home/node/.openclaw/gogcli/data/keyring/`.
Règles métier détaillées : `workspace/gmail-rules.md`.
Toutes les commandes ci-dessous s'invoquent via `exec` (voir §1.2).

### 4.1 Lecture
**Préférer `mail-texte` pour lire :** `python3 workspace/mail-texte.py lire <threadId>` /
`… chercher "<requête>"` (texte propre + sécurité imposée). Les commandes gog ci-dessous
sont la référence bas-niveau.


⚠️ `gog … thread get --full --sanitize-content` décode déjà MIME/base64/charset et
assainit le HTML en texte. NE décode JAMAIS le base64 à la main via exec. (`gog gmail
messages get` N'EXISTE PAS en v0.21.0 : c'est `thread get`.)

| Tâche | Commande |
|---|---|
| Chercher des threads | `gog gmail search "<query>" -a tallagrand.thierry@gmail.com -j --max N` |
| Lister les labels | `gog gmail labels list -a tallagrand.thierry@gmail.com` |
| Détail d'un thread (texte propre) | `gog gmail thread get <id> -a tallagrand.thierry@gmail.com --full --sanitize-content` |
| Lire un mail (texte propre) | `gog gmail thread get <threadId> -a tallagrand.thierry@gmail.com --full --sanitize-content` |

### 4.2 Envoi

    gog gmail send -a tallagrand.thierry@gmail.com --to <destinataire> --subject "<sujet>" --body "<corps>"

Flags : `--cc=`, `--bcc=`, `--body-html="<html>"`, `--attach=<path>` (répétable),
`--reply-to-message-id=<id>`, `--dry-run`, `-j`.

Exemple avec pièce jointe :

    gog gmail send -a tallagrand.thierry@gmail.com --to tallagrand.thierry@gmail.com --subject "Cours ORA" --body "ORA.PA : 17,86€ (+1,16%)" --attach /home/node/.openclaw/workspace/charts/prix_ora.png

### 4.3 Brouillons

| Tâche | Commande |
|---|---|
| Créer | `gog gmail drafts create -a <email> --to <dest> --subject "…" --body "…"` |
| Lister | `gog gmail drafts list -a <email>` |
| Envoyer | `gog gmail drafts send <draftId> -a <email>` |
| Supprimer | `gog gmail drafts delete <draftId> -a <email>` |

### 4.4 Mutations — `--dry-run` obligatoire avant action de masse

| Tâche | Commande |
|---|---|
| Corbeille | `gog gmail trash <messageId…> -a <email> --dry-run` puis `--force` (IDs obtenus par `search … -j`, PAS une requête) |
| Archiver | `gog gmail archive <messageId…> -a <email> --dry-run` puis `--force` (idem : IDs, pas de requête) |
| Labels | `gog gmail messages modify <id> -a <email> --add-label X --remove-label Y` |

### 4.5 Mapping question → action

| Question | Commande |
|---|---|
| « Envoie un mail à X, sujet Y, corps Z » | `gog gmail send --to X --subject "Y" --body "Z"` |
| « Envoie-moi un mail » | `gog gmail send --to tallagrand.thierry@gmail.com …` |
| « Combien de mails aujourd'hui » | `gog gmail search "in:inbox newer_than:1d" -j --max 100` |
| « Trie mes vieilles promos » | `search "category:promotions older_than:30d" -j` pour les IDs, puis `trash <ids> --dry-run` |
| « Liste les mails de X » | `gog gmail search "from:X" -j --max N` |

### 4.6 JAMAIS

1. **Suppression définitive** (`messages.delete`) : interdiction absolue. Toujours `trash` (récupérable 30 jours).
2. **Toucher la whitelist** : voir `gmail-rules.md`. Un mail qui matche un domaine whitelisté → ABORT silencieux.
3. Plus de **200 actions par batch**.
4. Plus de **2000 actions par jour** sans confirmation humaine explicite.
5. **Modifier les labels système** : `INBOX` peut être retiré (archivage), mais
   `SENT`/`DRAFT`/`IMPORTANT`/`STARRED`/`SPAM`/`TRASH` sont en lecture seule.
6. Lancer une vague sans dry-run validé.

### 4.7 TOUJOURS

1. **Dry-run** avant toute action de masse (>5 mails) : lister les IDs (échantillon 10 + total),
   présenter à validation, exécuter seulement après un « go » explicite.
2. **Logger chaque batch** dans `gmail-housekeeping.md` (append-only) : timestamp, règle,
   IDs touchés, action, résultat.
3. **`gmail-rules.md` est la source de vérité unique** des règles de tri.
4. **Relire la whitelist au runtime** à chaque vague, pas seulement au design.
5. **En cas de doute** sur un mail → le laisser en inbox et le loguer dans `gmail-doubts.md`.
6. **Pause de 5 s** entre deux batchs `trash` ou `archive`.
7. En cas d'échec : rapporter l'erreur réelle (stderr). 2 erreurs syntaxe/auth maximum, puis STOP.

### 4.8 Cron quotidien `daily-email-report`

`30 8 * * *` Europe/Paris, livré sur WhatsApp en `announce` vers `+33607148216`.
Format attendu :

- Ligne 1 : résumé global court (ex. « Gmail : 3 nouveaux, 1 important »).
- Ensuite, UNIQUEMENT les messages importants (livraisons, rendez-vous, alertes, factures),
  avec expéditeur, sujet, date/heure. **5 messages détaillés maximum.**
- En français. Ignorer promotions et newsletters dans le détail.


### 4.9 Boîtes Orange (`thierry.tallagrand@wanadoo.fr`) et AIRTRIA (`@airtria.fr`, MailPlus sur ARCHIVE2) — IMAP, pas gog

`gog` ne parle qu'à Gmail. La boîte Orange se lit par IMAP avec des scripts du workspace,
secret dans `.env` (`ORANGE_IMAP_PASSWORD`), jamais dans une commande ni un message :

- `python3 /home/node/.openclaw/workspace/mail-recent.py orange|airtria [heures]` : mails reçus sur N h ;
  `… orange|airtria non-lus` : total et non lus de la boîte (pour « combien de non lus ? »)
  (défaut 24), LECTURE SEULE, une ligne par mail avec `[non lu]` / `[newsletter]`. C'est
  l'outil du cron `orange-email-report` (20 h, WhatsApp, même format que §4.8).
- `orange-menage.py` : vagues de ménage selon `orange-rules.md` (dry-run par défaut,
  `--go` UNIQUEMENT sur demande explicite du propriétaire). Corbeille = `INBOX/TRASH`
  (récupérable), archives = `INBOX/Archives/<année>`. Jamais de suppression définitive.
- Journal : `orange-housekeeping.md`. Audit : `orange-audit.md`.
- **AIRTRIA (boîte pro)** : `python3 /home/node/.openclaw/workspace/mail-recent.py airtria [heures]`
  (lecture seule, même format) ; ménage `airtria-menage.py` selon `airtria-rules.md` (dry-run par
  défaut, `--go` sur demande explicite), corbeille = `Trash`, archives = `Archives.<année>`,
  veille = `Veille`. Crons : `airtria-tri-quotidien` 19h50, `airtria-email-report` 20h30.
  Journal `airtria-housekeeping.md`. `mail-recent.py orange` fonctionne aussi (= orange-recent.py).
---