rvacyber/openclaw-protonmail-skill

ProtonMail スキル (v1.0.1)

Proton Mail Bridge 経由で、安全な電子メールに ProtonMail を使用します。安定版リリース — CLI で実際の Proton Mail Bridge に対してテスト済みです。

セットアップ（一度だけ）

1. Proton Mail Bridge をインストールする:

   brew install --cask proton-mail-bridge
   

2. Bridge を起動してログインする:

   • Proton Mail Bridge アプリを開く
   • ProtonMail の認証情報でログインする
   • Bridge がローカルの IMAP/SMTP 認証情報を生成します

3. スキルを設定する: OpenClaw 設定ファイル（~/.openclaw/openclaw.json）に次の内容を追加します:

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

   Bridge 認証情報を取得する:

   • Bridge で、アカウント → メールボックス設定 をクリック
   • IMAP パスワードをコピーします（ProtonMail パスワードではありません）
   • skills.entries.protonmail を使用します（skills.protonmail ではありません）

CLI の使用方法

このスキルは protonmail CLI ツールを提供します:

# 受信トレイを表示（最新10件）
protonmail list-inbox --limit=10 [--unread]

# メールを検索
protonmail search "from:[email protected]" --limit=20

# 特定のメールを読む
protonmail read <uid>

# メールを送信
protonmail send [email protected] --subject="会議" --body="15時に会いましょう"

# メールに返信
protonmail reply <uid> --body="了解しました！"

よくあるリクエスト

• 受信トレイを表示: 「ProtonMail の受信トレイを確認して」
• メールを検索: 「[email protected] からのメールを ProtonMail で検索して」
• メールを読む: 「ProtonMail のメール UID 31 を読んで」
• メールを送信: 「ProtonMail 経由で [email protected] にプロジェクトについてのメールを送って」
• 返信: 「ProtonMail のメール UID 31 に返信して」

動作の仕組み

1. Proton Mail Bridge がローカルで実行され、ProtonMail アカウントに接続します
2. Bridge はローカルの IMAP（読み取り用）と SMTP（送信用）サーバーを提供します
3. このスキルは Bridge のローカルサーバーに接続します
4. すべての暗号化/復号化は Bridge 経由でローカルで行われます
5. サードパーティサービスは不要 — ProtonMail との直接統合です

セキュリティ

• ✅ 公式の Proton ソフトウェア（監査済み、オープンソースの Bridge）
• ✅ エンドツーエンド暗号化が維持されます
• ✅ 認証情報はローカルにのみ保存されます
• ✅ API キーやトークン不要 — 標準の IMAP/SMTP を使用
• ✅ Bridge パスワードは ProtonMail パスワードとは別です

トラブルシューティング

「接続が拒否されました」エラー

• Bridge が実行中か確認: Proton Mail Bridge アプリを開く
• ポートを確認: Bridge に 127.0.0.1:1143（IMAP）および 127.0.0.1:1025（SMTP）が表示されていることを確認

「認証に失敗しました」

• ProtonMail パスワードではなく Bridge パスワードを使用: Bridge → アカウント → メールボックス設定 から取得
• アカウントメールを確認: 正確に一致している必要があります（例：[email protected] または [email protected]）

「スキルが見つかりません」

• スキルを再インストール: スキルディレクトリで npm run install-skill を実行
• OpenClaw 設定を確認: skills.protonmail.enabled: true が設定されていることを確認

開発

開発環境のセットアップとテストについては、README.md を参照してください。

ライセンス

MIT — LICENSE を参照