Agent Skills
› googleworkspace/cli
› gws-gmail-read
gws-gmail-read
GitHub通过命令行读取Gmail邮件内容，支持提取正文或头部信息，可指定输出格式及HTML模式。
Trigger Scenarios
需要获取Gmail邮件的具体内容
解析邮件头部元数据
Install
npx skills add googleworkspace/cli --skill gws-gmail-read -g -y
SKILL.md
Frontmatter
{
"name": "gws-gmail-read",
"metadata": {
"version": "0.22.5",
"openclaw": {
"cliHelp": "gws gmail +read --help",
"category": "productivity",
"requires": {
"bins": [
"gws"
]
}
}
},
"description": "Gmail: Read a message and extract its body or headers."
}
gmail +read
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Read a message and extract its body or headers
Usage
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
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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Version History
- a3768d0 Current 2026-08-20 07:24
