AI 助手连接 Gmail 设置指南

先确认要连接的邮箱

AI 助手连接 Gmail 的第一步不是输入密码，而是确认要连接哪一个邮箱。Gmail 在 Gmail 应用里能正常收发，不代表另一个 AI 助手已经拥有可用的邮件账号配置。FoneClaw 处理邮件任务时，需要知道明确的邮箱地址、账号类型和连接方式；如果设备里已有多个邮件账号，必须核对完整地址，而不是默认选择第一个看起来相似的账号。

可以先用一句简单请求开始：“检查是否已经配置了 name@gmail.com 这个邮箱。”如果 FoneClaw 找到多个接近的账号，先看完整邮箱地址和用途，再选正确的一个。个人 Gmail、学校邮箱、公司 Google Workspace 邮箱和自定义域名邮箱的连接规则可能不同。一个地址以 Gmail 使用习惯登录，并不一定代表它应该套用个人 Gmail 的全部设置。

对于一个明确的 Gmail 地址，如果当前没有已配置匹配项，FoneClaw 可以给出账号设置所需的非密信息，例如服务类型、收件和发件服务器方向，以及准备凭据的官方帮助入口。这个阶段不需要把 Google 主密码、应用专用密码或任何一次性显示的密钥写进公开或共享聊天、日志、工单截图或共享文档里。先把邮箱身份确认清楚，后面的凭据和服务器设置才有意义。

按 Google 指引准备可用凭据

为什么 Google 账号密码无法连接？很多情况下，原因是普通 Google 密码不是第三方 IMAP/SMTP 客户端应该使用的凭据。Google 关于应用专用密码的帮助说明建议在支持时优先使用“通过 Google 登录”；当某个邮件客户端需要传统收件和发件协议时，符合条件的账号可以创建应用专用密码。应用专用密码是给某个应用使用的独立密钥，不是你的 Google 主密码。

准备 Gmail 应用专用密码时，先确认 Google 账号已开启两步验证。进入 Google 账号安全设置，找到应用专用密码相关入口，为这个 Android AI 助手或邮件连接创建一个容易识别的名称。Google 只会显示一次生成结果；生成后把它用于当前账号设置，不要把它发到公开或共享聊天、日志、工单截图或共享文档里。

为什么看不到应用专用密码选项？Google 说明里列出几类常见原因：账号没有开启两步验证、只使用安全密钥登录、启用了高级保护，或账号由组织管理。学校和公司 Google Workspace 账号还可能由管理员控制 IMAP、应用专用密码和第三方客户端策略。遇到组织限制时，正确做法是询问管理员当前允许的连接方式，而不是关闭两步验证或改用主密码。

FoneClaw 的当前 Gmail 设置流程面向可用凭据和完整连接检查。用户准备好账号对应的凭据后，再让 FoneClaw 验证并保存配置。这样可以把“凭据是否符合 Google 要求”和“邮箱收发连接是否成功”分开判断，排错时不会把所有问题都归成一个密码错误。

一起核对收件和发件设置

IMAP/SMTP 设置要成对核对。IMAP 负责读取邮件，SMTP 负责发出邮件；只配对其中一边，后续任务就可能出现“能看列表，不能发信”或“验证发件失败”的情况。Google 关于个人 Gmail 第三方客户端的说明已经更新：个人 Gmail 的 IMAP 保持开启，不再让用户寻找旧的“启用 IMAP”开关。公司或学校账号仍要按组织策略确认。

Google Workspace 第三方邮件客户端设置说明列出的 Gmail 主机名包括 imap.gmail.com 和 smtp.gmail.com，常见组合是加密 IMAP 端口 993，以及 SMTP 的 STARTTLS 端口 587 或 SSL 端口 465。实际保存时，应使用当前账号设置流程返回的完整预设，不要把端口和加密方式随意混搭。

如果邮箱是自定义域名，即使背后使用 Google 服务，也不要自动套用个人 Gmail 预设。先确认它是普通 Gmail、Google Workspace，还是另一个邮箱服务商。FoneClaw 在设置中会围绕明确账号保留对应配置，用户需要核对的是“这个配置是否属于我要连接的邮箱”。

批准验证并确认保存结果

账号、服务器和凭据准备好以后，再批准 FoneClaw 执行账号验证和保存。FoneClaw 当前的 Gmail 设置流程会先同时检查收件连接和发件连接；两边都通过后，才把这个邮箱作为可用配置保存。这个步骤需要用户批准，因为它会把一个真实邮箱接入后续邮件任务。

连接验证成功会发送测试邮件吗？不会。收件连接成功说明可以访问邮箱列表或邮件内容；发件连接成功说明 SMTP 登录和连接可用；这两件事都不证明某一封邮件已经送达收件人。如果你需要发送自测邮件，应另行提出明确请求，并在发送前核对收件人、主题、正文和附件；真正发送邮件是单独的外部动作，需要独立审批。

保存成功后，建议先做一个小验证：让 FoneClaw 列出这个账号最近几封邮件的摘要或标题，确认显示的是正确邮箱。读取完整邮件和发送邮件是后续单独动作；FoneClaw 读取某封邮件全文会在服务器上标记为已读，发送邮件则会产生外部通信结果。邮件整理、摘要、跟进和日历安排的使用方式，可以继续看安卓 AI 邮件助手怎么选：Gmail、Outlook 与 FoneClaw 邮件到日历工作流。

按失败层级排查 Gmail 连接

Gmail 连接失败时，不要反复提交同一套设置。先确认失败发生在哪一层：账号选错、凭据被拒、收件失败、发件失败、组织策略限制，还是网络不可达。排查信息只需要非密内容，例如错误提示的概括、失败协议、发生时间、服务器主机名、端口、加密方式和邮箱类型；不要提供应用专用密码或 Google 主密码。

修改 Google 密码后为什么连接失效？Google 的应用专用密码会在主密码变更后被撤销，所以原来的 IMAP/SMTP 凭据会停止工作。处理方式是为这个连接生成新的应用专用密码，再更新到正确的邮箱配置里。一次成功的收件连接不能证明当前发件连接也健康；修正一个原因后，仍要重新验证收件和发件两边。

如果问题不在 Gmail，而在 Android AI 助手的具体执行步骤，可以把失败层级先记录下来，再进入更通用的恢复流程。相关排查可以看手机智能体失败调试与恢复：Android AI 助手根因分析与最小重试手册。

账号或设备变化后维护连接

邮箱连接不是一次设置后就永远不用看。修改 Google 密码、开启或调整两步验证、更换手机、迁移账号、组织管理员修改策略，都可能让原来的 Gmail 连接需要更新。遇到这些变化，先确认目标邮箱地址，再检查当前允许的登录方式，最后只更新对应账号，不要覆盖另一个相似邮箱。

设备丢失或不再使用某个应用时，Google 建议撤销对应应用专用密码。撤销要在 Google 账号安全设置中完成；完成后，再确认这个旧凭据不能继续使用。FoneClaw 侧的可用邮箱配置应与当前 Google 凭据状态保持一致。重新连接后，用小范围邮件列表验证即可，不需要为了确认连接而读取整个收件箱。

Workspace 账号还要考虑管理员策略。普通用户如果突然看不到应用专用密码或 IMAP 访问失败，可能是组织规则变化。此时应使用组织批准的登录方式和客户端策略，避免把公司邮箱当作个人 Gmail 来排查。

用已连接邮箱开始一个小任务

连接成功后，先做一个有边界的邮件任务。例如：“列出这个 Gmail 账号今天最近五封未读邮件的发件人和主题，不要打开全文。”确认账号正确以后，再让 FoneClaw 总结某封邮件、准备回复草稿、创建跟进提醒或整理到信息收件箱。附件发送涉及文件、收件人和上传确认，详细步骤可以看Android AI 邮件附件安全发送：文件核验、上传确认与失败恢复指南；多来源信息整理可以看安卓 AI 信息收件箱：统一整理通知、短信、邮件、通话与日历。

Google 也在 Gmail 中推进语音和会话式邮件能力，Google 关于 Gmail、Docs 和 Keep 语音功能的介绍提到 Gmail Live 可以用对话方式搜索收件箱细节，并按账号类型和套餐逐步推出。这个能力属于 Google 自身的产品路线；FoneClaw 的 Gmail 连接重点是让 Android AI 助手拥有可验证的邮箱配置，再按用户请求处理邮件动作。

FoneClaw 当前提供引导式 Gmail 配置、收件和发件双向验证、账号明确的邮件列表、读取和发送等受控动作。当前支持范围可以看FoneClaw 功能页，准备安装时可以从FoneClaw 下载页获取入口。先连对邮箱，再从小任务开始，后续邮件摘要、草稿和跟进才更稳。