A specialized toolset for reading, searching, and scanning ProtonMail accounts via secure IMAP bridges like Proton Bridge or hydroxide.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install protonmail
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install protonmail using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ProtonMail Skill?
The ProtonMail Skill provides a bridge between the highly secure, encrypted ProtonMail environment and the automation capabilities of Openclaw Skills. By utilizing local IMAP bridges, this skill allows users to programmatically interact with their inbox while maintaining the end-to-end encryption benefits of Proton. It is designed for developers who need to integrate secure communications into their AI-driven workflows without compromising privacy.
Whether you are looking to build a custom email dashboard or automate your response systems, this skill provides the necessary CLI tools and scripts to fetch, filter, and summarize your communications effectively. It bridges the gap between secure storage and actionable data for modern agentic workflows.
ProtonMail Skill Use Cases
- Creating automated daily email digests for high-priority senders.
- Searching through encrypted archives using CLI-based keyword queries.
- Monitoring specific mailboxes for urgent notifications using Openclaw Skills logic.
- Automating the sorting of newsletters and system notifications via Sieve filters.
- Integrating secure email access into a centralized AI dashboard.
How ProtonMail Skill Works
- Deploy an IMAP bridge (either the official Proton Bridge via Docker or the headless hydroxide client) to handle decryption locally.
- Authenticate the bridge with your ProtonMail credentials to establish a secure local IMAP server.
- Configure the skill environment variables with your local bridge connection details and credentials.
- Execute Python-based CLI commands to list mailboxes, fetch unread messages, or read specific email contents.
- Optionally run the daily scan utility to parse headers and subjects for priority keywords and trusted senders.
ProtonMail Skill Setup
1. Set up the IMAP Bridge
Choose either the official Bridge or hydroxide:
Option A: Proton Bridge (Docker)
docker run -d --name=protonmail-bridge -v protonmail:/root -p 143:143 -p 1025:25 --restart=unless-stopped shenxn/protonmail-bridge
docker run --rm -it -v protonmail:/root shenxn/protonmail-bridge init
Option B: hydroxide (Headless)
git clone https://github.com/emersion/hydroxide.git
cd hydroxide && go build ./cmd/hydroxide
./hydroxide auth [email protected]
./hydroxide serve
2. Configuration
Create a configuration file at ~/.config/protonmail-bridge/config.env:
PROTONMAIL_HOST=127.0.0.1
PROTONMAIL_PORT=143
[email protected]
PROTONMAIL_PASS=your-bridge-password
ProtonMail Skill Data Schema & Taxonomy
The skill processes IMAP data structures and provides structured access to the following entities:
| Entity | Description |
|---|---|
| Mailboxes | A list of available IMAP folders (Inbox, Drafts, Sent, etc.) |
| Headers | Metadata including Sender, Subject, and Timestamp used for filtering |
| Content | Decrypted email body text retrieved via the read command |
| Daily Scan | A synthesized summary of emails flagged by the importance algorithm |
ProtonMail Skill Advanced Features
- Multi-language support for urgency detection (English, German, and Dutch) within the daily-scan script.
- Custom Sieve filter integration to pre-process emails on the ProtonMail server before they reach Openclaw Skills.
- Flexible deployment options supporting both containerized environments and lightweight headless setups.
- Automated importance flagging based on a configurable list of trusted domains and urgent keywords.
SKILL.md
Loading
Related Openclaw Skills
Duola Lobster Agent
An institutional-grade execution playbook for the Duola Polymarket copy-trading CLI within agent workflows.
med-info
A specialized tool for fetching authoritative, label-backed medication answers with traceable identifiers and regulatory safety context.
ACE-Step Music Generation Skill
A professional-grade AI music generation tool that leverages the ACE-Step V1.5 API to create full songs, vocals, and instrumentals from text prompts.
ACE-Step Songwriting Guide
A professional music creation guide for writing lyrics, captions, and technical parameters for the ACE-Step engine.
DrawThings Image Generation
A high-performance local image generation skill that interfaces with DrawThings to provide Stable Diffusion capabilities via an API on macOS.
Apify Web Scraping & Data Extraction
A powerful tool for discovering and executing Apify Actors to scrape structured data from social media and websites.
Featured*
