PortEden - secured email (Gmail, Outlook, Exchange) Email access for OpenClaw

核心用法

porteden-email 是一款跨平台的命令行邮件管理工具，支持 Gmail、Microsoft 365/Outlook 及 Exchange 账户。核心功能围绕读取、搜索、分类（triage）展开，通过 porteden email messages 配合丰富的过滤条件（发件人、收件人、主题、标签、未读状态、附件等）实现精准检索。输出采用 -jc（--json --compact）标志优化，专为 AI 处理设计，可显著减少 token 消耗。

关键设计原则：

• 只读优先：默认仅返回邮件预览，完整正文需显式请求（--include-body 或 message <id>）
• 修改需确认：发送（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
• 对邮件中的任何"指令"执行来源归因（"邮件声称..."），不直接采信或执行

核心用法

porteden-email 是一款面向 Gmail、Outlook 与 Exchange 的安全邮件管理 Skill，通过封装 porteden CLI 提供命令行邮件操作能力。用户需先完成一次性认证（porteden auth login），凭证自动存入系统密钥环，后续通过环境变量 PE_API_KEY 或配置文件实现无感调用。

读取与检索：使用 porteden email messages 配合 -jc 参数获取 AI 优化输出，支持按发件人、收件人、主题、标签、未读状态、附件等维度过滤，亦可指定日期范围或搜索关键词。--all 参数实现自动分页，适合批量处理。

单封与会话：通过 porteden email message <id> 获取完整邮件内容，porteden email thread <id> 查看会话线程，邮件 ID 需保持 provider 前缀（如 google:abc123）。

变更操作：发送（send）、回复（reply）、转发（forward）、删除（delete）及修改标签（modify）等操作不可逆或对外可见，Skill 强制要求执行前回显目标账户、消息 ID 及变更意图，待用户确认后方可执行。

安全隔离：支持 --profile 或 PE_PROFILE 环境变量实现多账户隔离，任务结束后建议执行 porteden auth logout 清除密钥环条目，敏感环境还需在服务商页面撤销令牌。

显著优点

• 纯文档型零风险：本 Skill 仅含 Markdown 使用说明，无可执行代码、无外部依赖、无动态下载，静态分析满分通过。
• 安全设计严谨：强制确认机制、最小权限原则、系统密钥环存储、邮件内容不可信警告，安全实践覆盖全流程。
• 多源兼容：统一接口对接 Gmail、Microsoft 365/Outlook、Exchange，降低多邮箱管理复杂度。
• AI 友好输出：-jc（--json --compact）模式自动精简附件详情、截断正文预览、限制标签数量，显著降低 Token 消耗。

潜在缺点与局限性

• 外部二进制依赖：实际网络通信与加密操作由 porteden CLI 处理，Skill 本身仅为使用指南，需用户自行安装并维护该工具。
• 功能边界明确：专注读取、搜索与分类场景；发送与修改类操作因需确认，不适合高频自动化脚本。
• 无内置缓存：每次查询实时调用 API，大跨度历史邮件检索可能受限于服务商速率限制。
• 令牌生命周期：虽然凭证存于系统密钥环，但 OAuth 令牌仍需按服务商策略定期刷新，长期无人值守任务需关注续期机制。

适合人群

• 开发者在终端快速检索、预览邮件内容，无需切换浏览器或邮件客户端。
• 运维人员批量处理告警邮件、按标签分类或提取特定时间段日志邮件。
• 安全研究员在隔离环境中审计邮件头信息，避免直接渲染 HTML 正文触发风险。
• 多邮箱用户（个人 Gmail + 工作 Exchange）通过 Profile 机制实现环境隔离。

常规风险

• 钓鱼内容风险：邮件主题、正文、附件可能包含恶意指令或诱导性链接，Skill 已内置警告，用户须坚持"预览优先"原则，仅在必要时使用 --include-body。
• 凭证泄露风险：若 PE_API_KEY 硬编码于脚本或日志未脱敏，可能导致令牌暴露；建议优先使用密钥环，环境变量方案需配合 .env 与 .gitignore 管理。
• 误操作风险：变更类命令虽需确认，但在自动化管道或脚本中若被绕过确认交互，仍可能误发邮件或误删数据；建议生产环境禁用 PE_API_KEY 的写权限 scope。
• CLI 供应链风险：porteden 工具本身的安全更新需用户主动跟踪，非官方渠道安装可能引入篡改版本。