第三章：用 Halo 收发邮件
这一章教你让 Halo 里的数字人帮你收邮件、读邮件、发邮件、管理日历——就像给你配了一个 24 小时在线的邮件秘书。
重要提醒：邮件功能只能通过数字人使用，不能在普通聊天界面里操作。如果你还没有创建过数字人，请先完成第二章。
本章分为三大步骤：先配邮箱账号，再给数字人打开邮件开关，最后实际测试收发邮件。
3.1 邮件功能是怎么回事？
用一个生活里的场景理解
想象你有一位私人秘书，你把自己的邮箱账号和密码告诉了他。从此以后：
- 秘书可以打开你的邮箱，帮你看今天有哪些新邮件
- 可以帮你回复邮件、转发邮件
- 可以帮你搜索「上周王经理发的那份合同」
- 甚至可以帮你看日历上有哪些会议安排
Halo 的邮件功能就是这个逻辑：你把邮箱的登录信息填进 Halo 的设置里，然后告诉某个数字人「你可以用这个邮箱了」。之后，这个数字人就能像秘书一样帮你处理邮件。
两个必须知道的前提
在开始之前，有两件事你必须清楚：
| 前提 | 说明 |
|---|---|
| 邮件功能只在数字人里有效 | 在主页点 Halo 空间卡片进入的普通聊天里，AI 是没有邮件能力的。你必须创建一个数字人（第二章教过），才能让 AI 帮你处理邮件。 |
| 需要两步配置 | 第一步：在「设置」里填邮箱账号信息（相当于把钥匙交给大楼前台保管）。第二步：在数字人的设置里打开邮件开关（相当于告诉前台「这位员工可以用这把钥匙」）。 |
邮件功能能做什么？
配置完成后，数字人可以帮你做以下事情：
- 收邮件：列出收件箱里的邮件，阅读某一封邮件的完整内容
- 发邮件：发送新邮件、回复邮件、转发邮件
- 搜索邮件：按关键词、发件人、时间范围搜索
- 管理邮件：把邮件移到某个文件夹、标记已读/未读、删除邮件
- 看附件：读取邮件里的附件内容
- 日历管理（可选）：查看日历上的会议安排、创建新日历事项、删除日历事项
日历功能需要额外配置一个叫 CalDAV 的地址，属于进阶设置，本章 3.5 节会专门说明。如果你只需要收发邮件，可以跳过日历部分。
3.2 第一步：在设置里填写邮箱账号信息
这一步的目的是：把你的邮箱登录信息告诉 Halo，让 Halo 能连上你的邮箱。
打开设置页面
在 Halo 界面的顶部栏最右边，有一个看起来像齿轮形状的小图标 ⚙️。把鼠标移到上面，单击一下。
💡 不管你在主页还是聊天界面，右上角都有这个齿轮图标。
做完之后你会看到：整个页面切换到设置界面。顶部栏变成左边一个向左箭头 ← 加 Settings 文字，下方分为左右两栏——左边是设置菜单列表，右边是具体设置内容。
┌──────────────────────────────────────────────┐
│ ← Settings │
├────────────┬─────────────────────────────────┤
│ AI Model │ │
│ Message │ ← 右侧显示当前选中菜单的 │
│ App Store │ 设置内容 │
│ Appearance │ │
│ System │ │
│ Advanced │ │
│ Remote │ │
│ Recommend │ │
│ About │ │
└────────────┴─────────────────────────────────┘找到 Message Channels（消息通道）区域
进入设置页面后，往下滚动。你会看到一个区域，标题写着 Message Channels（消息通道）。
这个区域里列着好几张卡片，每张卡片代表一种消息渠道。你需要找到带有信封图标、名字叫 Email 的那张卡片。
┌─ Message Channels ───────────────────────┐
│ │
│ 📱 WeChat Bot [Bidirectional] │
│ 💬 WeCom Intelligent Bot [Bidirectional]│
│ ─────────────────────────────────────── │
│ ✉️ Email [One-way] │ ← 找到这个
│ 💬 WeCom [One-way] │
│ 🔔 DingTalk [One-way] │
│ 💬 Feishu [One-way] │
│ 🔗 Webhook [One-way] │
│ │
└──────────────────────────────────────────┘
↑ 上面两个是双向 IM 通道，下面五个是单向通知通道你会注意到 Email 卡片右侧显示 One-way（单向），并且状态显示 Not configured（未配置）。这是正常的——邮件通道的「单向」标签指的是它属于通知类通道分类，但实际配置完成后数字人是可以双向收发邮件的。
展开 Email 卡片
把鼠标移到 Email 那一行上，单击一下。
做完之后你会看到：Email 卡片向下展开，露出一系列需要填写的输入框。
打开启用开关
展开后的第一项是 Enabled（启用）开关。你会看到右边有一个椭圆形的小滑块。
把鼠标移到那个滑块上，单击一下。
做完之后你会看到：滑块从灰色变成了蓝色（或你的主题色），表示已经打开。
┌─ Email ──────────────────────────────────┐
│ │
│ Enabled [====●] │ ← 滑块变蓝 = 已打开
│ │
│ SMTP Host * [ smtp.example.com ] │
│ SMTP Port * [ 465 ] │
│ Use SSL/TLS [====●] │
│ Username * [ user@example.com ] │
│ Password * [ **************** ] │
│ Default Recipient * [ boss@company.com ]│
│ │
│ ▶ Advanced │ ← 点击可展开高级选项
│ │
│ [Test] │
│ │
└──────────────────────────────────────────┘逐个填写邮箱信息
现在你需要填写 6 个字段。带 红色星号 * 的是必填项。
字段 1：SMTP Host（发信服务器地址）
这个框里需要填你的邮箱的「发信服务器」地址。如果你不知道这是什么，参考下面的表格：
| 你用的邮箱 | SMTP Host 填什么 |
|---|---|
| 腾讯企业邮箱 | smtp.exmail.qq.com |
| 网易企业邮箱 | smtp.qiye.163.com |
| Gmail | smtp.gmail.com |
| Outlook / Exchange | 问你们公司的 IT 部门 |
| 其他邮箱 | 问你们公司的 IT 部门，或搜索「你的邮箱名 + SMTP 地址」 |
把鼠标点到 SMTP Host 右边的输入框里，输入对应的地址。
字段 2：SMTP Port（发信端口）
端口可以理解为「门牌号」——服务器有很多个门，你要告诉 Halo 从哪扇门进。
| 你用的邮箱 | SMTP Port 填什么 |
|---|---|
| 腾讯企业邮箱 | 465 |
| 网易企业邮箱 | 994 |
| Gmail | 465 |
| 大部分邮箱 | 465（优先试这个） |
默认已经填好了 465，如果你用的是腾讯企业邮或 Gmail，这个数字不用改。
字段 3：Use SSL/TLS（加密连接）
这是一个开关。SSL/TLS 是一种加密方式，可以理解为「给邮件传输加锁，防止被偷看」。
默认已经打开（滑块是蓝色的）。不要关掉它。
⚠️ 注意：几乎所有正规邮箱都需要开启 SSL/TLS。如果你关掉这个开关，邮件很可能发不出去。除非 IT 部门明确告诉你要关，否则不要动它。
字段 4：Username（用户名）
填你的完整邮箱地址，比如 zhangsan@company.com。
把鼠标点到 Username 右边的输入框里，输入你的邮箱地址。
字段 5：Password（密码）
这里要填的不一定是你登录邮箱的密码！很多邮箱需要填一种叫**「应用专用密码」或「授权码」**的东西。
| 你用的邮箱 | Password 填什么 |
|---|---|
| 腾讯企业邮箱 | 填「安全登录」里生成的客户端专用密码 |
| 网易企业邮箱 | 填邮箱设置里的授权码（不是登录密码） |
| Gmail | 填 Google 账号里生成的应用专用密码（App Password） |
| 其他邮箱 | 问你们公司的 IT 部门 |
⚠️ 注意：如果你直接填登录密码，大部分邮箱会报错「认证失败」。这是邮箱提供商的安全策略，不是 Halo 的问题。一定要确认用的是「应用专用密码」或「授权码」。
把鼠标点到 Password 右边的输入框里，输入密码（或授权码）。输入的内容会显示为圆点，这是正常的。
字段 6：Default Recipient（默认收件人）
这个框填一个默认的收件邮箱地址。当数字人需要发邮件但没指定收件人时，会发到这个地址。
通常填你自己的邮箱地址就好，比如 zhangsan@company.com。
关于自动保存
你可能注意到——填完这些信息后，界面上没有「保存」按钮。
这是因为 Halo 的通知通道设置采用自动保存机制：你每填完一个字段、鼠标离开那个输入框后，Halo 就会在后台自动保存你填的内容。
不需要找「保存」按钮，也不需要按回车键。填完就行了。
测试邮箱是否配置成功
填完所有信息后，在 Email 卡片的底部，你会看到一个蓝色的 Test（测试）按钮。
把鼠标移到 Test 按钮上，单击一下。
做完之后会出现两种情况：
情况一：测试成功 ✅
按钮旁边会出现一个绿色的对勾，旁边写着 Test passed。同时，你的 Default Recipient 邮箱会收到一封测试邮件。
恭喜你，邮箱配置成功了！可以直接跳到 3.3 继续下一步。
情况二：测试失败 ❌
按钮旁边会出现一个红色的叉号，旁边写着 Test failed，有时还会有一条错误提示。
别慌，请按照下面的排查清单逐项检查。
3.3 邮箱配置失败的排查清单
如果 Test 按钮显示 Test failed，按照下面的顺序一项一项检查：
Check 1：检查 SMTP Host 和 Port 是否正确
回到上面 3.2 节的表格，确认你填的地址和端口号跟你的邮箱类型对得上。
最常见的错误：
- 腾讯企业邮箱写成了
smtp.qq.com（这是个人 QQ 邮箱的地址），正确的是smtp.exmail.qq.com - 网易企业邮箱端口填了
465，但网易企业邮的端口是994
Check 2：检查密码是不是「应用专用密码」
直接填邮箱登录密码是最常见的失败原因。
请回到你的邮箱网页版设置里，查找「客户端专用密码」「授权码」「应用密码」等关键词，按邮箱的指引生成一个专用密码，然后回到 Halo 里替换 Password 字段的内容。
Check 3：检查 Use SSL/TLS 是否打开
如果你不小心关掉了加密开关，把它打开：找到 Use SSL/TLS 那一行的滑块，确认它是蓝色的。
Check 4：检查 Username 是否是完整邮箱地址
有些人只填了 zhangsan，少了 @company.com 部分。请确保填的是完整的邮箱地址。
Check 5：确认你的邮箱允许 IMAP/SMTP 外部访问
一些企业邮箱默认关闭了外部客户端登录权限。你需要：
- 登录你的邮箱网页版
- 找到「设置」→「POP3/IMAP/SMTP」（或类似名称）
- 把 IMAP 和 SMTP 的开关打开
- 如果你的邮箱有「安全设置」→「允许第三方客户端登录」，也要打开
如果你找不到这些选项，可以联系公司 IT 部门，告诉他们：「我需要通过 IMAP 和 SMTP 协议从第三方客户端访问我的邮箱，请帮我开通权限。」
Check 6：公司防火墙或网络限制
如果以上都确认无误还是连不上，可能是你的公司网络禁止了 465 或 994 端口的对外连接。这种情况需要联系 IT 部门。
修改完之后，记得重新点一下 Test 按钮验证。只有看到绿色的 Test passed 才说明配置成功。
3.4 第二步：给数字人打开邮件开关
配好邮箱账号后，你还需要告诉某个数字人「你现在可以使用邮件了」。这就像你已经配好了一把办公室钥匙，但还没有发给员工——现在要发给他。
打开数字人的设置页面
第一步：回到主页
如果你当前在聊天界面，点击顶部栏最左边的向左箭头 ‹，回到主页。
做完之后你会看到：Halo 的主页面，顶部栏左边显示 Logo 和「Halo」文字。
第二步：找到你的数字人
在主页上方，你会看到几个标签页。找到写着 Digital Humans 的那个标签，单击一下。
做完之后你会看到：下方出现你之前创建的数字人卡片列表。
第三步：点击你要配置的数字人
找到你想让它拥有邮件能力的那个数字人卡片，单击卡片上的名字或任意位置。
做完之后你会看到：屏幕右侧出现这个数字人的详情面板。
找到 Settings 标签
在数字人详情面板的上方，有几个标签：Chat、Activity、Settings。
找到写着 Settings 的那个标签，单击一下。
做完之后你会看到：面板内容变成了这个数字人的各种配置选项。
找到 Runtime 区域下的 Email 开关
往下滚动，找到标题写着 Runtime（运行时）的区域。在这个区域里，你会看到一个信封图标旁边写着 Email 的选项。
┌─ Runtime ────────────────────────────────┐
│ │
│ Model [选择模型 ▼] │
│ │
│ 🌐 AI Browser [ ○ ] │
│ ✉️ Email [ ○ ] │ ← 找到这个开关
│ 📤 IM Push [ ○ ] │
│ │
└──────────────────────────────────────────┘把鼠标移到 Email 右边的开关滑块上，单击一下。
做完之后你会看到：滑块从灰色变成蓝色，表示邮件功能已为这个数字人开启。
⚠️ 注意：如果 Email 那一行的文字是灰色的、开关点不动，说明你还没有在「设置」里配置邮箱账号（3.2 节）。开关下方通常会显示一行黄色提示文字 Email not configured. Go to Settings → Notification Channels to set up.（邮箱未配置，前往设置 → 消息通道进行配置），你可以直接点击这行文字跳转到设置页面完成配置。
关于自动保存
和邮箱账号配置一样，这里的开关也是自动保存的——你一点开关，Halo 就自动记住了。不需要找「保存」按钮。
3.5 进阶设置：日历功能（CalDAV）
如果你除了收发邮件，还想让数字人帮你管理日历（查看会议、创建日程），需要多配一个地址。
什么是 CalDAV
CalDAV 是日历服务的一种标准协议，就像 SMTP 是发邮件的协议一样。你的邮箱如果支持日历功能（比如 Google Calendar、Outlook 日历、iCloud 日历），它通常也支持 CalDAV。
在哪里填写 CalDAV 地址
回到设置 → Message Channels → Email 卡片（就是 3.2 节里配置邮箱的地方）。
在所有必填字段的下面，你会看到一行写着 ▶ Advanced（高级）的文字，前面有一个小三角形。
把鼠标移到 Advanced 上，单击一下。
做完之后你会看到：下面展开了额外的选项，其中有一个叫 CalDAV URL 的输入框。
┌─ Advanced ───────────────────────────────┐
│ │
│ CalDAV URL [ https://... ] │
│ TLS Ciphers [ Auto (system default)] │
│ │
│ CalDAV URL enables calendar tools. │
│ Supports {host} and {email} placeholders│
│ │
└──────────────────────────────────────────┘CalDAV URL 怎么填
不同邮箱的 CalDAV 地址不同：
| 邮箱类型 | CalDAV URL |
|---|---|
| Google Calendar | https://apidata.googleusercontent.com/caldav/v2/{email}/events |
| iCloud | https://caldav.icloud.com/ |
| Outlook 365 | 通常不直接支持 CalDAV，需要问 IT 部门 |
| 其他邮箱 | 搜索「你的邮箱名 + CalDAV 地址」，或问 IT 部门 |
地址里的
{email}是一个占位符，Halo 会自动替换成你在 Username 字段里填的邮箱地址。你不需要手动替换，直接复制粘贴上面的地址就行。
填完后，CalDAV 地址同样会自动保存。数字人就可以帮你查看和管理日历了。
关于 TLS Ciphers（加密算法）
Advanced 区域还有一个 TLS Ciphers 字段，默认显示 Auto (system default)。
不要修改这个字段。只有在极少数情况下（比如你的邮箱服务器用了非常老旧的加密方式），IT 部门才会让你填特定的值。正常使用完全不需要动它。
3.6 第三步：测试数字人收发邮件
配好邮箱账号（3.2 节）、打开数字人的邮件开关（3.4 节）之后，现在来验证数字人是不是真的能帮你处理邮件。
跟数字人对话
第一步：回到数字人详情页
如果你还在 Settings 标签页里，找到上方的 Chat 标签，单击一下。
做完之后你会看到：面板变成了对话界面，就像聊天一样，下方有一个输入框。
第二步：发一条测试消息
在下方的输入框里，输入以下内容（可以直接复制粘贴）：
请帮我检查收件箱，列出最近 5 封邮件的发件人和主题。然后按键盘上的 Enter 键（回车键）发送。
做完之后你会看到：数字人开始工作，几秒到十几秒后，它会列出你收件箱里最近 5 封邮件的信息。
如果你能看到邮件列表，说明收邮件功能正常。
第三步：测试发邮件
再输入一条消息：
请帮我发一封测试邮件给我自己，主题是「Halo 邮件测试」，内容写「这是一封通过 Halo 数字人发送的测试邮件。」按 Enter 发送。
做完之后你会看到：数字人会告诉你邮件已发送成功。过一会儿，去你的邮箱收件箱里检查，应该能看到这封测试邮件。
⚠️ 注意：数字人默认把邮件发到你在 3.2 节填的 Default Recipient（默认收件人）地址。如果你想发给其他人，在对话里直接说清楚收件人地址即可，比如「请发邮件给 wangming@company.com」。
3.7 通过企微机器人使用邮件功能
如果你已经配置了企微机器人（第一章），并且绑定了一个有邮件能力的数字人，那你还可以在企微里通过 @ 机器人来操作邮件——不用打开 Halo 软件也能用。
需要满足的条件
- 企微机器人已配置并连接成功（第一章完成）
- 机器人绑定的数字人已打开 Email 开关（本章 3.4 节完成）
- Permission Control 中的 Email 权限已开启（如果你开启了权限控制的话）
关于 Permission Control 中的 Email 权限
如果你在第一章 1.6 节中开启了 Permission Control（权限控制），默认情况下访客（Guest）是不能使用邮件功能的。
要让访客也能通过企微触发邮件操作，你需要：
- 打开设置 → Message Channels → WeCom Intelligent Bot → 展开你的机器人实例
- 找到 Permission Control 区域
- 确认已开启 Guest Access（访客权限）
- 在 Halo Capabilities（Halo 能力）区域，找到 Email 开关，打开它
┌─ Halo Capabilities ─────────────────────┐
│ │
│ AI Browser [ ○ ] │
│ Email [====●] │ ← 打开这个
│ Notifications [ ○ ] │
│ Digital Humans [ ○ ] │
│ File Send [ ○ ] │
│ │
└──────────────────────────────────────────┘⚠️ 注意：如果你是 Owner（管理者），你通过企微 @ 机器人操作邮件是不受这个限制的。这个 Email 权限开关只影响 Guest（访客）。关于 Owner 和 Guest 的区别，参考第一章 1.6 节。
在企微里试一下
打开企业微信，找到你的 AI 机器人（第一章里添加的），发一条消息：
帮我看看今天有没有新邮件如果一切正常，机器人会在几秒后回复你今天的新邮件摘要。
3.8 实用场景：提示词模板
以下是三个常见的邮件处理场景。你可以直接复制这些指令发给数字人（在 Halo 对话里或企微里都行）。
场景一：快速查看今天的邮件摘要
请帮我检查邮箱，把今天收到的所有邮件整理成一个表格，包含以下列：
- 发件人
- 主题
- 是否有附件
- 一句话摘要
按时间从新到旧排列。如果没有今天的新邮件，告诉我「今天暂无新邮件」。场景二：搜索特定邮件
请帮我搜索过去两周内，来自 wangming@company.com 的所有邮件。
列出每封邮件的日期、主题和一句话摘要。
如果有带附件的，在旁边标注「有附件」。场景三：批量回复确认收到
请帮我检查收件箱里今天未读的邮件。
对于每封邮件，帮我回复一句：「已收到，感谢！我会尽快处理。」
回复完后，告诉我一共回复了几封邮件、分别回复了谁。⚠️ 注意：让数字人批量回复邮件之前，请确保这是你真的想做的事。AI 发出去的邮件是真实邮件，对方会收到。发出去就不能撤回了。
3.9 如果你想让数字人定时处理邮件
第二章 2.4 节里的「模板 B：每日邮件摘要」就是一个典型的定时邮件处理场景。
具体做法：
- 创建一个数字人（第二章 2.3 节），把提示词写成邮件处理的指令
- 在数字人的 Schedule（运行计划）里设好时间，比如每天早上 8:30
- 确保数字人的 Email 开关已打开（本章 3.4 节）
这样，每天早上 8:30 数字人就会自动醒来、打开你的邮箱、执行你在提示词里写的操作。
如果你还想让数字人把邮件摘要发到你的企微上，还需要：
- 配好企微机器人（第一章）并绑定这个数字人
- 在数字人的提示词里加一句：「处理完后，把摘要通过通知发给我」
常见问题
Q1：在聊天里发消息说「帮我看邮件」，AI 说它没有邮件能力？
这是因为你在普通聊天里提问，而不是在数字人的对话里。
- 普通聊天（主页点 Halo 空间卡片进去的对话）= 临时工，没有邮件权限
- 数字人的 Chat 标签页里的对话 = 全职员工，可以有邮件权限
请确保你是在数字人的详情页 → Chat 标签页里发消息。
Q2：数字人说「email tools not available」或类似错误？
两个原因：
- 数字人的 Email 开关没打开 → 去 Settings 标签页 → Runtime → Email 打开
- 邮箱账号没配好 → 去设置 → Message Channels → Email 检查配置、点 Test 测试
Q3：Test 通过了，但数字人发邮件总是失败？
检查以下几点：
- 数字人的 Email 开关确认已打开（蓝色状态）
- 如果是通过企微操作的，检查 Permission Control 中 Email 权限是否开启
- 查看数字人的 Activity 标签页，里面会有详细的运行日志，可以看到具体的错误信息
Q4：能不能让数字人管理多个邮箱？
目前 Halo 只支持配置一个邮箱账号（在设置 → Email 通道里填的那个）。所有开启了邮件功能的数字人共用这一个邮箱。
如果你需要管理多个邮箱，目前需要在不同的场景下手动切换邮箱配置。
Q5：日历功能配好了，但数字人说找不到日历工具？
- 确认 CalDAV URL 填对了（3.5 节）
- 确认填的 URL 里没有多余的空格
- 有些邮箱的日历服务需要单独开通权限，请确认你的邮箱日历功能是正常可用的
Q6：我担心 AI 乱发邮件怎么办？
几个建议：
- 在数字人的提示词里明确写上限制条件，比如「发邮件之前必须先告诉我内容，等我确认后再发」
- 如果是定时任务，先手动测试几次确认行为符合预期，再设成自动运行
- 利用 Default Recipient 字段——如果你把默认收件人设成自己，即使 AI 误操作，邮件也只会发到你自己的邮箱
本章总结：邮件功能需要两步配置——先在设置里填邮箱信息（3.2 节），再在数字人里打开开关（3.4 节）。配好之后，可以在数字人对话里直接用自然语言操作邮件，也可以通过企微机器人远程操作。日历功能是可选的，需要额外配置 CalDAV 地址（3.5 节）。