Hermes Agent
微信配置指南

在 Mac 上打开终端，确认这些已经完成：

如果没看到 aiohttp，安装微信需要的额外依赖：

• □ Hermes 已安装（有了 ~/hermes-agent 目录）
• □ 虚拟环境已激活（终端行首有 (venv)）
• □ aiohttp、cryptography 已安装

① 打开申请页面

在浏览器访问：

② 注册成为开发者
用你的微信扫码登录，按提示填写开发者信息。

③ 创建 Bot 应用
登录后找到"创建应用"或"创建 Bot"，填写：
· 应用名称：HermesBot（随便起）
· 应用类型：个人 Bot

④ 获取 Token
创建成功后，在应用详情页找到 Bot Token（一串以 ilink_ 开头的字符串）。
复制保存好，下一步要用。

• □ 已注册 open.im.qq.com
• □ 已创建 Bot 应用
• □ 已复制 Bot Token

打开 Hermes 配置文件：

在文件末尾，粘贴以下内容（把 TOKEN 换成你的）：

保存文件（Command + S），然后关闭。
注意：缩进要对齐，weixin: 顶格写，下面每行前面空两格。

• □ Bot Token 已填入 config.yaml
• □ 文件已保存

在终端中启动 Hermes gateway（微信平台模式）：

启动后，终端会显示一个 二维码（由字符拼成的方块图案）。

扫码后手机微信上会弹出授权提示，点 确认登录。

终端会显示类似 ✅ Weixin connected 的提示，说明连接成功。

• □ 手机扫码登录成功
• □ 终端显示 "Weixin connected"

保持终端开着，现在拿出手机，打开微信。

你应该会在微信里看到一个新的聊天——HermesBot（或者你起的名字）。

发一条消息给它试试，比如：

如果配置正确，Mac 上的 Hermes 会处理这条消息并把回复发回微信。

然后你可以试试更有用的：

• □ 微信收到 Bot 回复
• □ 功能正常

创建一个启动脚本，让 Mac mini 每次开机自动启动 Hermes（含微信平台）：

让文件可执行：

打开 系统设置 → 通用 → 登录项，点 +，选择 start-hermes-weixin.command。

• □ 启动脚本已创建
• □ 已添加到登录项