BlueBubbles 移除与 imsg iMessage 路径¶

OpenClaw 不再附带 BlueBubbles 通道。iMessage 支持通过官方 @openclaw/imessage 插件运行：Gateway 会将 imsg 作为子进程启动，可在本地或通过 SSH 包装器运行，并通过 stdin/stdout 使用 JSON-RPC 通信。无需服务器、无需 webhook、无需端口。

如果你的配置中仍包含 channels.bluebubbles，请将其迁移到 channels.imessage。旧版 /channels/bluebubbles 文档 URL 会重定向到 来自 BlueBubbles，其中包含完整的配置转换表和切换检查清单。

变更内容¶

• 受支持的 iMessage 路径没有 BlueBubbles HTTP 服务器、webhook 路由、REST 密码或 BlueBubbles 插件运行时。
• OpenClaw 通过 imsg 在已登录 Messages.app 的 Mac 上读取和监视信息。
• 基本的发送、接收、历史记录和媒体功能使用常规的 imsg 接口和 macOS 权限。
• 高级操作（线程回复、轻点回反应、编辑、撤回、效果、已读回执、正在输入指示器、群组管理）需要私有 API 桥接：运行 imsg launch，这需要禁用 SIP。
• Linux 和 Windows Gateway 仍可通过将 channels.imessage.cliPath 指向一个 SSH 包装器来使用 iMessage，该包装器会在已登录的 Mac 上运行 imsg。

操作指南¶

1. 在 Gateway 主机上安装官方插件，然后重启 Gateway：

openclaw plugins install @openclaw/imessage

1. 在已登录 Messages 的 Mac 上安装并验证 imsg：

brew install steipete/tap/imsg
imsg --version
imsg chats --limit 3
imsg rpc --help

1. 为运行 imsg 和 OpenClaw 的进程上下文授予完全磁盘访问权限和自动化权限。

2. 转换旧配置：

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/opt/homebrew/bin/imsg",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
      includeAttachments: true,
    },
  },
}

1. 重启 Gateway 并验证：

openclaw channels status --probe

1. 在删除旧的 BlueBubbles 服务器之前，测试私信、群组、附件以及你依赖的任何私有 API 操作。

迁移说明¶

• channels.bluebubbles.serverUrl 和 channels.bluebubbles.password 没有对应的 iMessage 配置；没有可连接或认证的服务器。
• allowFrom、groupAllowFrom、groups、includeAttachments、attachmentRoots、mediaMaxMb、textChunkLimit 和 actions.* 在 channels.imessage 下保持其含义。
• channels.imessage.includeAttachments 默认仍然关闭。如果你期望入站照片、语音备忘录、视频或文件到达代理，请显式设置它。
• 使用 groupPolicy: "allowlist" 时，复制旧的 groups 块，包括任何 "*" 通配符条目。群组发送者允许列表和群组注册表是独立的门控；如果 groups 块有条目但没有匹配的 chat_id（或没有 "*"），消息会在运行时被丢弃；即使发送者过滤仍允许消息通过，空的 groups 块也会记录启动警告。
• 具有 match.channel: "bluebubbles" 的 ACP 绑定必须更改为 "imessage"。
• 旧的 BlueBubbles 会话密钥不会变成 iMessage 会话密钥。配对审批以发送者句柄为键，因此复制的 allowFrom 条目仍可工作，但 BlueBubbles 会话密钥下的对话历史不会迁移。

另请参阅¶

• 来自 BlueBubbles
• iMessage
• 配置参考 - iMessage