BlueBubbles（iMessage）

可通过 BlueBubbles 将 Hermes 连接到 Apple iMessage —— 这是一款免费的开源 macOS 服务器，能够实现 iMessage 与任意设备的通信。

前提条件

从 bluebubbles.app 下载并安装该软件。按照设置向导完成配置：使用您的 Apple ID 登录，并选择连接方式（局域网、Ngrok、Cloudflare 或动态域名）。

在 BlueBubbles Server 中进入 设置 → API，记下以下信息：

运行设置向导即可完成配置。

hermes gateway setup

选择BlueBubbles (iMessage)，然后输入您的服务器地址和密码。

或者直接在~/.hermes/.env文件中设置环境变量：

BLUEBUBBLES_SERVER_URL=http://192.168.1.10:1234
BLUEBUBBLES_PASSWORD=your-server-password

默认情况下，Hermes 会回应所有经过授权的 BlueBubbles/iMessage 私信及群聊消息。若希望让群聊消息需要主动触发响应，可启用“提及验证”功能：

platforms:
  bluebubbles:
    enabled: true
    extra:
      require_mention: true

当设置 require_mention: true 时，私信功能仍可正常使用，但群聊消息除非符合指定的提及模式，否则会被忽略。如果您未自定义匹配模式，Hermes 将对 “Hermes” 及 “@Hermes agent” 这两种格式采用较为保守的默认设置。

如需使用自定义智能体名称，请设置正则表达式模式：

platforms:
  bluebubbles:
    extra:
      require_mention: true
      mention_patterns:
        - '(?<![\w@])@?amos\b[,:\-]?'

请选择一种方式：

直接消息配对（推荐）： 当有人给您发送 iMessage 时，Hermes 会自动向对方发送配对码。您只需通过以下操作进行确认即可：

hermes pairing approve bluebubbles <CODE>

使用 hermes pairing list 命令可以查看待验证的代码以及已通过授权的用户。

在 ~/.hermes/.env 文件中预授权特定用户：

BLUEBUBBLES_ALLOWED_USERS=user@icloud.com,+15551234567

开放访问权限（位于 ~/.hermes/.env 文件中）：

BLUEBUBBLES_ALLOW_ALL_USERS=true

hermes gateway run

Hermes将会连接到您的BlueBubbles服务器，注册一个Webhook，进而开始监听iMessage消息。

iMessage → Messages.app → BlueBubbles Server → Webhook → Hermes
Hermes → BlueBubbles REST API → Messages.app → iMessage

变量名	是否必填	默认值	描述
`BLUEBUBBLES_SERVER_URL`	是	—	BlueBubbles服务器地址
`BLUEBUBBLES_PASSWORD`	是	—	服务器密码
`BLUEBUBBLES_WEBHOOK_HOST`	否	`127.0.0.1`	Webhook监听器的绑定地址
`BLUEBUBBLES_WEBHOOK_PORT`	否	`8645`	Webhook监听器端口
`BLUEBUBBLES_WEBHOOK_PATH`	否	`/bluebubbles-webhook`	Webhook URL路径
`BLUEBUBBLES_HOME_CHANNEL`	否	—	用于定时发送消息的电话号码或邮箱地址
`BLUEBUBBLES_ALLOWED_USERS`	否	—	以逗号分隔的授权用户列表
`BLUEBUBBLES_ALLOW_ALL_USERS`	否	`false`	允许所有用户发送消息
`BLUEBUBBLES_REQUIRE_MENTION`	否	`false`	在群组聊天中回复前是否需要指定被提及对象
`BLUEBUBBLES_MENTION_PATTERNS`	否	Hermes唤醒词	用于匹配群组中被提及对象的JSON数组，各模式之间以换行符或逗号分隔