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

核心用法

PortEden Email CLI 是一款跨平台的命令行邮件管理工具，支持 Gmail、Microsoft 365 (Outlook/Exchange) 等多账户统一管理。核心功能涵盖：

• 邮件检索：支持按时间范围（--today/--yesterday/--week/--days N）、发件人、收件人、主题、标签、未读状态、附件等维度筛选；全文搜索支持 -q 参数
• 邮件操作：读取单封邮件/线程、发送新邮件（支持 HTML/纯文本、重要性标记、抄送密送）、回复（含回复全部）、转发、修改状态（已读/未读、标签增删）、删除
• AI 优化输出：-jc 参数（--json --compact）自动精简附件详情、截断正文预览、限制标签数量，降低 Token 消耗

显著优点

1. 多提供商统一接口：Google Workspace 与 Microsoft 365 使用相同命令范式，无需学习不同 API
2. 安全凭证管理：浏览器 OAuth 登录或 API Key 认证，凭证持久化存储于系统 keyring（macOS Keychain/Windows Credential Manager/Linux Secret Service），避免明文暴露
3. 高效分页处理：--all 自动遍历分页，同时保留 hasMore/nextPageToken 供精细控制
4. 灵活的模板化发送：支持 --body-file 从文件读取正文，适合自动化邮件场景

潜在缺点与局限性

• 商业闭源软件：源码不可审计，依赖 PortEden 公司的安全实践与持续运营
• API 依赖性：功能受限于 Gmail/Microsoft Graph API 配额与速率限制，大规模企业迁移场景可能触限
• 无本地离线存储：纯云代理模式，网络中断时完全不可用
• 环境配置门槛：需安装独立二进制，相比原生 git send-email 或 mutt 增加依赖链

适合人群

• 开发运维人员：需要将邮件操作集成至 CI/CD、监控告警脚本
• 效率工具爱好者：偏好 CLI 工作流，厌倦多邮箱 Web 界面切换
• 自动化场景：定期邮件报告发送、基于邮件触发的工作流

常规风险

• 凭证泄露风险：PE_API_KEY 环境变量若写入 shell 历史或明文配置文件，存在泄露隐患；建议配合专用 secret 管理工具（如 1Password CLI、aws-vault）
• 误操作不可逆：delete 命令直接调用提供商 API 删除，无回收站二次确认机制；生产环境建议先 --dry-run 或备份
• 数据隐私：邮件内容经由 PortEden 服务中转（非直连 Google/Microsoft），需信任其数据处理政策与加密传输实践

核心用法

PortEden Email 是一款面向多账户邮件管理的 CLI 工具包装器 Skill，通过调用本地 porteden 命令行工具实现对 Gmail、Microsoft 365 (Outlook/Exchange) 等主流邮箱服务的统一操作。

核心功能覆盖：

• 查询检索：porteden email messages 支持按时间范围（--today/--yesterday/--week/--days N）、发件人、收件人、主题、标签、未读状态、附件等多维度筛选；-q 全文搜索；--after/--before 自定义日期范围
• 单件操作：message <id> 获取单封邮件详情，thread <id> 获取完整会话线程
• 发送管理：send 支持 HTML/纯文本、重要性标记、CC/BCC；reply/forward 支持回复、回复全部、转发并附加备注
• 状态管理：modify 实现标记已读/未读、添加/移除标签；delete 删除邮件

AI 优化特性：-jc 参数（--json --compact）专为 AI 场景设计，自动精简附件详情、截断正文预览、限制标签数量，大幅降低 token 消耗。

显著优点

1. 多提供商统一接口：单一 CLI 覆盖 Google Workspace 与 Microsoft 365 两大生态，无需切换不同管理后台
2. 系统级安全认证：采用浏览器 OAuth 登录或 API Token，凭据持久化存储于系统密钥环（macOS Keychain/Windows Credential/Linux Secret Service），避免重复授权
3. 高效批量操作：--all 自动分页拉取，配合 JSON 输出便于脚本化处理和 AI 解析
4. 环境变量灵活配置：PE_PROFILE 避免重复指定账户，PE_API_KEY 支持无登录场景

潜在缺点与局限性

1. 外部依赖必需：Skill 本身无可执行代码，完全依赖用户本地安装 porteden CLI，安装失败则功能不可用
2. 来源可信度限制：PortEden 为个人/社区项目（T3 等级），无大型企业背书，长期维护持续性存疑
3. 邮件 ID 提供商前缀要求：用户需正确识别 google:/m365: 前缀格式，误用可能导致操作失败
4. 功能边界限制：不支持邮件文件夹/邮箱级管理（如创建文件夹、设置自动转发规则），聚焦单邮件操作

适合人群

• 开发运维人员：需要通过脚本批量处理邮件、自动化报告生成
• AI 助手用户：希望 LLM 能直接查询邮件内容、起草回复并执行发送
• 多账户管理者：同时管理个人 Gmail 与企业 Outlook/Exchange 的高效用户
• 隐私敏感用户：偏好 CLI 工具而非 Web 界面，希望数据尽量本地化处理

常规风险

• Token 泄露风险：--token 参数在命令行中可能暴露于 shell history 或进程列表，建议在安全终端使用
• 误操作风险：发送、回复、转发、删除等操作不可逆，文档强调需人工确认
• 外部 CLI 供应链风险：brew install 或 go install 来源需验证，建议校验 checksum
• 数据权限范围：porteden CLI 需邮件读写权限，用户应理解 OAuth 授权范围