rvacyber/openclaw-protonmail-skill

Skill ProtonMail (v1.0.1)

Use o ProtonMail para e-mail seguro via Proton Mail Bridge. Versão estável — testada via CLI contra o Proton Mail Bridge em execução.

Configuração (uma vez)

1. Instale o Proton Mail Bridge:

   brew install --cask proton-mail-bridge
   

2. Inicie o Bridge e faça login:

   • Abra o aplicativo Proton Mail Bridge
   • Faça login com suas credenciais do ProtonMail
   • O Bridge gerará credenciais locais IMAP/SMTP

3. Configure o skill: Adicione ao seu arquivo de configuração do OpenClaw (~/.openclaw/openclaw.json):

   {
     "skills": {
       "entries": {
         "protonmail": {
           "enabled": true,
           "env": {
             "PROTONMAIL_ACCOUNT": "[email protected]",
             "PROTONMAIL_BRIDGE_PASSWORD": "senha-gerada-pelo-bridge"
           }
         }
       }
     }
   }
   

   Obtenha as credenciais do Bridge:

   • No Bridge, clique em sua conta → Configuração de caixa de correio
   • Copie a senha IMAP (NÃO a sua senha do ProtonMail)
   • Use skills.entries.protonmail (não skills.protonmail)

Uso via CLI

O skill fornece uma ferramenta CLI protonmail:

# Listar caixa de entrada (10 e-mails mais recentes)
protonmail list-inbox --limit=10 [--unread]

# Pesquisar e-mails
protonmail search "from:[email protected]" --limit=20

# Ler e-mail específico
protonmail read <uid>

# Enviar e-mail
protonmail send [email protected] --subject="Reunião" --body="Nos vemos às 15h"

# Responder e-mail
protonmail reply <uid> --body="Parece ótimo!"

Solicitações Comuns

• Listar caixa de entrada: "Verifique minha caixa de entrada do ProtonMail"
• Pesquisar e-mails: "Pesquise no ProtonMail por e-mails de [email protected]"
• Ler e-mail: "Leia o e-mail do ProtonMail com UID 31"
• Enviar e-mail: "Envie um e-mail via ProtonMail para [email protected] sobre o projeto"
• Responder: "Responda ao e-mail do ProtonMail com UID 31"

Como Funciona

1. O Proton Mail Bridge é executado localmente e se conecta à sua conta ProtonMail
2. O Bridge fornece servidores IMAP (leitura) e SMTP (envio) locais
3. Este skill se conecta aos servidores locais do Bridge
4. Toda a criptografia/descriptografia acontece localmente via Bridge
5. Sem serviços de terceiros — integração direta com ProtonMail

Segurança

• ✅ Software oficial da Proton (Bridge auditado e de código aberto)
• ✅ Criptografia ponta a ponta mantida
• ✅ Credenciais armazenadas apenas localmente
• ✅ Sem chaves de API ou tokens — usa IMAP/SMTP padrão
• ✅ A senha do Bridge é separada da sua senha do ProtonMail

Solução de Problemas

Erros "Conexão recusada"

• Verifique se o Bridge está em execução: Abra o aplicativo Proton Mail Bridge
• Verifique as portas: O Bridge deve mostrar 127.0.0.1:1143 (IMAP) e 127.0.0.1:1025 (SMTP)

"Falha na autenticação"

• Use a senha do Bridge, não a senha do ProtonMail: Obtenha em Bridge → Conta → Configuração de caixa de correio
• Verifique o e-mail da conta: Deve corresponder exatamente (ex.: [email protected] ou [email protected])

"Skill não encontrado"

• Reinstale o skill: Execute npm run install-skill no diretório do skill
• Verifique a configuração do OpenClaw: Certifique-se de que skills.protonmail.enabled: true

Desenvolvimento

Consulte README.md para configuração e testes de desenvolvimento.

Licença

MIT — Consulte LICENSE