1. 一条命令把 Hermes Agent 接上 iMessage，尽享丝滑「完整教程」

Hermes Agent v0.17.0 已支持通过 Photon 收发 iMessage。

按照步骤操作 3 分钟搞定！

不需要准备常驻 Mac，也不需要配置公网地址。
完成设置后，直接用 iPhone 的「信息」App 给 Photon 分配的号码发消息，就能与 Hermes Agent 对话。

完整更新日志👉🏻：https://github.com/NousResearch/hermes-agent/releases/tag/v2026.6.19

3 小时

重磅！Hermes Agent v0.17.0 正式发布！Hermes 进一步拓展了多端连接、异步协作与跨网络集成能力，升级为全功能指挥中心。
以下为核心更新摘要：

1. 独立支持 iMessage，无需 Mac 中继或 BlueBubbles 设置。
2. 运行 hermes photon login 即可通过 Photon 直连收发 iMessage。
3. Raft

1.1. 准备条件

开始前需要：

1. 已安装最新版 Hermes Agent
2. Node.js 18.17 或更高版本
3. 一个能够接收 iMessage 的手机号
4. 一个 Photon 账号，没有的话可以在配置过程中注册

先检查 Node.js 版本：

node --version

1.1.1. 第一步：配置 Photon

可以通过 Hermes Gateway 的统一向导配置：

hermes gateway setup

在向导中选择 Photon iMessage。

也可以直接运行 Photon 配置命令：

hermes photon setup --phone +你的手机号

手机号必须使用国际格式。中国大陆手机号示例：

hermes photon setup --phone +8613800000000

命令运行后，终端会显示设备授权地址和验证码。
按照提示打开 Photon Dashboard，登录并批准设备。

页面显示 Device connected 后，回到终端等待配置继续执行。

Hermes 会自动完成 Photon 项目创建、手机号注册、依赖安装和授权配置。
成功后会显示：

✓ phone registered
✓ allowlisted your number (PHOTON_ALLOWED_USERS)

┌─ Your agent's iMessage number ───────────────────────────────
│  📱 +16xxxxxxxxx  // 🔥提供一个号码，保存好
│  Text this number from your phone to talk to your agent.
└──────────────────────────────────────────────────────────────

✓ Photon setup complete.

请记下终端显示的 iMessage 号码。

安装依赖时可能出现 npm audit 的 vulnerabilities 提示。
只要最后显示 Photon setup complete，就代表配置成功。

不要运行 npm audit fix --force，它可能升级并破坏 sidecar 所需的依赖版本。

1.1.2. 第二步：启动 Gateway

首次启动可以运行：

hermes gateway start --platform photon

如果 Gateway 已经在运行，重启即可：

hermes gateway restart

1.1.3. 第三步：检查连接状态

检查 Photon：

hermes photon status

重点确认以下项目正常：

device token        : ✓ stored
project secret      : ✓ stored
assigned number     : +1...
sidecar deps        : ✓ installed

再检查 Gateway：

hermes gateway status

看到下面的提示，说明 Gateway 正在运行：

✓ System gateway service is running

1.1.4. 第四步：发送 iMessage

打开 iPhone 的「信息」App，新建 iMessage，将收件人填写为 Photon 分配的号码，然后发送一条消息：

你好，介绍一下你自己

Hermes Agent 正常回复，就代表接入完成。

hermes photon setup 会自动把配置时填写的手机号加入允许名单。
其他号码首次发送消息时，可能需要进行配对。

查看待批准的配对请求：

hermes pairing list

批准配对：

hermes pairing approve photon <配对码>

1.2. 完整演示

2 小时

Hermes Agent iMessage 安排上了。
实测响应速度比 Telegram 快，更丝滑。
另外，不需要 Mac 就可以随时沟通，爽歪歪。
Good Job! @Teknium @NousResearch

1.3. Photon 后台与免费额度

登录 Photon Dashboard 后，进入 Spectrum → Users，可以查看当前用户、绑定的手机号以及分配的 iMessage 号码。

免费版每个项目最多添加 10 个用户。
需要让其他人使用时，点击 Add user，填写对方的手机号即可。

Photon 使用共享 iMessage 线路池，因此不同用户在 Texts on 一栏中看到的收件号码可能不同，这是正常现象。

免费版目前还有以下额度：

• 每个 server 每天最多处理 5000 条消息
• 每条共享线路每天最多发起 50 次新对话

日常个人使用通常足够。
额度或线路需求更高时，需要联系 Photon 升级方案。

1.4. 常见问题

1.4.1. Photon 依赖没有安装

如果 hermes photon status 显示 sidecar deps 缺失，运行：

hermes photon install-sidecar
hermes gateway restart

1.4.2. Device token 缺失

如果状态中显示 device token 缺失，重新运行配置并完成登录：

hermes photon setup --phone +你的手机号

1.4.3. 没有分配 iMessage 号码

如果 Photon Dashboard 显示 No iMessage line assigned yet，重新运行：

hermes photon setup --phone +你的手机号

完成后再次检查：

hermes photon status

1.4.4. Gateway 服务定义过期

升级 Hermes 后如果看到：

Installed gateway service definition is outdated

运行：

sudo hermes gateway restart --system

1.4.5. 发消息没有回复

依次检查：

hermes photon status
hermes gateway status
hermes logs gateway

确认 Photon 已连接、sidecar 已启动、Gateway 正在运行，并检查发送消息的手机号是否已被允许或完成配对。