给 AI 一个邮箱：AI Shell + QQ 邮箱 Agent 实战教程

本教程教你用华为云 AI Shell 体验 QQ 邮箱 Agent Mail，从安装配置到收发邮件、下载附件，跑通一个完整的 AI 邮箱自动化闭环。

📌 教程概览

一、为什么选 AI Shell + QQ 邮箱 Agent？

1.1 AI Shell 是什么？

华为云 AI Shell 是一个浏览器端对话式 AI 终端，把大模型能力和命令行环境融合在一起。你用自然语言下达指令，AI 自动理解意图、生成命令并执行——不需要你逐条手敲 CLI。
AI Shell官网：https://developer.huaweicloud.cn/aishell.html
一键直达AI Shell:https://devstation.connect.huaweicloud.cn/aishell

核心优势：

• 🚀 即开即用：浏览器打开就能用，无需本地安装环境
• 🤖 对话式操作：说"帮我查邮件"就行，不用记命令
• 🔗 终端 + AI 结合紧密：适合演示 Agent 如何通过 CLI 工具接入外部服务
• 🛡️ 沙箱隔离：操作在云端环境执行，不污染本地系统

1.2 QQ 邮箱 Agent Mail 是什么？

QQ 邮箱近期推出的 Agent Mail，是专门面向 AI Agent 的邮箱服务。可以理解为——给 AI 单独准备的工作邮箱。

核心特点：

• 📮 与个人邮箱隔离：AI 用的是专属邮箱，不碰你的私人邮件
• 📨 完整邮件能力：收发邮件、搜索邮件、下载附件
• 🤖 自然语言驱动：Agent 直接用自然语言操作邮箱
• ⚙️ 自动化工作流：支持邮件触发 → 处理 → 回复的自动流程
• 🔍 可追溯：后台可查看收发记录和授权状态

💡 一句话理解：AI Shell 是 AI 的"手"（终端执行），Agent Mail 是 AI 的"信箱"（邮件收发），两者组合 = 一个能自己收发邮件的 AI 助手。

二、开始前准备

2.1 你需要准备三样东西

2.2 安全建议

⚠️ 重要提醒：不要把个人主邮箱直接交给 AI！

Agent Mail 的设计初衷就是把 AI 邮箱和个人邮箱隔离开。请始终使用专属邮箱进行测试，这样即使 Agent 出现误操作，影响范围也可控。

三、在 AI Shell 里安装 Agently Mail CLI

3.1 进入终端模式

打开 AI Shell 后，确认你已进入可执行命令的终端模式。你应该能看到一个类似下方的界面：

┌──────────────────────────────────────────────┐
│  AI Shell  >  对话 / 终端                     │
├──────────────────────────────────────────────┤
│                                              │
│  user@ai-shell:~$ _                          │
│                                              │
│  [对话输入框] 请输入你的指令...              │
│                                              │
└──────────────────────────────────────────────┘

3.2 让 Agent 自动安装

在对话输入框中，直接对 AI Shell 说：

请阅读 https://agent.qq.com/doc/cli-setup.md 文档，
按照步骤为我安装并配置 Agent Mail CLI。

Agent 收到指令后会：

1. 拉取文档 — 自动访问 CLI 安装文档
2. 解析步骤 — 理解安装流程和依赖项
3. 执行安装 — 在终端中逐条运行安装命令
4. 处理依赖 — 自动解决环境依赖问题
5. 提示授权 — 安装完成后引导你进行扫码授权

你看到的终端输出大致如下：

# Agent 自动执行的过程
$ curl -sL https://agent.qq.com/install.sh | bash
  ↓ Downloading Agently Mail CLI...
  ✓ CLI installed to ~/.local/bin/agently-mail

$ agently-mail --version
  Agently Mail CLI v1.0.0

$ agently-mail config init
  → Initializing configuration...
  → Please scan QR code to authorize...

💡 这一步的重点：不是"你手敲多少命令"，而是观察 Agent 是否能完整自主地完成 CLI 接入。这正是 AI Shell 的价值所在。

四、扫码授权绑定

4.1 微信扫码

安装 CLI 后，Agent 会在终端中显示一个二维码：

┌─────────────────────────┐
│                         │
│    ██████████████████   │
│    ██              ██   │
│    ██   ▓▓▓▓▓▓▓▓   ██   │
│    ██   ▓▓▓▓▓▓▓▓   ██   │
│    ██   ▓▓▓▓▓▓▓▓   ██   │
│    ██              ██   │
│    ██████████████████   │
│                         │
│   请用微信扫码完成授权   │
└─────────────────────────┘

操作步骤：

1. 打开手机微信
2. 扫描终端中显示的二维码
3. 在手机上确认授权
4. 终端显示绑定成功

4.2 绑定成功确认

授权完成后，终端会显示：

✅ Authorization successful!
   Email: agent-xxxxx@qq.com
   Status: Connected
   Quota: 100 emails/day (trial)

You can now use natural language to operate your mailbox.

4.3 这一步意味着什么？

完成后，你可以在 Agent Mail 后台查看收发记录和授权状态，便于追踪 Agent 做了什么。

五、第一次实战：让 AI 收发邮件

5.1 从低风险任务开始

🟢 建议：先让 Agent 搜索邮件，不要一上来就发信。

任务 ①：查看最近收到的邮件

你对 AI Shell 说：

查一下最近收到的邮件

Agent 执行并返回：

📋 最近 5 封邮件：

1. 【发件人】noreply@github.com
   【主题】Your weekly digest
   【时间】2026-06-28 09:12
   【摘要】本周 GitHub 活动汇总：3 个 PR 合并，2 个 Issue 关闭...

2. 【发件人】invoice@example.com
   【主题】六月发票 - 订单 #2024-0615
   【时间】2026-06-27 16:30
   【摘要】附件包含六月电子发票 PDF...

3. 【发件人】hr@company.com
   【主题】简历投递回复 - 面试邀请
   【时间】2026-06-27 10:05
   【摘要】已收到简历，邀请 6 月 30 日面试...

...

任务 ②：搜索特定邮件

你对 AI Shell 说：

找出上周和项目有关的邮件

Agent 执行并返回：

🔍 搜索关键词：项目 | 时间范围：上周

找到 3 封相关邮件：

1. 【主题】项目周报 - 第 26 周
   【发件人】pm@team.com | 2026-06-23
   【关键信息】本周完成 5 个任务，下周计划 3 个里程碑...

2. 【主题】Re: 项目架构评审反馈
   【发件人】architect@team.com | 2026-06-24
   【关键信息】架构方案 v2 已更新，请 review...

3. 【主题】项目预算审批通过
   【发件人】finance@company.com | 2026-06-25
   【关键信息】Q3 预算已批准，总额 ¥120,000...

任务 ③：下载附件

你对 AI Shell 说：

下载第一封邮件里的附件

Agent 执行并返回：

→ 正在获取邮件附件...
→ 邮件: 【六月发票 - 订单 #2024-0615】
→ 附件: invoice_2024_06.pdf (245KB)

✅ 下载完成！
   保存路径: ~/downloads/invoice_2024_06.pdf
   文件大小: 245 KB
   MD5: a3f5e8b2c1d4...

任务 ④：发送测试邮件

🟡 注意：先发给自己的测试地址，确认格式、主题和签名都正常。

你对 AI Shell 说：

帮我发一封邮件给 test@example.com，
主题是"AI Agent 测试邮件"，
内容写"这是一封由 AI Agent 自动发送的测试邮件，请忽略。"

Agent 执行并返回：

→ 正在发送邮件...
   收件人: test@example.com
   主题: AI Agent 测试邮件
   正文: 这是一封由 AI Agent 自动发送的测试邮件，请忽略。

✅ 发送成功！
   邮件 ID: agent-mail-20260628-001
   发送时间: 2026-06-28 14:32:05

六、进阶：邮件自动化工作流

当你熟悉了基本操作，可以尝试让 Agent 执行多步骤工作流：

6.1 邮件摘要助手

帮我整理今天的邮件：
1. 搜索今天收到的所有邮件
2. 按重要程度分类（工作/通知/广告）
3. 生成一份摘要报告

Agent 返回示例：

📊 今日邮件摘要报告 (2026-06-28)
═══════════════════════════════════

📌 工作邮件 (3 封)
  ├─ 项目周报已提交，等待 review
  ├─ 客户反馈：产品 v2 建议增加导出功能
  └─ 架构评审通过，可进入开发阶段

🔔 通知邮件 (2 封)
  ├─ GitHub: 3 个 PR 待合并
  └─ 系统监控: 服务器 CPU 使用率正常

📢 广告邮件 (1 封)
  └─ 云服务促销：新用户优惠（可忽略）

⏱️ 需要处理: 2 封（项目周报 review + 客户回复）

6.2 自动回复流程

检查是否有来自 hr@company.com 的邮件，
如果有面试邀请，帮我回复确认参加，
并在我日历上标记面试时间。

6.3 附件批量归档

搜索所有包含发票附件的邮件，
把附件按月份下载到 ~/invoices/ 目录，
并生成一份文件清单。

七、适合展示的实战场景

八、风险与安全建议

8.1 两条核心原则

🔴 原则一：不要把个人邮箱直接交给 AI

Agently Mail 的设计初衷就是把 AI 邮箱和个人邮箱隔离开。个人邮箱包含大量隐私信息（银行账单、私人通信、密码重置链接等），直接交给 AI 会带来隐私泄露和越权风险。

🟡 原则二：先确认再执行

第一次演示尽量使用低权限、低风险的测试邮箱。所有涉及发送、删除、转发的操作，建议先让 Agent 展示意图，确认后再执行。

8.2 安全检查清单

• 使用 Agently Mail 专属邮箱，而非个人邮箱
• 测试环境与生产环境隔离
• 发送邮件前确认收件人和内容
• 定期检查 Agently Mail 后台操作日志
• 敏感操作（删除、转发）设置二次确认
• 不在公开代码仓库中暴露邮箱配置信息

九、总结

我们做了什么

通过本教程，你完成了一个 AI 邮箱助手的最小可用闭环：

安装 CLI → 扫码授权 → 查邮件 → 搜邮件 → 下附件 → 发邮件 → 自动化工作流

核心收获

1. AI Shell 不只是终端，而是一个可以执行邮箱任务的 Agent 工作台
2. Agently Mail 不只是邮箱，而是专为 AI 设计的自动化邮件接口
3. 自然语言驱动，从"敲命令"到"说需求"，交互方式发生了质变
4. 安全隔离，AI 邮箱与个人邮箱分开，风险可控

下一步探索

• 🔗 结合定时任务，实现每日邮件自动摘要推送
• 📊 接入更多数据源，做邮件 + 日历 + 文档的联动
• 🤖 搭建多 Agent 协作流程，让不同 Agent 处理不同类型邮件