Hermes Agent 配置 QQ 邮箱 教程 (Himalaya CLI)✨ 本教程详细记录如何配置 QQ 邮箱的 IMAP/SMTP 服务并使用 Himalaya CLI 命令行工具管理邮件。 前置条件QQ 邮箱账号如646269678qq.com已获取 QQ 邮箱的授权码不是 QQ 密码Linux/macOS 终端环境或 WSL已安装 Himalaya CLI 邮件客户端 第一步获取 QQ 邮箱授权码登录 QQ 邮箱网页版https://mail.qq.com点击顶部设置→账户找到POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务部分开启IMAP/SMTP服务如果未开启点击生成授权码按照提示发送短信验证复制生成的16位授权码⚠️重要提示授权码是第三方客户端登录的专用密码不要泄露给他人更改 QQ 密码会导致授权码失效需要重新生成 第二步QQ 邮箱服务器信息根据 QQ 邮箱官方文档SMTP/IMAP服务IMAP 接收邮件服务器服务器地址imap.qq.com端口993加密SSL/TLS协议IMAPSMTP 发送邮件服务器服务器地址smtp.qq.com端口465推荐或587加密SSL/TLS协议SMTP账户信息邮箱地址你的完整 QQ 邮箱如646269678qq.com用户名同上完整邮箱地址密码授权码不是 QQ 密码 第三步安装 Himalaya CLI通过 Cargo 安装推荐cargoinstallhimalaya通过包管理器安装# Ubuntu/Debiansudoaptinstallhimalaya# macOS (Homebrew)brewinstallhimalaya# Arch Linuxsudopacman-Shimalaya验证安装himalaya--version# 输出示例himalaya v1.2.0 maildir smtp wizard sendmail pgp-commands imap⚙️ 第四步配置 HimalayaHimalaya 的配置文件位于~/.config/himalaya/config.toml。创建配置文件mkdir-p~/.config/himalaya编辑配置文件nano~/.config/himalaya/config.toml配置文件内容将以下内容复制到配置文件中替换646269678qq.com为你的邮箱和你的授权码[accounts.qq] email 646269678qq.com display-name 你的显示名称 default true [accounts.qq.backend] type imap host imap.qq.com port 993 encryption { type tls } login 646269678qq.com auth { type password, raw 你的授权吗 } [accounts.qq.message.send.backend] type smtp host smtp.qq.com port 465 encryption { type tls } login 646269678qq.com auth { type password, raw 你的授权吗 }配置说明accounts.qq账户名称可自定义如改为qqmailemail你的 QQ 邮箱地址display-name发送邮件时显示的姓名default true设为默认账户backendIMAP 接收服务器配置message.send.backendSMTP 发送服务器配置✅ 第五步测试配置1. 检查账户配置himalaya account list输出应显示你的账户| NAME | BACKENDS | DEFAULT | |------|----------|---------| | qq | | yes |2. 诊断账户himalaya account doctor qq输出应为Checking TOML configuration integrity for account qq… OK3. 列出邮件测试 IMAP 连接himalaya envelope list如果连接成功会显示最近的邮件列表| ID | FLAGS | SUBJECT | FROM | DATE | |------|-------|----------------------------------|--------------|------------------------| | 1676 | | 更安全、更高效、更强大... | QQ邮箱团队 | 2026-04-23 07:2908:00 | | 1671 | | D-Claw 验证码 | lslcool.hi | 2026-04-21 19:1308:00 | ...更多邮件4. 发送测试邮件可选himalaya messagewrite按照提示填写To: 你的邮箱地址Subject: 测试邮件Body: 这是一封测试邮件按CtrlD完成编辑输入send发送。 第六步常用 Himalaya 命令邮件管理# 列出最新邮件默认显示10封himalaya envelope list# 列出更多邮件如20封himalaya envelope list--max20# 阅读特定邮件himalaya messageread邮件ID# 查看邮件线程himalaya envelope thread邮件ID# 搜索邮件himalaya envelope list--queryGitHub# 标记为已读himalaya flagadd邮件IDseen# 删除邮件himalaya message delete邮件ID文件夹管理# 列出所有文件夹himalaya folder list# 切换到特定文件夹himalaya envelope list--folderINBOX# 查看垃圾邮件himalaya envelope list--folderJunk发送邮件# 交互式编写邮件himalaya messagewrite# 回复邮件himalaya message reply邮件ID# 转发邮件himalaya message forward邮件ID账户管理# 列出所有账户himalaya account list# 诊断账户问题himalaya account doctor账户名# 交互式配置账户需要TTYhimalaya account configure账户名 第七步故障排除常见错误及解决方案1. “cannot list envelopes: feature not available”问题配置文件格式错误或缺少必要字段。解决检查配置文件格式确保encryption { type tls }而不是encryption tls。2. “authentication failed”问题授权码错误或已失效。解决重新生成 QQ 邮箱授权码更新配置文件中的auth.raw字段确保使用的是授权码而不是 QQ 密码3. “connection timeout” 或 “network error”问题网络问题或服务器地址错误。解决检查网络连接确认服务器地址正确IMAP:imap.qq.com:993SMTP:smtp.qq.com:465尝试关闭防火墙或 VPN 测试4. “certificate verify failed”问题SSL 证书验证失败。解决# 测试 SSL 连接openssl s_client-connectimap.qq.com:993-crlf如果证书有效可能是系统时间不正确。5. Himalaya 命令不存在问题Himalaya 未正确安装。解决# 重新安装cargoinstallhimalaya--force# 或添加到 PATHexportPATH$HOME/.cargo/bin:$PATH调试模式启用调试日志查看详细错误信息himalaya envelope list--debughimalaya envelope list--trace 第八步其他邮件客户端配置如果你需要使用其他邮件客户端配置信息相同Thunderbird新建账户 → 输入姓名、邮箱、密码授权码手动配置接收IMAPimap.qq.com端口 993SSL/TLS发送SMTPsmtp.qq.com端口 465SSL/TLSmutt (Linux 终端)编辑~/.muttrcset imap_user 646269678qq.com set imap_pass 你的授权码 set smtp_url smtps://646269678qq.comsmtp.qq.com:465/ set smtp_pass 你的授权码 set from 646269678qq.com set realname 你的姓名Apple Mail / Outlook使用相同的服务器信息密码处填写授权码。 配置文件备份建议备份你的配置文件# 备份cp~/.config/himalaya/config.toml ~/himalaya-config-backup.toml# 恢复cp~/himalaya-config-backup.toml ~/.config/himalaya/config.toml 参考链接QQ 邮箱 SMTP/IMAP 服务官方文档Himalaya CLI GitHub 仓库Himalaya 官方文档 总结通过本教程你已经成功✅ 获取了 QQ 邮箱授权码✅ 了解了 QQ 邮箱服务器信息✅ 安装并配置了 Himalaya CLI✅ 测试了邮件收发功能✅ 掌握了常用邮件管理命令现在你可以通过命令行高效管理 QQ 邮箱了遇到问题请参考故障排除部分或重新查看本教程。最后更新2026年4月23日文档维护Hermes Agent祝你使用愉快 ✨