Mailbox

What This Skill Does

The Mailbox skill for OpenClaw provides a powerful command-line interface (CLI) integration for managing electronic correspondence directly within your automated environment. Developed by leeguooooo, this skill bridges the gap between your email inbox and OpenClaw's intelligent scheduling and channel delivery capabilities. By utilizing the mailbox-cli, the agent can programmatically list accounts, retrieve specific email messages, monitor incoming communications, and perform administrative cleanup tasks. All outputs are returned in structured JSON format, allowing the OpenClaw agent to parse metadata, read message bodies, and make decisions based on the content of your communications.

Installation

To integrate this tool into your OpenClaw environment, ensure you have the base CLI installed via npm using npm install -g mailbox-cli. Once the CLI is present on your host system, configure your credentials by placing your authentication details into ~/.config/mailbox/auth.json. Finally, add the skill to your agent by executing: clawhub install openclaw/skills/skills/leeguooooo/mailbox.

Use Cases

This skill is ideal for professionals seeking to automate email triage. You can use it to fetch and summarize daily newsletters, automate the deletion of junk mail from specific folders, monitor critical threads for status updates, or draft and process responses based on incoming triggers. It acts as an intelligent assistant that stays synced with your mailbox state at all times.

Example Prompts

1. "Check my inbox for the last 15 emails and give me a brief summary of the most important ones."
2. "Find the email from the project manager with the latest status update, show me the preview, and strip out all the messy HTML links."
3. "Delete all read messages in the INBOX that are older than a week to keep my account organized."

Tips & Limitations

Always prioritize safety by utilizing the --dry-run flag before running destructive operations like deletion. The skill requires consistent access to local configuration files, so ensure your OpenClaw environment has the correct permissions for the ~/.config/mailbox/ directory. Remember that the skill strictly follows a JSON contract; if an operation returns an error object, inspect the code and message fields to troubleshoot network or authentication issues. For better performance with large threads, use the --preview and --no-html flags to reduce token consumption.