rvacyber/openclaw-protonmail-skill

ProtonMail Skill (v1.0.1)

Verwenden Sie ProtonMail für sichere E-Mails über die Proton Mail Bridge. Stabile Version – CLI wurde gegen eine live Proton Mail Bridge getestet.

Einrichtung (einmalig)

1. Proton Mail Bridge installieren:

   brew install --cask proton-mail-bridge
   

2. Bridge starten und anmelden:

   • Öffnen Sie die Proton Mail Bridge App
   • Melden Sie sich mit Ihren ProtonMail-Anmeldeinformationen an
   • Die Bridge generiert lokale IMAP/SMTP-Zugangsdaten

3. Skill konfigurieren: Fügen Sie Folgendes zu Ihrer OpenClaw-Konfiguration hinzu (~/.openclaw/openclaw.json):

   {
     "skills": {
       "entries": {
         "protonmail": {
           "enabled": true,
           "env": {
             "PROTONMAIL_ACCOUNT": "[email protected]",
             "PROTONMAIL_BRIDGE_PASSWORD": "bridge-generated-password"
           }
         }
       }
     }
   }
   

   Bridge-Zugangsdaten abrufen:

   • Klicken Sie in der Bridge auf Ihr Konto → Mailbox-Konfiguration
   • Kopieren Sie das IMAP-Passwort (NICHT Ihr ProtonMail-Passwort)
   • Verwenden Sie skills.entries.protonmail (nicht skills.protonmail)

CLI-Nutzung

Der Skill stellt ein protonmail-CLI-Tool bereit:

# Posteingang auflisten (die letzten 10 E-Mails)
protonmail list-inbox --limit=10 [--unread]

# E-Mails durchsuchen
protonmail search "from:[email protected]" --limit=20

# Bestimmte E-Mail lesen
protonmail read <uid>

# E-Mail senden
protonmail send [email protected] --subject="Meeting" --body="Bis 15 Uhr"

# Auf E-Mail antworten
protonmail reply <uid> --body="Klingt gut!"

Häufige Anfragen

• Posteingang auflisten: "Überprüfe meinen ProtonMail-Posteingang"
• E-Mails durchsuchen: "Suche in ProtonMail nach E-Mails von [email protected]"
• E-Mail lesen: "Lese ProtonMail-E-Mail mit UID 31"
• E-Mail senden: "Sende eine E-Mail über ProtonMail an [email protected] zum Projekt"
• Antworten: "Antworte auf ProtonMail-E-Mail mit UID 31"

Funktionsweise

1. Proton Mail Bridge läuft lokal und verbindet sich mit Ihrem ProtonMail-Konto
2. Die Bridge stellt lokale IMAP- (lesen) und SMTP-Server (senden) bereit
3. Dieser Skill verbindet sich mit den lokalen Servern der Bridge
4. Die gesamte Ver- und Entschlüsselung erfolgt lokal über die Bridge
5. Keine Drittanbieter-Dienste – direkte ProtonMail-Integration

Sicherheit

• ✅ Offizielle Proton-Software (auditiert, quelloffene Bridge)
• ✅ Ende-zu-Ende-Verschlüsselung bleibt erhalten
• ✅ Anmeldedaten werden nur lokal gespeichert
• ✅ Keine API-Schlüssel oder Tokens – Verwendung von Standard-IMAP/SMTP
• ✅ Bridge-Passwort ist getrennt von Ihrem ProtonMail-Passwort

Fehlerbehebung

Fehler "Verbindung abgelehnt"

• Überprüfen, ob die Bridge läuft: Öffnen Sie die Proton Mail Bridge App
• Ports überprüfen: Die Bridge sollte 127.0.0.1:1143 (IMAP) und 127.0.0.1:1025 (SMTP) anzeigen

Fehler "Authentifizierung fehlgeschlagen"

• Bridge-Passwort verwenden, nicht ProtonMail-Passwort: Holen Sie es über Bridge → Konto → Mailbox-Konfiguration
• Konto-E-Mail überprüfen: Muss exakt übereinstimmen (z.B. [email protected] oder [email protected])

Fehler "Skill nicht gefunden"

• Skill neu installieren: Führen Sie npm run install-skill im Skill-Verzeichnis aus
• OpenClaw-Konfiguration überprüfen: Stellen Sie sicher, dass skills.protonmail.enabled: true gesetzt ist

Entwicklung

Siehe README.md für die Einrichtung und Tests zur Entwicklung.

Lizenz

MIT – Siehe LICENSE