如何将 HappyCapy 接入 iMessage：在苹果 Messages 中打造完整 AI 智能体

Apple 从未发布过 iMessage API。2015 年没有，2020 年没有，今天依然没有。多年以来，要构建一个生活在你的 iMessages 中的 AI agent，要么需要越狱，要么需要每月 200 美元的企业方案，要么需要对未公开协议有深入理解。到了 2026 年 6 月，一条免费的开源路径终于稳定可用了——而且它与拥有 188,000 星标的 Hermes Agent 项目在生产环境中使用的架构完全相同。

---

为什么 iMessage 是最难对接的平台（以及这为何重要）

大多数消息平台都有 API。Telegram 在 2015 年公布了自己的 API。Slack 从一开始就有 webhooks。WhatsApp 在 2018 年开放了其 Business API。iMessage 从未有过这些，而这并非疏忽。

Apple 的 iMessage 协议使用直接绑定到 Apple ID 和设备专属密钥的端到端加密。这些密钥在 Apple 硬件上生成，且从不离开该硬件。每条消息都在实体 Apple 设备上完成加密和解密。之所以没有服务器端 API，是因为根本不存在持有已解密内容的服务器。这是一项硬性的密码学约束——而非 Apple 可以通过一份新闻稿撤销的政策选择。

其现实后果是：没有任何 Linux 进程、Docker 容器或云端虚拟机能够原生发送或接收 iMessages。哪怕拥有 root 权限也不行，哪怕拥有有效的 Apple ID 也不行。该协议在 Apple 硬件之外根本无法运作。

对于 AI agent 开发者来说，这意味着 iMessage 集成始终需要一台 Mac 参与其中。这是诚实的答案，也决定了本文接下来的一切内容。

反过来说也同样成立：对于 Apple 用户而言，这种架构意味着 bot 就生活在 Messages.app 本身之内。无需安装任何第三方应用，无需创建新账户。AI 通过你的家人和同事早已在使用的同一个界面进行响应。当你的联系人给你发消息时，他们并不会察觉任何变化——他们看到的是来自你 Apple ID 的回复，格式是原生 iMessages，还带有已读回执。

这种组合——对接收者零摩擦、加密隐私、运行在 Apple 用户已经信任的平台上——正是 iMessage 值得承受额外复杂度的原因。

---

它实际上是如何运作的

这个免费、开源的解决方案叫 BlueBubbles。这是一款 MIT 许可的 Mac 服务器应用程序，运行在你的 Mac 上，注册到你的 Apple ID，并暴露一个本地 REST API。BlueBubbles 充当 iMessage 协议（需要 macOS）与任何能够发起 HTTP 请求的外部服务之间的桥梁。

HappyCapy 的 capy-bridge 会连接到这个 REST API。当一条消息到达你的 Apple ID 时，具体流程如下：

这与 Hermes Agent 所使用的架构相同。Hermes Agent 项目——由 Nous Research 打造、拥有 188,000 个 GitHub 星标——在其生产配置中通过 BlueBubbles 来路由其 iMessage 集成。这套架构已经经过了大规模的压力测试。

第 5 步的关键细节是 claude --print。HappyCapy 并不是把你的消息发送给一个只会用文字回复的聊天机器人。它运行的是 Claude Code CLI，具备完整的工具访问权限：bash 执行、文件读写、网页搜索、图像生成，以及对 HappyCapy 超过 300,000 个 Skills 库的访问权限。这个 bot 不只是回答问题——它会采取行动。

---

你能做什么

一旦桥接程序运行起来，发往你 Apple ID 的每一条 iMessage 都会变成你 HappyCapy 沙盒的一个命令接口：

• 远程执行任务——从 iPhone 发送一个任务，得到一个完整执行后的结果及输出
• 请求文件——索要一份 PDF 报告、一张生成的图片或一段脚本，并接收它
• 搜索与总结——让 agent 搜索网页并返回一份结构化摘要
• 触发超过 300,000 个 Skills——HappyCapy 库中的每一个 Skill 都可以从 Messages.app 中访问
• 在你的沙盒上运行 bash——run ls /var/log 会在你的 HappyCapy Linux 环境中执行并返回输出
• 按联系人区分的历史记录——每个 Apple ID 或电话号码都拥有各自独立的对话线程；上下文会在消息之间延续
• 可从任何 Apple 设备使用——iPhone、iPad、Mac、Apple Watch——任何能发送 iMessages 的设备都能触达这个 bot

---

优点

• 原生 Apple 体验——回复出现在标准的 Messages.app 会话中；接收者无需安装任何东西
• 接收者设备上无需第三方应用——bot 通过现有的 iMessage 基础设施进行通信
• 适用于任何 Apple ID——任何能给你发 iMessage 的联系人都可以与该 bot 互动
• 端到端加密——BlueBubbles 不会破坏 Apple 的加密；它读取的是消息在你 Mac 上解密之后的内容
• 免费且开源——BlueBubbles 采用 MIT 许可，没有任何订阅费用
• 经过 Hermes 验证的架构——与驱动一个拥有 188,000 星标的生产级 agent 项目相同的技术栈
• 完整的 agent 能力——claude --print 让这个 bot 拥有 bash 访问权限、网页搜索、文件操作，以及超过 300,000 个 Skills

---

实际使用场景

在 iPhone 上的开发者。 你离开了笔记本电脑，需要检查某个 cron 任务是否执行了、查看某个日志文件，或者在你的 HappyCapy 沙盒上重启某个服务。你从 iPhone 的 Messages.app 发送命令。桥接程序执行它，并把输出作为回复返回。无需 SSH 客户端，无需 VPN，无需切换上下文。

纯 Apple 生态的家庭。 你的伴侣、父母或室友都只使用 iMessages，没有别的。与其让他们安装 Telegram 或学习一个新界面，不如把 bot 直接指向你现有的 Apple ID。所有人都通过设备上早已安装好的应用进行交互。

拥有 iMessage 客户的企业主。 你通过 iMessage 与客户沟通——这是他们习惯使用的方式，让他们切换到其他平台并不现实。桥接程序运行起来后，你可以让 agent 总结一段很长的对话线程、以你的口吻起草一封回复、查询某位客户的订单历史，或者拉取一份报告。AI 停留在关系本就存在的渠道里。

拥有 Mac 的研究者。 你的桌面上一直运行着一台 Mac。你希望拥有一个始终可访问的 AI agent——通勤时用 iPhone，会议中用 iPad，紧急情况下用同事的 Mac。iMessage 已经在你拥有的每一台 Apple 设备之间同步。这个 bot 会自动继承这种覆盖范围。

---

Mac 需求——诚实的评估

该配置需要一台安装并运行了 BlueBubbles、并通过 capy-bridge 连接到 HappyCapy 的 Mac。Mac 必须保持唤醒且联网，桥接程序才能正常工作。如果它进入睡眠，bot 就会离线。

这是一个真实存在的限制。如果你没有 Mac，或者你的 Mac 是一台经常携带并合上盖子的笔记本电脑，那么 iMessage 对你来说不是合适的渠道。HappyCapy 的 Telegram 和 Slack 集成运行在完全 Linux 原生的基础设施上，没有硬件依赖。

对于那些已经在运行一台常开 Mac 的人来说——电视下面的 Mac Mini、家庭办公室里的 Mac Studio，或是插着电源放在架子上的旧 MacBook——这项配置是一次性的，之后就完全自动化了。BlueBubbles 会在登录时启动，capy-bridge 守护进程也会在登录时启动。只要 Mac 持续运行，bot 也会持续运行。

如果你正考虑为此专门购置硬件，2026 款 Mac Mini M4 基础版（799 美元）是最实用的选择。它在空闲状态下大约使用 6-10 瓦电力，支持无风扇噪音的 24/7 运行，体积比一本平装书还小。关于 Mac Mini AI 服务器配置的完整详解，请参见 Mac Mini as an AI Server in 2026。

---

如何进行配置

完整配置大约需要 10 分钟：

1. 下载 BlueBubbles，访问 bluebubbles.app——免费、MIT 许可、开源
2. 运行配置向导——使用你的 Apple ID 登录，并授予辅助功能（Accessibility）与完全磁盘访问（Full Disk Access）权限
3. 记下你的 BlueBubbles URL 和密码，可在 BlueBubbles 设置界面中找到
4. 安装 capy-bridge——在 HappyCapy 中运行 bash /app/export-port.sh 8766 获取你的 webhook URL，然后运行 /happycapy-imessage skill
5. 完成 HappyCapy 配置向导——粘贴你的 BlueBubbles URL、密码和 webhook URL；桥接程序会自动完成注册
6. 测试——从另一台设备发送一条 iMessage；你应该会在几秒钟内收到回复

完整的 skill 文档与源代码位于 github.com/ndpvt-web/happycapy-imessage。

---

常见问题

我需要一直开着我的 Mac 吗？ 是的，如果你想要 24/7 全天可用的话。Mac 必须保持唤醒且联网，BlueBubbles 和 capy-bridge 才能接收传入的消息。如果你希望这个 bot 全天候可用，请使用可以持续运行的硬件——Mac Mini 或 Mac Studio 是理想选择。请在 BlueBubbles 设置中启用「Prevent display sleep」，并在 macOS 的节能设置（电源适配器模式）中禁用睡眠。

这是否也支持 SMS，还是只支持 iMessage？ 如果你的 Mac 连接了一台 iPhone，并且已配置个人热点以启用短信转发，那么 BlueBubbles 同时支持 iMessage（蓝色气泡）和 SMS（绿色气泡）。对于大多数配置来说，仅使用 iMessage 会更简单、更可靠。

Apple 能通过 BlueBubbles 看到我的消息吗？ 不能。BlueBubbles 不会破坏 Apple 的端到端加密。消息像往常一样由你本地设备上的 macOS 解密，然后 BlueBubbles 从那个本地已解密的状态中读取消息。Apple 的服务器永远看不到明文内容——这与正常使用 Messages.app 时完全一样。

BlueBubbles 是免费的吗？ 是的。BlueBubbles 采用 MIT 许可，可免费使用，没有任何订阅费用。Mac 服务器应用、源代码和文档都公开发布在 bluebubbles.app。

如果我的 Mac 进入睡眠会怎样？ 桥接程序会离线。Mac 睡眠期间发送的消息不会被处理，也不会在 Mac 唤醒后被追溯性地回复。为避免这种情况：在 BlueBubbles 中启用「Prevent display sleep」，在 macOS 节能设置中为电源适配器使用场景禁用系统睡眠，或者在终端中运行 caffeinate -di &。对于需要始终在线的配置，台式 Mac（Mini、Studio、Pro）比笔记本电脑更合适。

多个人能否从不同的 Apple ID 给这个 bot 发消息？ 可以。桥接程序会按发送者账号分别存储对话历史。每个 Apple ID 或电话号码都拥有各自独立的上下文窗口。你可以配置一个白名单（仅限特定账号），也可以对所有传入的 iMessages 开放。

这是否违反 Apple 的服务条款？ BlueBubbles 处于一个灰色地带：Apple 并未明确批准第三方 iMessage 桥接方案，但在其运营的四年多时间里，Apple 也从未对 BlueBubbles 采取过任何行动。该项目从你自己的 Mac、以你自己的 Apple ID 读取消息，方式与任何拥有完全磁盘访问权限的进程别无二致。将其用于你自己的自动化——而非商业性的批量发送或垃圾消息——与成千上万开发者使用它的方式是一致的。截至 2026 年，Hermes Agent 项目在其默认配置中就内置了 BlueBubbles 集成。

---

结语

在 HappyCapy 支持的四个消息渠道——Telegram、Slack、WhatsApp 和 iMessage——中，iMessage 是配置起来技术难度最高的一个。它需要一台 Mac、一个正在运行的 BlueBubbles 服务器，以及你的硬件与 HappyCapy 沙盒之间的持久连接。这比其他渠道涉及更多的组成部分。

但对于已经生活在 Apple 生态系统中的用户来说，它同时也是效果最无缝的一个：一个完整的 AI agent，通过你的联系人每天都在使用的 Messages 应用进行响应，无需安装任何新应用，也无需创建任何新账户。这套架构已被验证——正是驱动 Hermes Agent 获得 188,000 星标的同一技术栈——而 HappyCapy 将它封装成了一键式 skill。

如果你有一台常开的 Mac，这 10 分钟的配置是值得的。