Hermes Agent iPhone 使用指南：iMessage、Telegram 与 Safari 网页入口

本文根据站内英文指南改写，介绍 Nous Research 的 Hermes Agent。手机是访问入口，实际执行任务的 Hermes 仍需运行在电脑、服务器或托管实例上。

先选入口：你希望在 iPhone 上做什么？

• 直接在「信息」中聊天：通过 Photon 或 BlueBubbles 接入 iMessage。Photon 不需要自己的 Mac，BlueBubbles 需要。
• 尽快开始对话：使用 Telegram、WhatsApp、Discord 或 Signal 等聊天客户端。
• 管理会话、技能、配置和日志：在 Safari 中打开 Hermes 网页控制台。
• 把网关装在手机本机：iPhone 不适合持续运行 Hermes 网关，需要另选运行主机。

Hermes Agent 有 iOS App 吗？

没有。英文原文介绍的上游项目提供 Mac 和 Windows 桌面安装程序，没有官方 iOS App。因此，搜索「Hermes Agent iOS」时，不必先去 App Store 寻找安装包，也不要把同名应用当成官方客户端。桌面端的情况可参考Hermes 桌面应用英文指南。

在 iPhone 或 iPad 上使用 Hermes，核心是把手机上的聊天或浏览器入口连接到运行中的 Hermes。手机负责输入和展示，模型调用与工具执行由运行端处理。

方式一：通过 Photon 接入 iMessage，无需自己的 Mac

Hermes 内置 Photon 平台插件。Photon 提供托管的 iMessage 号码，并把收到的消息转交给 Hermes 网关。配置好后，你可以像给联系人发信息一样，在 iPhone 的「信息」App 中与 Hermes 对话。英文原文提到，Photon 免费层使用共享的 iMessage 号码池。

在运行 Hermes 的主机终端执行以下命令，把示例号码替换成你自己的号码：

hermes photon setup --phone +15551234567   # 替换成你自己的号码
hermes gateway restart
hermes photon status

1. 运行设置命令后，按提示在浏览器中登录并创建 Photon 项目。
2. 首次配置会把你的号码写入 PHOTON_ALLOWED_USERS，仅允许该号码访问。如果已经有允许名单，设置过程会保留原名单；之后批准的用户也会加入名单。
3. 重启 Hermes 网关，再查看 Photon 状态。配置完成后，回复会以带格式的 iMessage 消息送达。

原文还介绍了两个可选设置：PHOTON_REACTIONS=true 可以在处理任务时显示 👀、👍 等点按回应；PHOTON_HOME_CHANNEL 用于指定定时任务结果的发送位置。它们不是开始聊天的必填项。

方式二：在自己的 Mac 上运行 BlueBubbles

如果希望通过自己的 Mac 接入 iMessage，可以使用 BlueBubbles。这是运行在 Mac 上的开源服务，Mac 需要登录你的 Apple ID，并保持开机和登录状态。

Hermes 通过 BlueBubbles 的 REST API 发送消息，通过 webhook 接收消息事件，附件则单独下载。输入状态和已读回执还需要 BlueBubbles 的 Private API 辅助程序，不能把它们视为基础接入后就自动具备的功能。

两种 iMessage 方案的主要区别是：Photon 由第三方托管 iMessage 号码，无需你准备 Mac；BlueBubbles 使用你自己的 Mac，但这台 Mac 必须持续在线。

方式三：用 Telegram、WhatsApp、Discord 或 Signal 聊天

这些聊天入口上手较直接，iPhone 客户端本身也提供推送通知、语音消息和照片发送入口。在运行 Hermes 的主机上启动渠道设置，选择需要的平台，再按提示完成配置：

hermes gateway setup     # 选择聊天平台，按提示配置

如果 Hermes 尚未识别你的账号，首次私聊通常会返回一个有效期为一小时的配对码。以 Telegram 为例，在运行 Hermes 的主机终端执行下面的批准命令，把占位符换成收到的配对码，再回到手机重新发消息：

hermes pairing approve telegram <code>

如果已经启用了严格的允许名单，未知发送者会被直接忽略，而不是收到配对码。这种情况下应先检查账号是否在允许范围内。具体配置可参考Telegram 接入指南或WhatsApp 接入指南。

国内用户应先确认手机和 Hermes 所在主机都能访问所选聊天服务，并能正常登录对应账号，再继续排查机器人配置。不能仅凭手机能打开客户端，就判断服务器到消息平台的连接也正常。

方式四：在 Safari 打开 Hermes 网页控制台

聊天客户端适合发任务；想查看会话、管理技能、修改配置或检查日志，可以使用 Hermes 网页界面。在 Hermes 所在主机执行：

hermes dashboard

控制台默认只监听运行它的机器。直接在 iPhone 上输入主机的地址，并不意味着已经能够远程访问。英文指南给出了两条路径：

• 通过 Tailscale 等私有网络：先配置控制台身份验证，再用 hermes dashboard --host <tailscale-ip> 绑定主机的 Tailscale 地址。Hermes 对非本机监听要求登录认证。私网连接可参考Hermes + Tailscale 中文指南。
• 通过公网地址：同样必须配置认证；未设置认证时，Hermes 会拒绝把控制台绑定到公网地址。相关说明见网关令牌与认证设置英文指南。

确认 Safari 可以正常访问后，可使用「分享 → 添加到主屏幕」放置快捷图标。这只是更方便的网页入口，并不会把 Hermes 网关安装到 iPhone 上。

哪种方式更适合你？

• 平时主要用 iMessage：选择 Photon；如果有一台可以常开的 Mac，也可以考虑 BlueBubbles。
• 希望尽快开始聊天：优先考虑 Telegram，并先确认手机和运行端的网络可用。
• 既要聊天，也要管理 Hermes：保留一个聊天渠道，同时配置 Safari 网页控制台入口。

iPhone 不能替代持续运行的网关主机

要随时接收手机发来的任务，Hermes 网关就需要持续在线。iOS 会限制应用后台运行，无法按电脑或服务器的方式长期维持这类 Python 服务，因此不能依靠 iPhone 本机承载网关。

可以让家中的电脑保持开机，也可以使用 VPS 或托管服务。安卓的本地运行条件不同，相关路线见Hermes 安卓手机指南，不要把安卓终端安装方法直接套用到 iPhone。

使用 OpenClaw Launch 托管时怎么接入？

OpenClaw Launch 可以代为运行 Hermes 网关。部署 Hermes 实例后，在仪表盘连接 Telegram、Discord、WhatsApp 或 Slack，再用 iPhone 上对应的聊天客户端发送消息。仪表盘本身也可以在手机 Safari 中使用。

Photon 和 BlueBubbles 的 iMessage 接入目前需要自建配置，并不是托管仪表盘中的渠道选项。不要把 Hermes 上游支持某个插件，理解成托管平台已经提供同样的配置入口。

如果你找的是 OpenClaw iPhone 应用

英文原文也区分了另一套框架 OpenClaw：它有可与网关配对的官方 iOS App。若你需要的是这类原生应用，可阅读OpenClaw iPhone 英文指南；本页的 Hermes 聊天渠道与网页步骤不能代替 OpenClaw 应用的配对流程。

常见问题

相关阅读

• Hermes Agent iPhone 使用指南（英文原文）
• Hermes Agent 安卓手机使用指南
• Hermes Agent 接入 Telegram（英文）
• Hermes Mac 与 Windows 桌面应用（英文）
• Hermes Agent + Tailscale 远程访问
• OpenClaw iPhone 应用与网关配对（英文）