腾讯企业邮箱 Skill

通过 IMAP/SMTP 协议操作腾讯企业邮箱（exmail.qq.com），支持收发邮件、搜索、附件等完整功能。

📋 配置说明

在 OpenClaw 配置中设置以下环境变量：

CODEBLOCK0

注意：如果账号已绑定微信，请使用邮箱控制台生成的「客户端专用密码」（授权码），而非登录密码。

🔧 服务器参数（已内置，无需手动配置）

🚀 功能列表与使用方法

1. 发送邮件

用户指令示例：

• - "发送邮件给 zhang@company.com，主题：项目进展，内容：……"
• "给客户发一封带附件的邮件"

执行方式：调用 INLINECODE6

CODEBLOCK1

支持参数：

• - --to 收件人（多个用逗号分隔）
• INLINECODE8 抄送（可选）
• INLINECODE9 密送（可选）
• INLINECODE10 主题
• INLINECODE11 正文（支持纯文本和 HTML）
• INLINECODE12 发送 HTML 格式（flag）
• INLINECODE13 附件路径（可多次使用添加多个附件）

2. 查看收件箱

用户指令示例：

• - "查看我的收件箱"
• "显示最新 10 封邮件"
• "有什么未读邮件吗？"

执行方式：调用 INLINECODE14

CODEBLOCK2

3. 读取邮件详情

用户指令示例：

• - "打开第 3 封邮件"
• "读取邮件 ID 为 XX 的内容"

CODEBLOCK3

4. 搜索邮件

用户指令示例：

• - "搜索来自 boss@company.com 的邮件"
• "找主题包含「合同」的邮件"
• "搜索上周收到的邮件"

CODEBLOCK4

搜索语法支持（IMAP 标准）：

• - FROM "sender@example.com" — 按发件人
• INLINECODE16 — 按收件人
• INLINECODE17 — 按主题
• INLINECODE18 — 按正文
• INLINECODE19 — 按日期
• INLINECODE20 — 未读邮件
• INLINECODE21 — 已读邮件
• 组合：INLINECODE22

5. 下载附件

用户指令示例：

• - "下载邮件里的附件"
• "保存附件到桌面"

CODEBLOCK5

6. 查看其他文件夹

CODEBLOCK6

常见文件夹名称：INBOX、Sent Messages、Drafts、Deleted Messages、Junk

7. 标记已读 / 移动邮件

CODEBLOCK7

8. 实时监听新邮件（IMAP IDLE）

用户指令示例：

• - "实时监听我的邮箱"
• "有新邮件到了通知我"
• "后台监听邮件，保存到文件"

首次使用需安装依赖：
CODEBLOCK8

执行方式：调用 INLINECODE28

CODEBLOCK9

工作原理：

• - 使用 IMAP IDLE 协议——服务器主动推送，无轮询，响应延迟 < 1 秒
• 每 29 分钟自动重连（防止服务器 30 分钟超时断开）
• 断线自动重连，保持持续监听
• 新邮件信息写入 JSON 文件（最多保留最近 100 条）

JSON 输出格式（--hook-file 模式）：

[
  {
    "timestamp": "2025-03-17T10:23:45",
    "folder": "INBOX",
    "uid": 1234,
    "subject": "项目进展汇报",
    "from": "张三 <zhang@company.com>",
    "date": "Mon, 17 Mar 2025 10:23:40 +0800",
    "size_kb": 12.5,
    "is_unread": true
  }
]

📎 附件处理规范

• - 上传附件：用户提供本地文件路径，脚本自动 base64 编码
• 下载附件：自动解码保存到指定目录，默认 INLINECODE30
• 支持所有 MIME 类型（PDF、图片、Office 文档等）
• 单封邮件支持多个附件

⚠️ 错误处理

🔒 安全说明

• - 所有连接均使用 SSL/TLS 加密（IMAP:993, SMTP:465）
• 密码仅存储在本地 OpenClaw 配置中，不会上传
• 海外用户可改用 hwimap.exmail.qq.com / INLINECODE37

📚 参考文档

详细实现和故障排查请参阅：

• - references/server-config.md — 服务器参数完整说明
• INLINECODE39 — 常见问题解答