protonmail

Protonmail

Send, read, search, and organize Protonmail messages via Proton Bridge + himalaya.

Script: scripts/proton.py Config: config/config.json

First-time setup

When config/config.json is missing, the skill outputs SETUP_REQUIRED instead of running commands. Follow this two-step flow:

Step 1: Install Proton Bridge

Proton Bridge runs locally and exposes standard IMAP/SMTP on localhost. It must be installed and logged in before the skill works.

1. Download the .deb from https://proton.me/bridge/install
2. Install: sudo apt install ./protonmail-bridge_*.deb
3. Set up pass for credential storage (Bridge requires it — see references/setup.md for details)
4. Log in via Bridge CLI: protonmail-bridge --cli then login
5. Run info inside the Bridge CLI to get the Bridge password (a generated string like abcdefghijklmnop)
6. Start Bridge as a systemd user service so it runs in the background

The Bridge password is NOT your Proton account password. It is a randomly generated credential that Bridge creates for local IMAP/SMTP access. You get it from the info command inside Bridge CLI.

Set the Bridge password in OpenClaw's secrets system:

Use /secret set PROTON_BRIDGE_PASSWORD and paste the Bridge password from step 5.

Step 2: Configure the skill

Ask the user for:

1. Proton email address (e.g., you@proton.me or you@pm.me)
2. Display name (for outgoing emails)

Then run:

python3 $PROTON setup configure --email USER_EMAIL --display-name "USER_NAME"

This writes config/config.json, generates the himalaya config, and verifies connectivity to Bridge.

Quick reference

PROTON=~/.openclaw/workspace/skills/protonmail/scripts/proton.py

# Email
python3 $PROTON email list                                       # Latest 10
python3 $PROTON email list --count 20                            # Latest 20
python3 $PROTON email list --folder Sent                         # Sent folder
python3...