Agent Skills
› openclaw/gogcli
› gog-gmail
gog-gmail
GitHub基于gog工具执行Gmail各项操作,包括邮件收发、搜索、归档、标签管理及附件处理等。提供安全启动指南与只读模式规范,确保自动化场景下的数据一致性与操作安全性。
Trigger Scenarios
需要发送或接收电子邮件
搜索和管理Gmail邮件
处理Gmail草稿和附件
Install
npx skills add openclaw/gogcli --skill gog-gmail -g -y
SKILL.md
Frontmatter
{
"name": "gog-gmail",
"description": "Gmail operations through gog."
}
Gmail
Use gog for Gmail operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema gmail --json
gog --readonly --account user@example.com gmail search 'newer_than:7d' --max 10 --json --wrap-untrusted
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
archive |
Archive messages or explicit threads (remove from inbox) |
attachment |
Download a single attachment |
autoreply |
Reply once to matching messages |
batch |
Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) |
drafts |
Draft operations |
forward |
Forward a message to new recipients |
get |
Get a message (full|metadata|raw) |
history |
Gmail history |
import |
Import an RFC822/EML message into Gmail |
labels |
Label operations |
mark-read |
Mark messages as read |
messages |
Message operations |
raw |
Dump raw Gmail API response as JSON (Users.Messages.Get; lossless; for scripting and LLM consumption) |
reply |
Reply to a message |
reply-all |
Reply to all message participants |
search |
Search threads using Gmail query syntax |
send |
Send an email |
settings |
Settings and admin |
thread |
Thread operations (get, modify) |
track |
Email open tracking |
trash |
Move messages to trash |
unread |
Mark messages as unread |
url |
Print Gmail web URLs for threads |
Run gog gmail <command> --help for flags and gog schema gmail <command> --json
for the machine-readable contract. Do not guess command syntax.
Version History
- eb85a99 Current 2026-08-20 12:40


