mailbox

Mailbox CLI Skill 是 OpenClaw 平台针对邮件管理场景提供的命令行工具封装方案，通过调用外部 mailbox-cli 实现自动化邮件处理。该技能支持账户列表查询、邮件检索、内容预览、摘要生成、收件箱监控及邮件删除等核心功能，所有操作均返回结构化 JSON 数据，便于集成到自动化工作流中。

核心用法：用户需先通过 npm install -g mailbox-cli 安装依赖，并在 ~/.config/mailbox/auth.json 配置邮箱凭证。Skill 通过封装 CLI 命令提供标准化接口，支持 --json 输出格式以便程序解析。对于邮件删除等破坏性操作，默认启用 dry-run 模式，必须显式添加 --confirm 参数并指定 --account-id 方可执行，有效防止误操作。

显著优点：首先，纯 JSON 输出契约确保了与自动化系统的无缝集成，配合 success 和 error 字段的状态标识，便于错误处理和流程控制。其次，安全设计严谨，破坏性操作需多重确认，且支持 --dry-run 预览。此外，灵活的预览选项（--preview --no-html）允许快速获取邮件文本内容，适合处理大量邮件的场景。

潜在局限：该技能存在较高的使用门槛，要求用户具备 Node.js 环境配置能力和命令行操作经验。外部依赖较重，mailbox-cli 的版本兼容性、维护状态直接影响 Skill 可用性。同时，纯 CLI 交互模式缺乏图形界面，不适合需要可视化附件管理或富文本编辑的场景。凭证的本地存储（~/.config/mailbox/auth.json）若权限配置不当，存在敏感信息泄露风险。

适合群体：主要面向开发者、DevOps 工程师和系统管理员，适合需要将邮件处理集成到 CI/CD 流程、自动化脚本或定时任务中的技术用户。对于构建邮件机器人、自动归档系统、监控特定主题邮件的场景尤为适用。普通办公用户或依赖图形界面管理邮件的用户可能难以适应。

使用风险：除上述凭证管理风险外，用户在使用 --confirm 执行删除操作时需格外谨慎，避免误删重要邮件。网络不稳定可能导致邮件操作超时或失败，建议在自动化流程中实现重试机制。此外，作为纯文档型 Skill，其功能完全依赖外部 CLI 工具，若 upstream 工具 API 变更或停止维护，可能导致功能失效。