ProtonMail Skill

Use ProtonMail for secure email via Proton Mail Bridge.

Setup (once)

1. Install Proton Mail Bridge:

   brew install --cask proton-mail-bridge
   

2. Launch Bridge and sign in:

   • Open Proton Mail Bridge app
   • Sign in with your ProtonMail credentials
   • Bridge will generate local IMAP/SMTP credentials

3. Configure the skill: Add to your OpenClaw config (~/.openclaw/openclaw.json):

   {
     "skills": {
       "entries": {
         "protonmail": {
           "enabled": true,
           "env": {
             "PROTONMAIL_ACCOUNT": "your-email@pm.me",
             "PROTONMAIL_BRIDGE_PASSWORD": "bridge-generated-password"
           }
         }
       }
     }
   }
   

   Get Bridge credentials:

   • In Bridge, click your account → Mailbox configuration
   • Copy the IMAP password (NOT your ProtonMail password)
   • Use skills.entries.protonmail (not skills.protonmail)

CLI Usage

The skill provides a protonmail CLI tool:

# List inbox (most recent 10 emails)
protonmail list-inbox --limit=10 [--unread]

# Search emails
protonmail search "from:alice@example.com" --limit=20

# Read specific email
protonmail read <uid>

# Send email
protonmail send --to=bob@example.com --subject="Meeting" --body="See you at 3pm"

# Reply to email
protonmail reply <uid> --body="Sounds good!"

Common Requests

• List inbox: "Check my ProtonMail inbox"
• Search emails: "Search ProtonMail for emails from alice@example.com"
• Read email: "Read ProtonMail email UID 31"
• Send email: "Send an email via ProtonMail to bob@example.com about the project"
• Reply: "Reply to ProtonMail email UID 31"

How It Works

1. Proton Mail Bridge runs locally and connects to your ProtonMail account
2. Bridge provides local IMAP (read) and SMTP (send) servers
3. This skill connects to Bridge's local servers
4. All encryption/decryption happens locally via Bridge
5. No third-party services — direct ProtonMail integration

Security

• ✅ Official Proton software (audited, open-source Bridge)
• ✅ End-to-end encryption maintained
• ✅ Credentials stored locally only
• ✅ No API keys or tokens — uses standard IMAP/SMTP
• ✅ Bridge password is separate from your ProtonMail password

Troubleshooting

"Connection refused" errors

• Check Bridge is running: Open Proton Mail Bridge app
• Verify ports: Bridge should show 127.0.0.1:1143 (IMAP) and 127.0.0.1:1025 (SMTP)

"Authentication failed"

• Use Bridge password, not ProtonMail password: Get it from Bridge → Account → Mailbox configuration
• Check account email: Must match exactly (e.g., user@pm.me or user@protonmail.com)

"Skill not found"

• Reinstall skill: Run npm run install-skill in the skill directory
• Check OpenClaw config: Ensure skills.protonmail.enabled: true

Development

See README.md for development setup and testing.

License

MIT — See LICENSE