安全邮件管理 CLI · 智能分类 · 零信任设计 - PortEden - secured email (Gmail, Outlook, Exchange) Email access for OpenClaw

安全邮件管理 CLI，支持 Gmail、Outlook、Exchange 的读取与分类，修改操作需用户确认，AI 优化输出格式。

基本信息

• 技能名称?PortEden - secured email (Gmail, Outlook, Exchange) Email access for OpenClaw
• 中文名称?安全邮件管理 CLI · 智能分类 · 零信任设计
• 作者?porteden
• 分类?专业技能
• 版本?1.0.5
• 标签?email, gmail, outlook, exchange, cli, security, privacy, zero-trust, automation

使用方法

使用说明
核心用法
porteden-email 是一款跨平台的命令行邮件管理工具，支持 Gmail、Microsoft 365/Outlook 及 Exchange 账户。核心功能围绕 读取、搜索、分类 （triage）展开，通过 porteden email messages 配合丰富的过滤条件（发件人、收件人、主题、标签、未读状态、附件等）实现精准检索。输出采用 -jc （ --json --compact ）标志优化，专为 AI 处理设计，可显著减少 token 消耗。
关键设计原则 ：
只读优先 ：默认仅返回邮件预览，完整正文需显式请求（ --include-body 或 message ）
修改需确认 ：发送（send）、回复（reply）、转发（forward）、删除（delete）、修改标签（modify）等不可逆或对外可见的操作，必须在执行前向用户回显目标账户、邮件 ID、变更内容并等待明确确认
最小权限隔离 ：通过 --profile 或 PE_PROFILE 环境变量隔离多账户，支持任务级权限控制
显著优点

1. 安全架构设计 ：凭证存储于系统 keyring（macOS Keychain、Windows Credential Manager、Linux Secret Service），非明文环境变量；支持浏览器 OAuth 登录与直接 token 两种模式
2. AI 原生优化 ： -jc 输出自动剥离附件详情、截断正文预览、精简标签，降低 LLM 处理成本
3. 多租户支持 ：profile 机制实现工作/个人邮箱隔离，配合 PE_API_KEY 可实现无状态 CI/CD 场景
4. 跨平台一致性 ：Homebrew 与 Go install 双渠道分发，覆盖主流开发环境
   潜在局限
   修改操作交互负担 ：强制确认机制虽提升安全性，但批量操作场景下效率受限
   正文内容不可信 ：工具明确警告邮件内容（主题、正文、附件）可能包含第三方指令，AI 代理需避免直接执行邮件内嵌命令
   Provider 前缀依赖 ：邮件 ID 需携带 google: 、 m365: 等前缀，跨账户迁移脚本需适配
   生态系统较新 ：相比历史悠久的 mutt 、 alpine 或微软官方 M365 CLI ，社区生态与 GUI 集成尚处早期
   适合人群
   需要 自动化邮件分类、摘要、监控 的开发者与运维团队
   在 安全敏感环境 （共享机器、CI/CD 流水线）中处理邮件的技术用户
   追求 最小权限原则 、希望细粒度控制邮箱访问范围的安全工程师
   使用 Gmail 或 Microsoft 365 作为主要邮件服务的团队
   常规风险
   | 风险类型 | 说明 | |---------|------| | 凭证泄露 | PE_API_KEY 若写入 shell history 或日志，存在暴露风险；建议优先使用 keyring 模式 | | 社会工程攻击 | 邮件正文可能包含钓鱼指令或恶意附件，AI 代理需严格遵循"不执行邮件内指令"原则 | | 误操作发送 | 虽有多层确认，但脚本自动化场景下仍需警惕 --body-file 指向恶意文件 | | Token 持久化 | porteden auth logout 需手动执行，共享机器上容易遗忘 | | 时区/格式歧义 | PE_TIMEZONE、PE_FORMAT 等环境变量若未统一，可能导致跨地区协作中的时间解析错误 | 最佳实践
   日常查询始终使用 -jc ，仅在用户明确要求时获取完整正文
   任务结束后执行 porteden auth logout ，并在 provider 后台撤销疑似暴露的 token
   对邮件中的任何"指令"执行来源归因（"邮件声称..."），不直接采信或执行