← Back to Skills Marketplace
fly3094

Email Automation

by fly3094 · GitHub ↗ · v1.2.0 · MIT-0
cross-platform ⚠ suspicious
945
Downloads
0
Stars
11
Active Installs
5
Versions
Install in OpenClaw
/install email-automation
Description
Automate email triage, categorize, draft replies, and auto-archive in Gmail, Outlook, or IMAP to maintain an organized, efficient inbox.
README (SKILL.md)

Email Automation 📧

Automate your email inbox with AI-powered triage, categorization, and draft replies. Achieve inbox zero effortlessly.

What It Does

  • 📥 Smart Triage: AI analyzes and prioritizes incoming emails
  • 🏷️ Auto-Categorization: Sort emails into custom categories
  • ✍️ Draft Replies: AI generates context-aware reply drafts
  • 🗑️ Auto-Archive: Clean up newsletters, notifications, receipts
  • ⚠️ Urgent Alerts: Get notified for important emails
  • 📊 Inbox Analytics: Track email patterns and time saved

Installation

clawhub install email-automation

Commands

Process Inbox

Process my inbox and categorize emails

Generate Reply Drafts

Draft replies for unread important emails

Clean Inbox

Archive newsletters and notifications older than 7 days

Inbox Summary

Show me my inbox summary for today

Urgent Emails Only

Show only urgent emails from today

Setup Wizard

Help me set up email automation

Configuration

Environment Variables

# Email provider
export EMAIL_PROVIDER="gmail"  # gmail|outlook|imap

# Your email address
export EMAIL_ADDRESS="[email protected]"

# Gmail API (if using Gmail)
export GMAIL_CREDENTIALS_FILE="/path/to/credentials.json"

# Outlook API (if using Outlook)
export OUTLOOK_ACCESS_TOKEN="your_access_token"

# IMAP (if using other providers)
export IMAP_SERVER="imap.example.com"
export IMAP_USERNAME="your_username"
export IMAP_PASSWORD="your_app_password"

# Automation settings
export AUTO_ARCHIVE="true"
export CATEGORIES="urgent,important,newsletters,notifications,receipts"

Gmail Setup (Recommended)

  1. Visit https://console.cloud.google.com
  2. Create new project
  3. Enable Gmail API
  4. Create OAuth credentials
  5. Download credentials.json
  6. Place in secure location
  7. Set GMAIL_CREDENTIALS_FILE path

Outlook Setup

  1. Visit https://portal.azure.com
  2. Register app in Azure AD
  3. Add Microsoft Graph permissions
  4. Generate access token
  5. Set OUTLOOK_ACCESS_TOKEN

Output Examples

Inbox Summary

📧 Inbox Summary - March 7, 2026

Total emails: 47
• Urgent: 3
• Important: 8
• Newsletters: 15
• Notifications: 12
• Receipts: 5
• Unread: 11

Top senders:
1. Amazon (5 emails)
2. GitHub (4 emails)
3. LinkedIn (3 emails)

Time saved: ~2 hours

Auto-Categorization

🏷️ Categorized 47 emails:

[Urgent] (3)
• Boss: "Meeting rescheduled to 3pm"
• Client: "Contract needs review ASAP"
• Bank: "Suspicious activity alert"

[Important] (8)
• Team: "Project update"
• Newsletter: "Industry insights"
...

[Newsletters] (15)
• TechCrunch Daily
• Hacker News Digest
...

[Notifications] (12)
• GitHub notifications
• Slack mentions
...

[Receipts] (5)
• Amazon order confirmation
• Uber receipt
...

Draft Replies

✍️ Generated 5 reply drafts:

1. To: Boss
   Subject: Re: Meeting rescheduled
   Draft: "Thanks for the update. I'll be there at 3pm..."
   
2. To: Client
   Subject: Re: Contract review
   Draft: "I've reviewed the contract. Here are my thoughts..."

Drafts saved to drafts folder for your review.

Automation Rules

Default Rules

Condition Action
From boss/client Mark urgent
Contains "ASAP", "urgent" Mark urgent
Newsletter sender Auto-archive after 7 days
Receipt/invoice Label & archive
Notification Auto-archive after 3 days
Unsubscribe header Suggest unsubscribe

Custom Rules

Create rules.yml:

rules:
  - name: VIP senders
    from:
      - [email protected]
      - [email protected]
    action: mark_urgent
    
  - name: Shopping receipts
    from:
      - amazon.com
      - ebay.com
    action: label_receipts
    
  - name: Social notifications
    subject_contains:
      - "mentioned you"
      - "new follower"
    action: archive

Integration with Other Skills

rss-to-social

Email notifications from rss-to-social
→ Auto-categorize as "Social Media Updates"
→ Archive after reading

social-insights

Weekly analytics report
→ Email delivery
→ Auto-generate summary

seo-content-pro

Content drafts
→ Send via email for review
→ Track feedback

Use Cases

Inbox Zero

  • Process 100+ emails in minutes
  • Auto-archive low-priority
  • Focus on what matters

Business Email

  • Prioritize client emails
  • Draft professional replies
  • Never miss urgent messages

Personal Email

  • Filter newsletters
  • Organize receipts
  • Clean inbox automatically

Pricing Integration

This skill powers LobsterLabs email services:

  • Setup & Configuration: $299 one-time
  • Monthly Management: $199/month
  • Business Plan: $499/month (multiple accounts)

Contact: PayPal [email protected]

Tips for Best Results

  1. Start with Gmail - Best API support
  2. Use App Passwords - More secure than regular passwords
  3. Review First Week - Train AI on your preferences
  4. Customize Categories - Match your workflow
  5. Set Up Filters - Combine with email provider filters

Troubleshooting

Authentication Failed

  • Verify credentials are correct
  • Check API permissions
  • Regenerate tokens if expired

Emails Not Categorizing

  • Ensure categories are configured
  • Check AI model access
  • Review categorization rules

Drafts Not Generated

  • Verify unread emails exist
  • Check AI model availability
  • Review draft folder permissions

Changelog

1.0.0 (2026-03-07)

  • Initial release
  • Gmail/Outlook/IMAP support
  • AI-powered categorization
  • Auto-reply drafts
  • Smart archiving
  • Inbox analytics

💖 支持作者

如果你觉得这个技能有用,请考虑打赏支持:

你的支持是我持续改进的动力!

Usage Guidance
Do not provide real OAuth tokens, IMAP passwords, or Gmail credential files to this skill yet. The package currently contains only a demo script that simulates email processing; the README asks for credentials and describes integrations that the code does not implement. Before installing or running with real secrets: 1) Ask the author for the real connector code or an explanation why credentials are required; 2) Inspect or request code that performs real IMAP/Gmail/Graph calls (look for imaplib, exchangelib, googleapiclient, requests to graph.microsoft.com, or direct socket/SMTP/IMAP connections); 3) If you must test, use a disposable account and run in a sandbox so credentials can’t be leaked; 4) Prefer a version that documents required env vars in the registry metadata and includes audited connector code rather than only instructions. If the author confirms this is intentionally a demo, treat the skill as non-functional for real inbox automation until proper connectors are provided.
Capability Analysis
Type: OpenClaw Skill Name: email-automation Version: 1.2.0 The skill bundle is a simulated email automation tool that provides mock functionality for categorizing emails and generating reply drafts. While the documentation (SKILL.md) requests sensitive environment variables like IMAP_PASSWORD and OUTLOOK_ACCESS_TOKEN, the core logic in scripts/email_processor.py is entirely local and uses hardcoded demo data, performing no actual network requests or credential exfiltration. The inclusion of commercial pricing and a PayPal address ([email protected]) is unusual but does not constitute malicious behavior.
Capability Tags
cryptocan-make-purchasesrequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The README/description promises real integrations with Gmail, Outlook, and IMAP (triage, draft replies, auto-archive). However, the shipped code (scripts/email_processor.py) only simulates fetching emails and never implements API calls or IMAP connections. Registry metadata claims no required env vars/credentials, while SKILL.md documents many sensitive env vars needed for real integrations. This inconsistency means the skill is not actually what it advertises or the manifest is incomplete.
Instruction Scope
SKILL.md instructs users to create OAuth credentials, set OUTLOOK_ACCESS_TOKEN, IMAP passwords, and create rules.yml — none of which are read or used by the provided script. The instructions therefore overreach relative to the code's behavior, asking users to expose sensitive tokens and files that the shipped runtime does not appear to need.
Install Mechanism
There is no install spec (instruction-only) aside from a small Python script included. Nothing is downloaded or extracted during install. No obfuscated or network-fetching installer is present in the package.
Credentials
SKILL.md requests highly sensitive environment variables (GMAIL_CREDENTIALS_FILE, OUTLOOK_ACCESS_TOKEN, IMAP_USERNAME/PASSWORD) but the registry metadata lists none, and the script only reads EMAIL_ADDRESS, EMAIL_PROVIDER, AUTO_ARCHIVE, CATEGORIES, and an optional EMAIL_AUTOMATION_DATA_DIR. Asking for tokens/credentials in docs without declaring them in metadata or actually using them in code is disproportionate and risky for users who might supply secrets unnecessarily.
Persistence & Privilege
The script writes a small local data directory (default .email-automation) and a processed.json history file. always:false (no forced global enable). The persistence is limited to the skill's folder and does not attempt to modify other skills or system-wide configs, but it does store processed email IDs and last_run on disk.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install email-automation
  3. After installation, invoke the skill by name or use /email-automation
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
- Version updated to 1.2.0 - No functional or feature changes; documentation (SKILL.md) version number updated only.
v1.1.0
添加 Gmail 2026 API 支持、AI 智能回复增强、邮件模板库、批量操作、邮件追踪功能
v1.0.2
- Updated version to 1.0.2 in SKILL.md. - Added WeChat and Alipay QR code images for author support at the end of the documentation.
v1.0.1
- Added dedicated support section with PayPal, WeChat, Alipay, and email contact information. - Introduced a new Chinese-language "支持作者" (Support the Author) section at the end with payment options. - Version bumped to 1.0.1.
v1.0.0
Initial release: Smart email triage, auto-categorization, AI reply drafts, inbox zero automation
Metadata
Slug email-automation
Version 1.2.0
License MIT-0
All-time Installs 11
Active Installs 11
Total Versions 5
Frequently Asked Questions

What is Email Automation?

Automate email triage, categorize, draft replies, and auto-archive in Gmail, Outlook, or IMAP to maintain an organized, efficient inbox. It is an AI Agent Skill for Claude Code / OpenClaw, with 945 downloads so far.

How do I install Email Automation?

Run "/install email-automation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Email Automation free?

Yes, Email Automation is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Email Automation support?

Email Automation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Email Automation?

It is built and maintained by fly3094 (@fly3094); the current version is v1.2.0.

💬 Comments