Menu
Voltar ao índice
IA e agentes Fonte oficial

Leia mensagens do Gmail pela CLI gws

Recupere uma mensagem do Gmail por ID e extraia corpo, cabeçalhos, texto simples, HTML ou JSON para processamento.

Ver código no GitHub Instala diretamente do repositório-fonte.
VISÃO GERAL

O que esta skill faz

Esta skill lê uma mensagem específica do Gmail com gws gmail +read. Ela trata mensagens multipart, decodifica base64 e pode converter conteúdo disponível apenas em HTML para texto simples.

CASOS DE USO

Quando usar

  • Extrair o corpo de um email para processamento
  • Consultar remetente, destinatário, assunto e data
  • Obter saída JSON para uso com jq
  • Recuperar o corpo HTML quando necessário
GUIA PRÁTICO

Como usar

  1. Configure a autenticação conforme gws-shared
  2. Obtenha o ID da mensagem que será consultada
  3. Execute gws gmail +read --id <ID>
  4. Adicione --headers, --html ou --format json conforme a saída desejada
  5. Use --dry-run para inspecionar a requisição antes da execução
LIMITAÇÕES

O que revisar antes de instalar

  • Exige o ID exato da mensagem e acesso à conta correspondente
  • A saída HTML deve ser tratada como conteúdo não confiável
  • A skill lê uma mensagem; busca e gestão ampla dependem de outros comandos do Gmail
CONTEÚDO ORIGINAL

SKILL.md

---
name: gws-gmail-read
description: "Gmail: Read a message and extract its body or headers."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws gmail +read --help"
---

# gmail +read

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

Read a message and extract its body or headers

## Usage

```bash
gws gmail +read --id <ID>
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--id` | ✓ | — | The Gmail message ID to read |
| `--headers` | — | — | Include headers (From, To, Subject, Date) in the output |
| `--format` | — | text | Output format (text, json) |
| `--html` | — | — | Return HTML body instead of plain text |
| `--dry-run` | — | — | Show the request that would be sent without executing it |

## Examples

```bash
gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'
```

## Tips

- Converts HTML-only messages to plain text automatically.
- Handles multipart/alternative and base64 decoding.

## See Also

- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands