proton-bridge-email

What This Skill Does

The proton-bridge-email skill enables your OpenClaw agent to interface with the Proton Mail Bridge to send automated emails using local SMTP. By leveraging the age file encryption tool, this skill ensures that your sensitive authentication credentials—such as the Bridge-specific SMTP password, email address, and server configurations—are never stored in plaintext on your disk. Instead, the configuration remains encrypted at ~/clawd/secrets/proton.env.age, only decrypted at runtime when the agent executes the provided Python utility to dispatch messages. This is the ideal solution for users who prioritize privacy and self-hosting while needing to integrate automated reports or alert notifications directly into their existing Proton ecosystem.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface: clawhub install openclaw/skills/skills/boilerrat/protom-bridge-email. Once installed, ensure you have the age utility available on your system path. Follow the setup guide in references/proton-bridge-setup.md to configure the Proton Mail Bridge Linux service. Generate your credentials, place them in a temporary file, and run bash scripts/encrypt_env.sh /tmp/proton.env <age-public-key> to generate the secure artifact. Verify your ~/.config/age/keys.txt is correctly configured, as the agent relies on this to decrypt the SMTP settings upon execution.

Use Cases

This skill is designed for scenarios where automation must bridge the gap between headless AI operations and secure personal communications. Common use cases include:

• Automated Reporting: Configuring your agent to send a daily summary or analysis report to your primary inbox.
• Alerting Systems: Having the agent email you directly when it detects critical changes in monitored data or system events.
• Privacy-First Notifications: Sending notifications from agent workflows without relying on third-party SaaS email APIs, keeping all traffic within the Proton Mail infrastructure.

Example Prompts

• "Send a daily system status summary to [email protected] using the proton-bridge-email skill."
• "Alert me at [email protected] with the results of the last data analysis task using my secure bridge connection."
• "Use the Proton Bridge to email a notification to the team list once the backup process completes successfully."

Tips & Limitations

• Bridge Status: The Proton Mail Bridge application must be actively running and authenticated on your local machine; the skill cannot start the bridge service itself.
• Self-Signed Certificates: Since the bridge uses local TLS, ensure your environment is prepared to handle self-signed certificates, which the send_email.py script is pre-configured to accommodate.
• Secret Hygiene: Never commit your .env or .age files to public version control systems. Always manage your age identities in a secure, backed-up location separate from your primary repository directory.