BlueBubbles——让 AI 用 iMessage

这篇教程将教你如何把 Hermes Agent 接入苹果 iMessage，让 AI 帮你收发短信、处理图片，甚至自动回复群聊。

---

准备工作：你需要什么？

• 一台常开的 Mac（最好 24 小时不关机），用来运行 BlueBubbles 服务器
• Apple ID 已登录 Mac 上的“信息”应用
• BlueBubbles Server v1.0.0 或更高版本（免费开源，从 bluebubbles.app 下载）
• Hermes 和 Mac 之间能互相访问（同一局域网即可）

生活化比喻：BlueBubbles 就像一座“桥梁”，把 iMessage 的信号转成 Hermes 能听懂的语言。Mac 是桥头堡，必须一直开着。

---

第 1 步：安装 BlueBubbles Server

从官网下载安装，跟着向导走：登录 Apple ID，选择连接方式（本地网络、Ngrok、Cloudflare 或动态 DNS）。本地网络最简单，适合在家用。

第 2 步：找到服务器地址和密码

打开 BlueBubbles Server → 设置 → API，记下：

• 服务器地址（类似 http://192.168.1.10:1234）
• 服务器密码

第 3 步：配置 Hermes

打开终端，运行：

hermes gateway setup

选择 BlueBubbles (iMessage)，填入刚才的地址和密码。

或者直接编辑 ~/.hermes/.env 文件：

BLUEBUBBLES_SERVER_URL=http://192.168.1.10:1234
BLUEBUBBLES_PASSWORD=你的服务器密码

可选：群聊里必须 @ 才回复

默认情况下，Hermes 会回复所有私聊和群聊消息。如果你只想让它响应私聊，或者必须 @ 才理你，可以这样设置（编辑 ~/.hermes/config.yaml）：

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

这样私聊正常回复，群聊里只有提到“Hermes”或“@Hermes agent”才回应。想自定义名字？加一行正则：

      mention_patterns:
        - '(?<![\w@])@?amos\b[,:\-]?'

第 4 步：授权用户（谁能用 AI）

有三种方式，推荐第一种：

1. 自动配对（推荐）：有人给你发 iMessage，Hermes 会自动发一个配对码。你用命令批准：

hermes pairing approve bluebubbles <配对码>

查看待处理或已授权用户：

hermes pairing list

2. 预授权指定用户（在 .env 里写）：

BLUEBUBBLES_ALLOWED_USERS=user@icloud.com,+15551234567

3. 完全开放（慎用）：

BLUEBUBBLES_ALLOW_ALL_USERS=true

第 5 步：启动网关

hermes gateway run

看到连接成功，就大功告成！

---

它怎么工作？

iMessage → 信息App → BlueBubbles服务器 → Webhook → Hermes
Hermes → BlueBubbles API → 信息App → iMessage

• 收消息：BlueBubbles 实时推送，不用轮询，秒到
• 发消息：Hermes 通过 API 发出去
• 媒体：图片、语音、视频、文档双向都支持，附件自动下载缓存

---

常用配置一览

变量	必填	说明
BLUEBUBBLES_SERVER_URL	是	服务器地址
BLUEBUBBLES_PASSWORD	是	服务器密码
BLUEBUBBLES_ALLOWED_USERS	否	允许的用户列表
BLUEBUBBLES_ALLOW_ALL_USERS	否	是否允许所有人
BLUEBUBBLES_REQUIRE_MENTION	否	群聊是否必须 @

---

进阶功能（需要装 Private API 插件）

• 点按回应：给消息点赞、爱心等
• 输入状态：AI 思考时显示“正在输入…”
• 已读回执：自动标记已读

不装也能发文字和图片，只是少了这些花哨功能。

---

常见问题

• 连不上服务器：检查 Mac 是否开机、地址对不对、防火墙放行
• 收不到消息：看 BlueBubbles 设置里 Webhook 是否注册成功，用 hermes logs -f 看实时日志
• Private API 没连接：去 docs.bluebubbles.app 装插件，基础功能不受影响

---

小结

BlueBubbles 让 Hermes 用上 iMessage 只花十分钟。核心三步：装服务器、填地址密码、授权用户。现在你的 AI 能收发短信、处理图片，还能在群聊里乖乖等 @ 了。

下篇预告：接入 WhatsApp 或 Telegram？敬请期待「消息平台接入系列」下一期——让 AI 用上你最常用的聊天软件！