这一整组里最快的一条路。不用管理员、不用申请任何权限，唯一会稳定出错的， 是 Google 自己页面上的一处复选框。
这份指南适用于*“任何属于您的单用户收件箱 — 可以是个人的 @gmail.com，
也可以是 you@your-company.com 这样的 Google Workspace 邮箱。”*如果这个
地址有好几个人在回信，你该看的是共享收件箱
或 Google 群组。
页面
渠道 → 添加渠道 → 电子邮件 → /channels/email/new。
| 页面 | 页面上写什么 |
|---|---|
| 连接一个邮箱 | “Omni Octo 连接到您的 Gmail 或 Outlook 邮箱，以读取并回复邮件。” |
| 连接一个 Gmail 邮箱 | “通过 Google 的授权页面授权 Omni Octo。” |
| Google 的授权页面 | Google 自己的页面 —— 见下文 |
| 验证邮箱设置 | “往返发送一条测试消息，确认入站和出站投递均正常。” |
| 完成邮箱设置 | “选择一个智能体、默认回复模式和签名。” |
只有 Gmail 流程会有最后那个页面。Microsoft 的流程没有 —— 它们在更早的步骤就 收齐了同样的字段 —— 所以如果你之前连接过 Outlook 邮箱，会发现这里多出一个 步骤，这是正常的。
那个坏事复选框
Google 不会整批授予权限。它把每项权限做成可以单独勾选的方框，而且默认都不 勾，向导会在你走到那一步之前先警告你：
Google 会询问您要授予哪些权限。Omni Octo 需要 Gmail 的两项权限，才能 读取入站邮件并代您回复。请在点击「继续」之前点击「全选」（或逐个勾选 两个复选框）。
它也说了不这么做的下场：
如果您漏勾任何一个复选框，收发都无法工作，您将不得不重做这个流程。
这是 Gmail 这条路上最常见的单一失败原因，而且它坏得无声无息 —— 连接看起来 成功了，然后要么什么都收不到，要么什么都发不出去。两个都勾。
这两项权限各是什么
| 范围 | 涵盖什么 |
|---|---|
gmail.modify | 读取你的邮件、写草稿、改标签，以及发信 |
gmail.settings.basic | 读取你的签名和基本邮箱设置 |
两个大范围权限，而不是一长串窄权限 —— Google 的 API 就是这个形状。
gmail.modify 包含发送，所以从你连上的那一刻起，发送权限就已经存在。决定
东西会不会自己发出去的是回复模式，而草稿模式会把所有东西先扣住等批准。
验证的往返
验证步骤会让邮箱寄一封信给自己。它一次同时证明了收信和发信，重点就在 这里 —— 一个少勾了方框的授权页面能通过登录，却会在这里失败。
如果信没有回来，向导会直接点出常见原因，而不是耸耸肩：
这通常表示 Pub/Sub 推送订阅配置不正确 — 请查看运维手册，或联系支持团队。
这是我们这边的基础设施故障，不是你点错了什么。
它不会做的事
**它不会导入你现有的邮件。**监看从连接那一刻才开始。
**它只监看收件箱。**Gmail 的监看明确只挂在 INBOX 标签上。跳过收件箱的
邮件 —— 直接被筛进某个标签，或一进来就归档 —— 都看不到。如果你的过滤规则
很激进，请确认你期望 AI 处理的邮件真的会落到收件箱里。
**你自己从 Gmail 寄出的回复不会算成已回复。**平台只认从它本身寄出的回复。 你在手机上从 Gmail 回了一串信，这边仍可能显示为等待中。