教程

OpenClaw + BlueBubbles:macOS iMessage AI 助手最佳方案完全指南

OpenClaw 通过 BlueBubbles 接入 iMessage 的完整教程:为什么 BlueBubbles 是目前 iMessage 自动化的最佳方案(相比旧版 imsg CLI 的优势:支持消息编辑/撤回/Tapbacks/群组管理/稳定 REST API)、BlueBubbles macOS 服务器安装与配置、获取 Server URL 和密码、OpenClaw 最简配置(baseUrl + password)、DM 与群组访问控制、@ 提及触发、命令前缀触发、打字状态与已读回执、媒体消息处理,以及 macOS 26 Tahoe 上的已知限制。

2026/3/234分钟 阅读ClaudeEagle

想让 AI 助手在 iMessage 里帮你处理消息? BlueBubbles + OpenClaw 是目前最稳定、功能最完整的方案。

为什么选 BlueBubbles?

旧方案(imsg CLI,已弃用): ❌ 不稳定,依赖 macOS AppleScript ❌ 功能有限(只能发送文字) ❌ 每次 macOS 更新都可能失效 新方案(BlueBubbles,推荐): ✅ 稳定的 REST API ✅ 支持消息编辑和撤回(macOS 26 Tahoe 前) ✅ 支持 Tapbacks(❤️👍😂!?) ✅ 支持群组管理 ✅ 支持媒体消息(图片/视频/文件) ✅ 持续维护的开源项目

第一步:安装 BlueBubbles macOS 服务器

BlueBubbles 需要一台始终开机的 Mac,并登录 Apple ID:

1. 下载 BlueBubbles Server: https://bluebubbles.app/downloads/ 2. 安装并启动 BlueBubbles Server 3. 首次运行配置: - 选择服务器模式:Dynamic DNS / ngrok / Cloudflare Tunnel - 设置密码(记住这个密码) - 等待连接成功(底部状态变为绿色) 4. 记录服务器地址(类似 http://localhost:1234 或 https://xxx.ngrok.io)

推荐使用 Cloudflare Tunnel 获得稳定的公网地址:

BlueBubbles Server → Settings → Server URL 配置 选择 Cloudflare Tunnel → 自动生成 HTTPS 地址

第二步:配置 OpenClaw

json
{
  "channels": {
    "bluebubbles": {
      "enabled": true,
      "baseUrl": "http://localhost:1234",
      "password": "your-bluebubbles-password"
    }
  }
}

如果使用远程地址(ngrok/Cloudflare):

json
{
  "bluebubbles": {
    "baseUrl": "https://xxx.trycloudflare.com",
    "password": "your-password"
  }
}

访问控制

DM 私信权限

json
{
  "bluebubbles": {
    "dmPolicy": "allowlist",
    "allowedPhoneNumbers": ["+8613800138000", "+1234567890"]
  }
}

或使用配对模式(首次消息需确认):

json
{ "dmPolicy": "pairing" }

群组访问控制

json
{
  "bluebubbles": {
    "groups": {
      "default": {
        "requireMention": true,
        "mentionTrigger": "@ai"
      }
    }
  }
}

在 iMessage 群组中,需要输入 @ai 才触发 AI 回复。

触发方式

@ 提及触发(推荐用于群组)

群组消息:@ai 帮我总结一下今天的讨论 AI 只在被 @ 时回复,不打扰正常群聊

命令前缀触发

json
{
  "commandPrefix": "!",
  "commands": true
}
!help → AI 列出可用命令 !ask 这段代码是什么意思? → AI 回答

打字状态与已读回执

json
{
  "bluebubbles": {
    "typingIndicator": true,
    "readReceipts": true
  }
}

开启后:

  • AI 处理消息时,对方看到「正在输入...」
  • AI 回复后,消息显示已读状态

媒体消息处理

BlueBubbles 支持接收和发送多媒体:

接收:图片/视频/文件 → AI 分析内容 "帮我看看这张截图,这个错误什么意思?" → AI 分析截图中的错误信息 发送:AI 可以回复文字(媒体发送受 macOS 限制)

macOS 26 Tahoe 的已知限制

⚠️ macOS 26 Tahoe(2025 年发布)已知问题: - 消息编辑功能目前在 macOS 26 上无法正常工作 - 这是 BlueBubbles Server 的已知 bug,正在修复中 - 其他功能(发消息/接消息/Tapbacks)不受影响 关注 BlueBubbles 更新: https://github.com/BlueBubblesApp/bluebubbles-server/releases

VM/无头 macOS 的特殊配置

如果 Mac 以虚拟机或无头方式运行(无显示器), 需要确保 Messages.app 保持活跃:

bash
# 保存以下 AppleScript 为 keep-messages-open.scpt
# tell application "Messages" to activate

# 安装 LaunchAgent 定期运行(防止 Messages.app 被挂起)
# 详见 docs.openclaw.ai/channels/bluebubbles

iMessage vs WhatsApp:哪个更适合你?

对比iMessage + BlueBubblesWhatsApp
平台仅 Apple 生态全平台
需要 Mac✅ 必须❌ 不需要
设置复杂度高(需要 Mac 常开)中(QR 扫码)
国内使用✅ 无封锁⚠️ 部分地区受限
媒体支持✅ 完整✅ 完整

来源:OpenClaw 官方文档 - docs.openclaw.ai/channels/bluebubbles

相关文章推荐

教程OpenClaw 接入 BlueBubbles:iMessage 现代化接入方案完整配置OpenClaw 接入 BlueBubbles iMessage 完整教程:BlueBubbles 服务器安装配置、Webhook 设置、DM 和群组访问控制、打字指示/已读回执、流式分块,以及 VM 无头服务器保持 Messages.app 活跃的 AppleScript 方案。2026/3/2教程OpenClaw iMessage 接入指南:imsg CLI 配置、macOS 权限与 Tailscale 远程部署OpenClaw iMessage 接入教程:imsg CLI 安装与配置、macOS 完全磁盘访问和自动化权限配置、本地/SSH/Tailscale 三种部署模式、专用 Bot macOS 用户隔离方案、访问控制策略、附件 SCP 抓取与故障排查。2026/3/12教程OpenClaw 接入 Zalo:越南最流行即时通讯 AI 助手完全配置指南OpenClaw 接入 Zalo 的完整教程:Zalo Bot API 与 Zalo Personal(个人账号)两种模式详解、插件安装(@openclaw/zalo)、在 Zalo Bot 平台创建 Bot 并获取 Token、最简配置示例、DM 配对与私信权限控制、群组消息处理、Long-polling vs Webhook 两种消息接收方式对比、支持的消息类型(文字/图片/文件/位置)、Zalo Personal QR 码登录方式,以及越南市场 AI 助手的典型使用场景。2026/3/23教程OpenClaw 接入 Mattermost:自托管团队聊天平台的 AI 助手配置完全指南OpenClaw 接入 Mattermost 的完整教程:插件安装方式(openclaw plugins install @openclaw/mattermost)、创建 Mattermost Bot 账户并获取 Token、最简配置(botToken + baseUrl + dmPolicy)、原生斜杠命令注册(oc_* 命令)、频道/群组/私信三种消息模式、线程会话管理、多账户配置、DM 白名单权限控制、交互式按钮支持,以及 Mattermost 与 Slack 的功能对比。2026/3/22教程OpenClaw Canvas 深度指南:让 AI 助手在你眼前渲染可视化内容OpenClaw Canvas 功能完整使用指南:Canvas 是什么(AI 控制的浏览器渲染层)、macOS App 中 Canvas 的开启方式、支持的内容类型(HTML/React 组件/图表/交互式 UI)、通过 SOUL.md 指导 AI 主动使用 Canvas、Canvas 与普通文字回复的使用场景区分、a2ui(自然语言驱动 UI)功能介绍,以及 Canvas 在数据可视化和原型设计中的实战案例。2026/3/18教程OpenClaw macOS 菜单栏 App 完全指南:菜单栏图标、语音唤醒与本地能力OpenClaw macOS 原生应用完整介绍:菜单栏 App 的功能与工作原理(Gateway 管理/权限申请/系统通知)、本地模式 vs 远程模式的区别、LaunchAgent 管理命令、macOS 专属能力(Canvas 画布/截图/摄像头/系统自动化)、语音唤醒配置与使用、Peekaboo Bridge UI 自动化、以及 macOS App 的安装与首次设置流程。2026/3/18