rvacyber/openclaw-protonmail-skill

ProtonMail 스킬 (v1.0.1)

Proton Mail Bridge를 통해 ProtonMail을 사용하여 안전한 이메일을 보내고 받습니다. 안정적인 릴리스이며, 실제 Proton Mail Bridge를 대상으로 CLI가 테스트되었습니다.

설정 (한 번만)

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="3시에 뵙겠습니다"

# 이메일에 회신
protonmail reply <uid> --body="좋아요!"

일반적인 요청

• 받은 편지함 목록: "ProtonMail 받은 편지함 확인해 줘"
• 이메일 검색: "ProtonMail에서 [email protected]이 보낸 이메일 검색해 줘"
• 이메일 읽기: "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 비밀번호와 별개

문제 해결

"Connection refused" 오류

• Bridge가 실행 중인지 확인: Proton Mail Bridge 앱을 엽니다.
• 포트 확인: Bridge는 127.0.0.1:1143 (IMAP) 및 127.0.0.1:1025 (SMTP)를 표시해야 합니다.

"Authentication failed" 오류

• ProtonMail 비밀번호가 아닌 Bridge 비밀번호 사용: Bridge → 계정 → 메일함 구성에서 가져옵니다.
• 계정 이메일 확인: 정확히 일치해야 합니다 (예: [email protected] 또는 [email protected]).

"Skill not found" 오류

• 스킬 재설치: 스킬 디렉토리에서 npm run install-skill을 실행합니다.
• OpenClaw 구성 확인: skills.protonmail.enabled: true가 설정되었는지 확인합니다.

개발

개발 설정 및 테스트는 README.md를 참조하세요.

라이선스

MIT — LICENSE 참조