gmail-ro

name	gmail-ro
description	Read-only Gmail access for OpenClaw (unread + search) via gogcli.

Use this skill when the user asks things like:

• “Any unread emails?”
• “Search Gmail for ”
• “Do I have anything from <person/company> recently?”

How to call Gmail (READ-ONLY)

Run the local wrapper script with the exec tool:

• Unread inbox (demo-friendly):

  • /home/algal/.openclaw/workspace/skills/gmail-ro/bin/gmail-ro unread 10

• Search:

  • /home/algal/.openclaw/workspace/skills/gmail-ro/bin/gmail-ro search "<gmail query>" 10

The wrapper enforces read-only operations (no send/modify/delete).

Required environment

The OpenClaw service process must have:

• GOG_KEYRING_BACKEND=file
• GOG_KEYRING_PASSWORD=... (so gogcli doesn’t prompt)
• GOG_ACCOUNT=[e-mail] (so gog knows which account to use non-interactively)

Output handling

The wrapper returns JSON from gog ... --json. Summarize for the user in plain language:

• For unread: list up to ~10 items: from / subject / age.
• For search: show a short list of best matches and offer to refine the query.

Never reveal secrets (tokens/passwords). Never attempt to send email.