Mail

What This Skill Does

The Mail skill provides a sophisticated interface for managing email operations within OpenClaw. It serves as a bridge between your local mail environments (Apple Mail) and cloud-based providers via the powerful himalaya CLI. Designed for power users, it enables reading, searching, and sending emails with an emphasis on secure credential handling via the macOS Keychain. The skill prioritizes a 'draft-review-send' workflow to ensure accuracy and prevents the accidental dissemination of information. Whether you are querying a local SQLite database for historical records or managing an inbox via IMAP, this skill maintains performance and security through strict adherence to platform-specific optimizations.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/ivangdavila/mail.

Ensure you have the required dependencies installed:

• himalaya: Install via brew install himalaya or cargo install himalaya.
• Configuration: Set up your connection details in ~/.config/himalaya/config.toml.
• Keychain: Ensure Gmail App Passwords or OAuth tokens are securely stored in your macOS Keychain to allow for non-interactive authentication.

Use Cases

• Automated Summarization: Analyze incoming threads from specific senders or time periods using SQLite queries.
• Efficient Inbox Triage: Rapidly list and filter high-priority messages using JSON-formatted output from himalaya.
• Secure Communication: Draft replies programmatically, leveraging the skill's review workflow to ensure compliance and tone before final dispatch.
• Data Retrieval: Extract attachments or historical data from Apple Mail archives without manually navigating the filesystem.

Example Prompts

1. "Find all emails from 'Project Manager' received in the last 3 days and summarize the pending action items."
2. "Compose a reply to the latest email from 'Support' acknowledging receipt and attaching the log file from ~/logs/system.log."
3. "List all unread emails in my 'Work' folder using himalaya and display them in a table format."

Tips & Limitations

• Platform Specificity: When using macOS, stick to Apple Mail SQLite queries for local mail for a 100x performance increase over standard IMAP calls. However, never mix SQLite and himalaya approaches in the same task.
• Performance: Always trigger a synchronization command (osascript for Apple Mail) before querying to avoid stale data.
• Safety: The skill is designed with a 'human-in-the-loop' philosophy. It will never auto-delete or auto-send without your explicit approval, making it safe for sensitive professional environments.