Exchange 邮箱与日程助手

解决什么问题

企业内部 Exchange 2010/2013 环境的邮件、日历、联系人、任务通常分散在 Outlook、OWA 等多个入口里。当需要让自动化流程——比如读取未读邮件、查询今天的会议、根据主题搜索日程——直接操作 Exchange 数据时，缺少一个统一、可编程的接口。这个技能通过 EWS（Exchange Web Services）把邮箱数据暴露成一组可调用的函数，让 Agent 能够像操作本地数据一样读取和管理 Exchange 中的各类对象。

它是怎么工作的

凭据自动配置是最大的使用门槛消除点。登录 EnnewClaw 时使用的密码会自动同步到 Exchange 配置中，首次使用邮箱功能时，系统还会通过 DWS 自动发现你的企业邮箱地址，全程不需要手动填写服务器地址或账号信息。

如果密码验证失败，会收到明确提示，提供正确密码后调用 update_exchange_password 即可更新配置并重试连接。

核心能力覆盖四类数据域：

• 邮件：读取未读邮件、按发件人或主题搜索、发送邮件、标记已读、浏览已发送/草稿/垃圾等文件夹
• 附件处理：下载附件并提取文本内容（PDF 需预先 pip install PyPDF2，TXT 原生支持）
• 日历：查看今日和未来 N 天事件、按时间范围查询、创建/更新/删除事件、识别并管理循环事件、访问共享日历
• 联系人与任务：搜索通讯录、通过 resolve_name 解析全局地址簿（GAL）中的名字；创建、完成、删除任务；读写外出留言（Out-of-Office）

搜索方面，subject__contains、start__gte 等 EWS Filters 走服务端过滤，比逐条遍历邮件更快。所有时间统一转换为 UTC 的 EWSDateTime，时区问题由框架处理。

适用边界与注意点

• 明确面向 Exchange 2010 SP2，更高级版本的兼容性未在资料中声明
• 对自己和共享邮箱均使用 DELEGATE 访问类型
• 全套共 28 个函数，包含凭据管理
• 该技能需要真实 Exchange 凭据并提供较宽泛的邮箱访问权限，建议使用最小权限账号；发送邮件或修改 Exchange 数据前应要求显式确认；附件下载应限制在安全目录并清理文件名；注意保护 .env.credentials 文件