Webmail 邮件监控器

在 Windows 上以本地后台进程方式运行此技能。

运行模式

将受支持的 Webmail 监控视为一个独立运行的自动化任务，而非绑定于当前对话轮次的浏览器会话。

默认执行以下操作：

• 使用命令 powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 start 启动监控器
• 提示用户：如需邮箱登录，必须在已打开的 Edge 窗口中完成
• 告知用户：监控器将在当前对话轮次结束后持续运行
• 若用户询问监控器是否正在运行，可执行 powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 status 或 powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 logs 进行检查

默认不执行以下操作：

• 通过无限延长当前对话轮次来强制保持 Outlook 浏览器窗口开启
• 将手动驱动邮箱登录页面作为主执行路径
• 除非用户明确要求停止，否则不得终止监控器

标准规则

只要任务逻辑可确定性地表达，就优先使用 Python 实现，而非依赖提示词（prompt）逻辑。

仅将提示文本用于流程编排、简短的用户交互说明，以及极少数真正需要语义理解的判断场景。

其余所有逻辑均应移入脚本中实现。

快速返回规则

当用户请求启动或启用监控时，不得阻塞当前对话轮次，等待邮箱登录、邮件打开、附件处理或 Excel 写入等操作完成。

请严格遵循以下成功路径：

1. 执行 powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 start
2. 执行 powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 status
3. 若返回状态为 running，立即返回响应

不得因以下任一情况阻塞响应：

• Gmail 或其他邮箱的登录流程完成
• 等待首次轮询周期结束
• 等待截图生成、附件下载或 Excel 写入完成
• 实时追踪日志（除非用户明确请求日志或故障排查）

Python 优先边界

以下行为必须实现在 Python 脚本中，而非通过提示词指令描述：

• 浏览器会话恢复与持久化用户配置文件复用
• 收件箱轮询、重试逻辑、超时处理及异常恢复
• 进程生命周期管理、PID 跟踪与运行时日志记录
• 邮件去重及已处理状态存储
• 已处理状态存储与 Excel 工作簿之间的状态一致性校验
• 邮件打开、正文内容提取、发件人/主题字段捕获
• 日期解析、设计师信息提取、款号（style-code）提取及其他固定字段规则
• Excel 工作簿创建、格式设置、逐行写入、图片嵌入及文件命名
• 整封邮件截图及截图路径管理
• 附件检测、下载处理、去重及桌面保存
• 在写入 Excel 前，对常见文件类型附件进行尽力而为的内容提取
• 任何可通过规则、正则表达式或显式条件判断实现的可重复转换逻辑

切勿将确定性的 Python 行为改写为技能内部的自然语言检查清单。

模型能力边界

仅对无法通过 Python 可靠实现的任务使用大模型判断，例如：

• 解析用户提出的模糊或歧义性请求语言
• 在固定规则不足以支撑时，从邮件中提取真实存在业务模糊性的含义
• 当确定性字段提取结果不足时，生成简短、可读性强的人工摘要

若某项行为可通过显式规则实现，请直接开发或更新对应 Python 脚本，而非扩展提示词内容。

必需输出行为

确保监控器生成以下本地产物：

• 桌面端工作簿：outlook_email_monitor.xlsx
• 桌面端截图文件夹：outlook_email_monitor_shots
• 下载的邮件附件，保存至桌面
• 运行时日志：runtime/monitor.log

确保工作簿的行结构与现有业务表格一致，列顺序如下：

• 创建日期
• 创建人
• 人工或独立请求类型
• 邮件主题
• 请求完成时间
• 内容摘要
• 关联图片
• 设计师
• 其他相关信息
• 修订备注
• 选定款号（style）

尽可能捕获邮件全文可见内容。若页面无法生成完整页面截图，则捕获当前可用的最完整备选截图，并继续后续处理流程。

只要邮件中存在可见附件，即应下载，并在工作簿中记录其文件名或相关备注。

附件下载完成后，使用 Python 读取其内容（如支持），并将该内容输入相同的确定性字段提取规则，再执行 Excel 行写入。若某类文件无法被稳定读取，仍需下载该文件、记录其文件名，并继续后续处理。

仅当 Excel 写入成功后，才将该邮件标记为“完全处理完毕”。若已存在已处理状态标记（如 processed.json 中记录），但工作簿中缺失对应行，则监控器必须重写该行，不可跳过。

在同一套工作流下支持 Outlook 及其他主流 Webmail 提供商。优先内置支持 Outlook、Gmail、QQ Mail、163 Mail、126 Mail 和 Yahoo Mail；在无法匹配时，尝试回退至通用浏览器邮件选择器。默认监控 Gmail，除非用户明确要求切换至其他邮箱。

启动

powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 start

首次启动后：

• 在已打开的 Edge 窗口或预置的邮箱标签页中完成邮箱登录
• 保留该 Edge 用户配置文件供后续运行复用
• CLI 将自动执行初始化步骤：安装缺失的 Python 依赖项，并刷新本地 webmail-monitor 命令别名（shim）
• 该初始化步骤还会检测本地是否已安装 Python 或 Microsoft Edge；若缺失，则尝试通过 winget 自动安装

复用性要求

为确保本技能可在不同机器间复用，请遵守以下规则：

• 所有执行逻辑均置于技能目录及其脚本中
• 避免在 SKILL.md 中硬编码机器特定路径
• 脚本中所有运行时路径均须相对于技能根目录解析
• 对外暴露统一的显式命令接口，当前为 webmail-monitor
• 若将技能复制到其他机器，请重建本地命令别名（shim），使 webmail-monitor 指向该机器上复制的技能目录
• 确保初始化步骤具备幂等性，以便 OpenClaw 在首次使用时安全执行

复用前提假设如下：

• Windows 系统且 PowerShell 可用
• 桌面路径（Desktop）具有写入权限，用于存放工作簿、截图及下载的附件
• OpenClaw 已配置扫描工作区 skills/ 目录
• 已安装 Python 和 Microsoft Edge；或主机允许通过 winget 自动安装

若任一前提缺失，应直接报告缺失项，不得伪装监控已成功启动。

OpenClaw 应依赖具备初始化能力的 CLI 脚本，从而在新机器上首次运行时自动完成依赖安装。

新机器上的初始化职责包括：

• 检测 Python 是否存在；若缺失，则自动安装
• 检测 Microsoft Edge 是否存在；若缺失，则自动安装
• 安装监控脚本所需的全部 Python 包
• 重建或更新本地 webmail-monitor 命令别名（shim）

若因 winget 不可用或受限导致自动主机安装失败，则应明确报错并提供手动安装 URL，不得假装机器已就绪。

停止

powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 stop

状态与日志

powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 bootstrap
powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 doctor
powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 status
powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 logs
webmail-monitor status
webmail-monitor logs

默认工作流

当用户请求启动监控时，请按以下流程执行：

1. 启动分离式（detached）监控器
2. 通过 powershell -ExecutionPolicy Bypass -File scripts/webmail_monitor_cli.ps1 status 确认监控已启动
3. 如需邮箱登录，提示用户在已打开的 Edge 窗口中完成
4. 当前对话轮次结束后，让后台进程持续运行
5. 仅当用户明确要求时，才停止监控器

响应模式

启动监控器后，应返回简洁的状态更新，包含以下要点：

• 后台监控器已成功启动
• Edge 可能会打开一个或多个邮箱标签页用于登录
• 登录操作只需在持久化的 Edge 用户配置文件窗口中完成一次
• 后续轮询将在当前对话轮次之外持续进行
• 详细进度信息属于 CLI 的 logs 命令范畴，不应纳入启动流程响应

停止监控器后，应确认后台进程已成功终止。

备注

• 启动器采用分离式设计，目的是防止 OpenClaw Agent 对话轮次结束时浏览器意外关闭
• 若邮箱再次提示登录，请在持久化 Edge 配置文件中完成一次登录，后续运行将复用该会话
• 当用户要求变更提取行为时，优先修改 Python 监控脚本，而非增加提示词描述
• 便携式调用路径为相对路径下的 CLI 脚本：scripts/ 目录内
• 推荐使用显式命令接口 webmail-monitor start|stop|restart|status|logs，而非直接调用脚本路径
• webmail-monitor start 应被视为“即发即返”（fire-and-return）动作，而非在对话轮次内长期运行的前台任务
• 若 processed.json 标记某封邮件已处理，但工作簿中无对应行，则视作可恢复的状态偏移（state drift），应重写该行