M365 Mailbox (Graph) 是一个基于 Microsoft Graph API 的 Node.js 工具，专为自动化处理 Microsoft 365 邮箱任务而设计。它允许开发者通过脚本方式直接与 Outlook.com、Hotmail、Live.com 以及企业 Exchange Online 邮箱进行交互，无需依赖第三方邮件服务接口。该工具支持个人消费者账户和企业组织账户，采用设备代码认证流程（Device Code Flow），确保用户身份安全可控。所有访问令牌均本地存储于 OpenClaw 机器上的加密目录中，避免敏感信息泄露风险。 该技能的核心优势在于其灵活的权限管理机制和高度可定制的操作模式。在设置阶段，用户可选择请求最小必要权限集或更广泛的权限范围，并可自主定义 OpenClaw 在何种情况下需要人工确认才能执行操作。这种设计既保障了安全性，又兼顾了自动化效率。无论是读取未读邮件、搜索历史消息、创建草稿还是发送正式邮件，均可通过简洁的命令行调用完成，非常适合集成到自动化工作流或智能助手系统中。 值得注意的是，对于企业环境中的 M365 Business 账户，若普通用户缺乏应用注册或管理员授权权限，则需由 IT 部门预先配置好具备相应 Graph 权限的应用注册，并授予设备代码流访问许可。此时，系统将使用该 `clientId` 完成认证过程。而对于个人用户而言，则可直接使用自己的 Microsoft 账户登录，全程无需申请额外密钥或依赖外部服务。整体架构强调隐私保护、权限透明与操作可追溯性，适合对数据主权和自动化能力有较高要求的技术场景。
核心功能特点
- 支持 Microsoft 365 个人与企业邮箱账户，兼容 Outlook.com、Hotmail、Live.com 及 Exchange Online
- 基于 Microsoft Graph API 实现邮件读取、搜索、草拟、发送等核心功能
- 采用设备代码认证（Device Code Flow），无需第三方 API 密钥，保障用户身份安全
- 本地加密存储访问令牌，按用户配置文件隔离，防止敏感信息外泄
- 提供最小权限与宽泛权限两种授权模式，支持自定义自动化执行策略
- 命令行驱动，易于集成至脚本、定时任务或智能助手平台
适用场景
M365 Mailbox (Graph) 特别适用于需要将邮箱操作嵌入自动化流程的开发者和系统管理员。例如，在日常运维中，可通过脚本定期检查未读邮件并自动分类归档；在客户服务系统中，可设定规则自动回复常见问题或转发工单；在财务自动化场景中，能抓取发票邮件并提取关键信息导入 ERP 系统。这些应用场景都依赖于稳定、低延迟且符合企业合规要求的邮件处理能力。 对于依赖 Microsoft 365 生态的企业用户，尤其是那些希望减少手动邮件处理负担的团队，该工具提供了可编程的解决方案。即使没有管理员权限的普通员工，只要获得 IT 部门提供的已授权 `clientId`，即可安全地使用高级功能如发送邮件或修改草稿。而对于独立开发者或个人项目，使用个人 Outlook 账户即可快速上手，无需复杂配置。 此外，由于其基于标准 Node.js ESM 模块开发，具备良好的跨平台兼容性，可在 Windows、macOS 和 Linux 环境下运行。结合 OpenClaw 框架的上下文感知能力，它还能与其他技能协同工作，构建出更复杂的自动化助理系统。无论是轻量级邮件监控还是深度集成业务流程，M365 Mailbox (Graph) 都能提供灵活、安全且高效的支撑。