one-mail

What This Skill Does

one-mail is a unified command-line interface designed to streamline email management across multiple providers, including Gmail, Outlook, and Netease (163/126). By acting as a bridge between the terminal and your email servers, it simplifies complex workflows such as fetching, reading, sending, and managing multiple accounts simultaneously. The skill excels at cross-account searching, providing a centralized way to handle incoming mail without needing to switch browser tabs or desktop applications. It supports advanced features like JSON-formatted output for programmatic processing and granular filtering by account or status.

Installation

To integrate one-mail into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/huangbaixun/one-mail After installation, initialize the environment by running bash scripts/setup.sh to configure your credentials securely within ~/.onemail/. Ensure that you have curl, jq, and python3 installed on your host system. For Gmail, you will also need the gog CLI tool for OAuth 2.0 authentication.

Use Cases

This skill is ideal for power users who spend their day in the terminal and need to monitor multiple inboxes. Use it to automate routine email tasks, such as generating automated reports with attachments or clearing unread messages across all platforms at once. It is also perfect for developers who want to incorporate email notification logic into shell scripts or CI/CD pipelines.

Example Prompts

1. "Check for any unread emails regarding 'Project Alpha' across my Gmail and Outlook accounts."
2. "Send an email to [email protected] with the subject 'Weekly Report' and attach the file located at /home/user/docs/report.pdf using my default account."
3. "Show me a summary of my inbox statistics for all configured mail accounts."

Tips & Limitations

• Authentication: Gmail and Outlook utilize OAuth 2.0. Ensure you have the necessary API permissions (Mail.ReadWrite and Mail.Send for Outlook) configured before attempting to send messages.
• Storage: Sensitive configuration data is stored locally in ~/.onemail/. Back up this directory if you frequently move between machines.
• Limitations: Outlook attachments are strictly limited to 3MB per email. Ensure attachments adhere to provider-specific constraints. For Netease providers, you must explicitly enable IMAP/SMTP in your web settings and use an application-specific password rather than your login password.