Photon——macOS 上的 iMessage 接入

这篇教程将带你用 Photon 服务把 Hermes Agent 接入 iMessage，让你的苹果手机也能直接和 AI 智能体发短信聊天。

---

先搞懂 Photon 是什么

你可以把 Photon 想象成一个**“苹果短信中转站”**。因为 iMessage 是苹果的封闭系统，普通电脑没法直接收发。Photon 帮你处理了这些麻烦事，你只需要注册一个账号，就能让 Hermes 用上 iMessage。

最大的好处是： 不需要公网 IP、不用配置路由器、更不用买一台 Mac 当服务器。免费版就够日常使用了。

---

第1步：准备材料

• 一个能收短信的手机号（用来注册和绑定）
• 电脑上装好 Node.js 18.17 或更高版本（在终端输入 node --version 检查）
• 去 app.photon.codes 注册一个账号

---

第2步：一键初始化

打开终端，运行下面的命令（把手机号换成你自己的）：

hermes photon setup --phone +15551234567

这个命令会自动完成所有设置，包括：

1. 打开浏览器让你登录 Photon 账号
2. 自动创建项目并生成密钥
3. 绑定你的手机号
4. 最后会打印一个专属的 iMessage 号码——这就是你智能体的“电话号码”

💡 如果中途卡住，重新运行一次即可，它是安全的，不会重复创建。

---

第3步：授权谁能和你的智能体聊天

默认情况下，陌生号码发消息会收到一个配对码。你需要在终端批准：

hermes pairing approve photon <收到的配对码>

想省事的话，也可以直接指定允许的号码（编辑 ~/.hermes/.env 文件）：

PHOTON_ALLOWED_USERS=+15551234567,+15559876543

⚠️ 注意： 如果设置了允许列表，其他号码会被静默忽略，不会收到任何回复。

---

第4步：启动网关

hermes gateway start

看到类似下面的输出就说明成功了：

[photon] connected — sidecar on 127.0.0.1:8789, streaming inbound over gRPC

现在，用你的手机给刚才分配的号码发一条 iMessage，Hermes 就会回复你！

---

第5步：检查状态（遇到问题用）

hermes photon status

这个命令会显示所有关键信息：

• ✅ 设备令牌是否已存储
• ✅ Node.js 是否可用
• ✅ 侧车依赖是否安装
• ✅ 你绑定的号码和分配的 iMessage 号码

常见问题：

• sidecar deps : ✗ → 运行 hermes photon install-sidecar 修复
• device token : ✗ missing → 重新运行 hermes photon setup
• 收不到回复 → 确认网关在运行，且号码已授权

---

小提示

• 免费版限制： 每天 5000 条消息，每条共享线路每天只能发起 50 次新对话。够个人用了。
• 群聊控制： 默认群聊也回复，想改成只回复 @ 你的消息，可以在配置里加 require_mention: true。
• 发图片和语音： 支持！但接收附件目前只能看到文件名，还不能读取内容。

---

总结

到这里，你的 Hermes 智能体就成功接入 iMessage 了。整个过程不需要任何服务器配置，跟着命令走就行。最核心的就三步：注册 → 初始化 → 启动网关。

下篇预告： 我们会聊聊如何给 Hermes 接入 WhatsApp，让你用另一个国民级聊天软件和 AI 对话。敬请期待！