---
title: 获取 Gmail App Password
nav: Gmail 授权码
summary: 给 Agent J 创建单独的 Gmail 应用专用密码，在手机弹窗中粘贴，随时可以撤销。
order: 37
---
# 获取 Gmail App Password

Agent J 通过 IMAP/SMTP 连接邮箱。给它单独创建一个 App Password（应用专用密码），别用 Google 主密码，这样以后能单独撤销。它依然能正常收发邮件，请妥善保管。

## 先开两步验证

打开 [Google 账号安全设置](https://myaccount.google.com/security)，按 [Google 官方两步验证说明](https://support.google.com/accounts/answer/185839?hl=zh-Hans) 完成设置，再创建应用专用密码。

![Google 安全设置，账号资料已用实色块遮住](step-4.png)

## 确认当前账号

Google 账号得跟填给 Agent J 的 Gmail 地址一致。你可以从头像菜单切换账号。示例图里的姓名、邮箱和头像，都已经用实色块遮住了。

![账号切换菜单，身份和头像已移除](step-5.png)

## 起名并创建

打开 [Google 应用专用密码页面](https://myaccount.google.com/apppasswords)，可能需要重新登录。名称填 **Agent J**，点击 **Create（创建）**。

![把应用名称填为 Agent J](step-2.png)

## 完整复制，保留空格

复制刚生成的整段密码。**空格不用删，原样粘贴。** 下图的 `abcd efgh ijkl mnop` 只是示例，不能用于登录；原密码已被完整实色覆盖并替换。

![生成密码区域已替换成 abcd efgh ijkl mnop 示例](step-3.png)

## 粘贴到 Agent J

打开手机设置，找到邮件通道，填上 Gmail 地址，点设置邮箱授权码。弹窗里有个框叫 Gmail App Password，把密码粘进去保存就行。保存后会自动测 IMAP 和 SMTP 连接，不实际发信，结果就一句话。下次再进来，只看到已设置和更换，不会回显密码。

你也可以用自然语言把邮箱地址、服务器这些非密码信息告诉 Agent J，让它先配好，再输入 `agentj mail password` 弹出同一张密钥卡。**不要把密码发到聊天里。** 密码会加密直送 Agent J 工作主机，以加密私有文件保存。

![手机密钥卡，隐私资料已遮挡，密码已替换为示例](step-1.png)

## 出错怎么办

- 找不到应用专用密码入口：先确认两步验证已开启。Google Workspace 管理策略、高级保护计划，或者只用了安全密钥的账号，可能不支持这个功能；请联系管理员，或者换个支持的邮箱试试。
- 登录失败：核对一下账号，重新生成并复制应用专用密码，再检查电脑网络和 IMAP/SMTP 设置。注意，修改 Google 主密码会让原来的应用专用密码失效。
- 连接失败时，密码还保存在那里。点 **已设置 · 更换** 重新填写；测试没有发出邮件。
- 更多限制见 [Google 官方应用专用密码说明](https://support.google.com/accounts/answer/185833?hl=zh-Hans)。

## 如何撤销

回到 [Google 应用专用密码页面](https://myaccount.google.com/apppasswords)，找到给 Agent J 创建的条目并删除。Agent J 就不能再用它登录。不再使用邮件通道时，也在 Agent J 设置中关闭；以后需要时重新生成即可。