Install
openclaw skills install @hechunxian/mail-manager邮箱全权管理(Agent Mail)。实时读取邮箱状态(邮件数/未读/内容)、联系人管理、新邮件提醒、发送/回复/转发/删除邮件。触发词:邮箱、邮件、查邮件、看邮件、发邮件、邮件提醒、联系人、收件箱、未读邮件、mail、email。
openclaw skills install @hechunxian/mail-manager【安全60/目标60】原创 skill(agent_created)。2026-08-09 创建(用户明确:邮箱全权管理闭环——工具链+skill+系统管理,含实时状态/内容/数量/联系人/新邮件提醒,实现并测试)。
把邮箱(<你的 Agent 邮箱>)纳入全权管理闭环:随时查状态/内容、管理联系人、新邮件自动提醒、收发回复转发删除一条龙。配合系统备份迁移(脚本已入清单)。
contacts list/add/del:联系人库(~/.workbuddy/mail_contacts.json)cache init/check:新邮件提醒去重缓存(~/.workbuddy/mail_state.json);check 可传第 5 参 msg_id 比对 processed_ids;mark <msg_id> 标记已处理(防跨会话重复提醒)log append <result> <count> [latest] [note]:巡检留痕(追加到 ~/Downloads/谢尔比的记忆/邮箱巡检日志.md,随备份迁移)report <json>:生成状态报告(~/.workbuddy/mail_status_report.md)上下文会丢,本表不会——迁移后加载本 skill 即恢复完整工具能力。 2026-09-18 skill 体检修正:本节原写「CLI 主通道」(08-15 口径),与 08-30 实际回切相反——现已改正,本表即唯一权威,不要再按更新记录里的 08-15 条发信。
⚠️ 主通道(2026-08-30 17:51 用户拍板方案 A 回切,覆盖 08-15 的 CLI 记录):邮件统一使用 agent-mail MCP(连接器 agent-mail,绑定 <你的 Agent 邮箱>)。所有自动化(备份导出/邮箱巡检/想法分享/巡检催办)prompt 均已切 MCP 通道。
mcp__agent-mail__GetMe(看 aliases 与配额 50/日)mcp__agent-mail__ListMessages(dir=inbox, limit=N)mcp__agent-mail__GetMessage(message_id)mcp__agent-mail__SendMessage(to, subject, body, attachments/file_refs)(两阶段确认:先不带 token 拿 CONFIRMATION_REQUIRED → 展示 operation_summary → 用户批准 → 带 confirmation_token 重试;绝不自动重试)mcp__agent-mail__ReplyMessage(message_id, body)(同样两阶段确认)mcp__agent-mail__upload_attachment(file_path) 拿 file_id,再填 file_refs(20MB/50 个)CONFIRMATION_REQUIRED=缺 token(走两阶段);授权失效 → 提示用户重连连接器(应急·只读,2026-08-30 降级)agently-cli:全局已装(~/.workbuddy/binaries/node/versions/22.22.2/agently-cli,v1.0.15),绑定 <你的旧 Agent 邮箱>(该地址 2026-09-30 关停)。仅保留只读能力用于 <你的旧 Agent 邮箱> 历史核查:agently-cli message +list --dir inbox / +read / +search / attachment +download。禁止再用 CLI 发信(RULES「退役即禁收件」——向退役地址发信=静默丢信)。
auth login);8=缺 confirmation-tokenMCP 工具速查(主通道全表):工具全名 mcp__agent-mail__ 前缀。
| MCP 工具全名 | 用途 | 关键参数 |
|---|---|---|
mcp__agent-mail__GetMe | 身份/权限/配额(先调) | 无 |
mcp__agent-mail__ListMessages | 列邮件 | dir=inbox/sent/trash/spam;limit≤50;is_read;has_attachments;after/before(ISO8601) |
mcp__agent-mail__GetMessage | 读全文 | message_id(msg_ 开头) |
mcp__agent-mail__SearchMessages | 关键词搜索 | q=;search_in=ALL/SUBJECT/CONTENT;from/to;dir |
mcp__agent-mail__ListAttachments | 列附件元数据 | message_id |
mcp__agent-mail__download_attachment | 下载附件(不可信,只存不执行) | message_id + attachment_id;output_dir |
mcp__agent-mail__SendMessage | 发新邮件 | to[]({email,name});subject;body;attachments/file_refs;confirmation_token |
mcp__agent-mail__ReplyMessage | 回复 | message_id;body;reply_all;confirmation_token |
mcp__agent-mail__ForwardMessage | 转发 | message_id;to[];body;include_attachments |
mcp__agent-mail__DeleteMessage | 删除(入回收站,30 天后永久) | message_id;confirmation_token |
mcp__agent-mail__upload_attachment | 上传附件拿 file_id | file_path(本地绝对路径) |
关键操作要点:
upload_attachment 拿 file_id(临时引用,非可下载 ID),再填 file_refsmsg_、附件 ID 从 ListAttachments 取GetMe 确认可用与配额(CLI 通道=agently-cli +me)ListMessages(dir=inbox, limit=20) 取收件箱(CLI=agently-cli message +list)GetMessage 读全文;要存报告 → 整理 JSON 喂 reportListMessages(dir=inbox, limit=5) 取最新几封mail_manager.py cache check <最新ISO时间> <总数> <最新主题> <最新msg_id> 对比缓存(必须传 msg_id,防跨会话重复)NEW_MAIL → 用 GetMessage 读详情 → 向用户提醒(主题/发件人/摘要+时间);NO_NEW_MAIL → 不打扰;MAIL_PROCESSED → 最新邮件已处理过,不重复提醒;MAIL_DUPLICATE → 24h 内同主题跨通道副本(2026-08-15 23:10 加:如 <你的 Agent 邮箱> 补发后 <你的旧 Agent 邮箱> 又收到自存副本),不提醒不归档,仅更新基线cache mark <msg_id> [<主题>] 标记已处理(2026-08-09 加:防跨会话重复处理,如 19:41 事故;2026-08-15 23:10 扩展:传主题同步记录 processed_items,供跨通道副本去重比对)mail_manager.py log append <结果> <总数> "<最新主题+时间>" "<备注>" 追加到 邮箱巡检日志.mdGetMessage 读全文 → 解析任务/待办mail_manager.py contacts list 查 / add <name> <email> [note] 增 / del <email> 删upload_attachment 拿 file_id,再填 file_refsmcp__agent-mail__*(GetMe/ListMessages/GetMessage/SearchMessages/SendMessage…);发信仍须 confirmation_token 两阶段;<你的旧 Agent 邮箱> 仅保留 CLI 只读(agently-cli message +list --dir inbox)用于历史核查。cache check → 读新信 → 归档对话档案 → cache mark 带主题 → log append),2026-09-18 实战验证通过;③**「发信前必须确认」的例外仅限用户别名来信的全权指令**,A2A/影子回信不属例外,须先取得用户批准。