โ† All skills
Tencent SkillHub ยท Productivity

Gmail Cleaner

Clean and organize Gmail accounts in bulk. Use when asked to clean Gmail, remove spam, trash newsletters/promotional emails, bulk-delete emails by sender, cr...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Clean and organize Gmail accounts in bulk. Use when asked to clean Gmail, remove spam, trash newsletters/promotional emails, bulk-delete emails by sender, cr...

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Item is unstable.

This item is timing out or returning errors right now. Review the source page and try again later.

Quick setup
  1. Wait for the source to recover or retry later.
  2. Review SKILL.md only after the source returns a real package.
  3. Do not rely on this source for automated install yet.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Manual review
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
scripts/auth.py, scripts/clean.py, scripts/deep_clean.py, scripts/organize.py, scripts/restore.py, scripts/scan.py

Validation

  • Wait for the source to recover or retry later.
  • Review SKILL.md only after the download returns a real package.
  • Treat this source as transient until the upstream errors clear.

Install with your agent

Agent handoff

Use the source page and any available docs to guide the install because the item is currently unstable or timing out.

  1. Open the source page via Review source status.
  2. If you can obtain the package, extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the source page and extracted files.
New install

I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.

Upgrade existing

I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 11 sections Open source page

Gmail Cleaner

Bulk Gmail cleanup using the Gmail API. Processes 1000 messages per API call.

Prerequisites

google-api-python-client, google-auth-oauthlib Python packages (scripts auto-install if missing) OAuth credentials JSON from Google Cloud Console (Desktop app type) Token files stored as .pkl files per account

1. Auth (first time or new account)

python scripts/auth.py --credentials /path/to/credentials.json --token /path/to/token.pkl --scopes settings basic scopes: read/modify/delete messages + labels settings scopes: adds gmail.settings.basic (required for creating filters) Default token path: ~/.openclaw/workspace/gmail_token.pkl Default creds path: ~/.openclaw/workspace/gmail_credentials.json For a second account, specify a different --token path (e.g., gmail_token_work.pkl).

2. Scan (identify what to clean)

python scripts/scan.py --token /path/to/token.pkl --sample 500 Shows inbox counts by category + top 40 senders. Run this first.

3. Clean (bulk trash/delete)

# Trash specific senders: python scripts/clean.py --from "spam@example.com,news@example.org" # Trash by Gmail search query: python scripts/clean.py --query "category:promotions older_than:30d" # From a JSON config file (list of {query, label}): python scripts/clean.py --config senders.json # Permanently delete instead of trash: python scripts/clean.py --from "spam@example.com" --delete # Dry run first: python scripts/clean.py --from "spam@example.com" --dry-run

4. Deep Clean (comprehensive)

# Full deep clean (4 steps: trash promos โ†’ archive old โ†’ mark read โ†’ purge trash): python scripts/deep_clean.py # Custom age thresholds: python scripts/deep_clean.py --promo-days 7 --archive-days 30 --unread-days 14 # Skip trash purge (keep trash for 30-day auto-delete): python scripts/deep_clean.py --skip-trash-purge

5. Organize (labels + filters)

# Apply built-in label set (Business, Banking, Tech, Personal, Trading, Social): python scripts/organize.py # Custom labels/rules/filters from JSON: python scripts/organize.py --config labels.json # Labels only (no filters): python scripts/organize.py --skip-filters

6. Restore (rescue emails from trash)

# Restore all emails from a sender + apply a label: python scripts/restore.py --from healthbeat@mail.health.harvard.edu --label "Harvard Health" # Restore by query: python scripts/restore.py --query "from:apple.com in:trash" --label "Tech/Apple"

Multiple Accounts

Run each script with a different --token path per account: python scripts/scan.py --token ~/.openclaw/workspace/gmail_token_personal.pkl python scripts/scan.py --token ~/.openclaw/workspace/gmail_token_work.pkl python scripts/deep_clean.py --token ~/.openclaw/workspace/gmail_token_work.pkl

Common Patterns

Full cleanup for one account: python scripts/auth.py --scopes settings python scripts/scan.py # identify top senders python scripts/clean.py --from "..." # trash specific senders python scripts/deep_clean.py # clean categories python scripts/organize.py # create labels + filters Rescue important emails caught in bulk delete: python scripts/restore.py --from important@example.com --label "Important" Senders config file format for clean.py --config: [ {"query": "from:temu@eu.temuemail.com", "label": "Temu"}, {"query": "category:promotions older_than:7d", "label": "Old Promos"} ]

Notes

batchModify moves to TRASH โ€” Gmail auto-purges after 30 days batchDelete is permanent and irreversible โ€” always dry-run first Gmail filter creation requires gmail.settings.basic scope โ€” re-auth with --scopes settings if filters fail with 403 scan.py samples N messages; large inboxes may need --sample 2000 for accuracy Credentials JSON comes from Google Cloud Console โ†’ APIs & Services โ†’ Credentials โ†’ OAuth 2.0 โ†’ Desktop โ†’ Download JSON

Category context

Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
6 Scripts
  • scripts/auth.py Scripts
  • scripts/clean.py Scripts
  • scripts/deep_clean.py Scripts
  • scripts/organize.py Scripts
  • scripts/restore.py Scripts
  • scripts/scan.py Scripts