（12500期）outlook-delegate – 企业级邮箱委托管理助手

企业级邮箱委托管理助手 基于 Microsoft Graph API 的 Outlook 委托访问工具，支持 AI 助手以代理身份管理他人邮箱和日历，需显式授权且操作全程可审计。 使用说明 核心用法 Outlook Delegate Skill 是一款专为 Microsoft 365 环境设计的委托访问工具，允许 AI 助手在获得授权后以代理身份访问和管理指定用户的邮箱与日历。该技能采用 OAuth2 认证流程，助手使用自身账号登录，但通过 /users/{owner_email}} 端点访问所有者的资源，实现"代表发送"（Send-on-Behalf）的邮件发送模式。 核心功能涵盖六大模块：邮件读取（收件箱、未读邮件、搜索、按发件人筛选）、邮件管理（标记已读/未读、标记重要、删除、归档、移动文件夹）、邮件发送（代表所有者回复和新建邮件）、日历查询（今日/本周事件、可用性检查）、日程创建（快速创建和详细创建会议）以及令牌管理（刷新、测试连接、获取访问令牌）。所有操作均通过标准 Microsoft Graph API v1.0 完成，确保与企业级 Exchange Online 环境的无缝集成。 显著优点 企业级权限架构：采用委托权限（Delegated Permissions）而非应用程序权限，严格遵循最小权限原则。所需的 .Shared 后缀权限（如 Mail.ReadWrite.Shared）明确限定为共享访问场景，避免过度授权风险。 完整的审计追溯：所有代理操作自动记录在邮箱所有者的 Exchange 审计日志中，包括邮件读取、发送、日历修改等行为，满足企业合规要求。所有者可通过 Outlook 委托设置随时查看或撤销助手权限。 透明的身份标识：发送邮件时自动附加"Assistant on behalf of Owner"标识，收件人可清晰识别邮件实际发送者，避免身份混淆和潜在的社会工程学攻击。 详尽的文档支持：提供从 Azure AD 应用注册、Exchange 权限配置到 PowerShell 脚本的全流程指南，包含 8 类常见错误的排查方案，大幅降低部署门槛。 基于成熟开源项目：该技能是对 ClawHub 平台 jotamed 原创 Outlook 技能的改进版本（v1.3.0），继承其稳定性并新增委托访问能力，代码透明可追溯。 潜在缺点与局限性 复杂的部署前置条件：需要同时完成 Azure AD 应用注册、Exchange 管理员权限配置（或所有者手动委托设置）以及本地配置文件管理，对非技术用户门槛较高。任何环节配置错误都会导致 403 访问拒绝错误。 依赖企业级 Microsoft 365 环境：仅支持 Exchange Online 环境，不兼容个人版 Outlook.com 或本地 Exchange Server。需要组织具备 Azure AD Premium 或等效许可证才能完整使用委托功能。 令牌本地存储风险：OAuth 访问令牌和刷新令牌以明文形式存储在 ~/.outlook-mcp/credentials.json，虽建议设置 700 权限，但仍存在物理访问或备份泄露风险。缺乏内置的令牌加密或密钥管理服务集成。 功能边界受限于 Graph API：不支持某些高级 Outlook 功能，如邮件规则管理、外出自动回复配置、共享邮箱的完全代理发送（Send As 而非 Send on Behalf）等。日历操作依赖所有者的具体权限级别（Reviewer/Editor）。 无内置速率限制保护：文档未提及对 Microsoft Graph API 调用频率的限制处理，高频自动化场景可能触发 API 节流，导致服务中断。 适合的目标群体 企业高管与执行助理场景：CEO、VP 等高管配置专属 AI 助手管理日程和邮件筛选，助手以委托身份处理日常通信而不暴露高管的直接邮箱凭证。 共享服务团队：客户成功、人力资源等部门的共享邮箱管理，团队成员通过统一 AI 助手接口处理入站咨询，保持服务一致性并完整记录交互历史。 自动化工作流集成：需要将 Outlook 数据接入 RPA 或低代码平台的组织，通过该技能作为中间层实现邮件触发的工作流、自动会议安排等场景。 合规敏感型组织：金融、医疗、法律等行业需要严格审计追踪的场景，该技能的 Exchange 原生审计日志集成满足 SOX、HIPAA 等合规框架要求。 使用风险 权限升级风险：若 Exchange 管理员误配置 FullAccess 而非最小必要权限，或长期未审查委托设置，可能导致权限范围扩大。建议每季度审计 MailboxPermission 和 GrantSendOnBehalfTo 配置。 令牌泄露后果：本地存储的 credentials.json 若被窃取，攻击者可获得对授权邮箱的完整访问权限直至令牌过期（通常 1 小时）或刷新令牌被撤销。建议部署文件系统加密（如 BitLocker、FileVault）并监控该目录的异常访问。 配置信息暴露：config.json 包含 client_secret，若被提交至版本控制或备份至不安全位置，可能导致 Azure AD 应用被冒用。建议使用环境变量注入或 Azure Key Vault 替代本地明文存储。 API 变更兼容性：Microsoft Graph API 的更新可能破坏现有功能，特别是 /users/{id}} 端点的行为变更。建议订阅 Microsoft 365 消息中心更新，并在测试环境验证重大变更。 依赖项可用性：技能依赖 jq 和 curl 等系统工具，在精简容器环境或 Windows 非 WSL 环境中可能需要额外安装。脚本基于 Bash，跨平台兼容性有限。 原始说明 Read, search, and manage Outlook emails and calendar via Microsoft Graph API with delegate support. Supports sending as self, as owner (Send As), and on behalf of owner (Send on Behalf). Modified for delegate access from https://clawhub.ai/jotamed/outlook