Gclaw

GClaw — Gmail Intelligence for OpenClaw

Reads, classifies, and digests your Gmail so the important stuff surfaces without the noise.

Zero LLM tokens for classification — heuristic classifier covers 15 categories. LLM only fires when you need a summary or digest narrative.

Setup

# Requires the gog skill (Google OAuth CLI)
export GCLAW_GMAIL_ACCOUNT="your@gmail.com"
export GOG_KEYRING_PASSWORD="your-keyring-password"

pip install -e .

Quick Usage

from kaimail.bot_context import BotContext
from kaimail.fetcher import EmailFetcher
from kaimail.classifier import EmailClassifier
from kaimail.store import EmailStore

# Each bot declares its own label scope
ctx = BotContext(
    bot_id="digest",
    allowed_labels=["INBOX", "CATEGORY_UPDATES"],
    max_results=50
)

fetcher = EmailFetcher(context=ctx)
emails = fetcher.fetch_new()  # deduped — never processes the same email twice

classifier = EmailClassifier()
store = EmailStore(bot_id="digest")

for email in emails:
    email.category = classifier.classify(email)
    store.save(email)
    print(f"[{email.category}] {email.subject}")

Classification Categories (15)

newsletter · finance · travel · work · action_required · social · shopping · security · calendar · health · legal · ads · receipt · personal · other

All heuristic — no LLM cost.

Architecture

Gmail (via gog CLI)
    └─► EmailFetcher      — fetch, cache, deduplicate
        └─► EmailParser   — extract sender, clean body, detect forwards
            └─► EmailClassifier  — 15-category heuristic classification
                └─► EmailStore  — JSONL persistence (per bot_id)

BotContext — Per-Bot Isolation

Multiple bots can share one Gmail account without interfering:

# Digest bot — only newsletters + inbox
digest_ctx = BotContext(bot_id="digest", allowed_labels=["Thoughts", "INBOX"])

# Travel bot — only travel senders
travel_ctx = BotContext(
    bot_id="travel",
    allowed_labels=["Travel"],
    allowed_senders=["booking.com", "airbnb.com", "kayak.com"]
)

Running Tests

pip install pytest
pytest tests/

Requirements

• Python 3.10+
• gog skill installed and authenticated
• GOG_KEYRING_PASSWORD env var set

License

MIT