OpenClaw 已移除内置的 BlueBubbles 通道，所有 iMessage 支持改为通过 imessage 插件本地或 SSH 调用 imsg 实现。如果你之前使用 BlueBubbles 通道，需要把 channels.bluebubbles 改为 channels.imessage，并在签名 iMessage 的 Mac 上安装 imsg、授予全盘访问和自动化权限；旧 BlueBubbles 会话密钥不继承，但配对审批按句柄延续。完成配置后运行 openclaw channels status --probe 验证连接。

OpenClaw BlueBubbles 移除怎么迁移到 iMessage

OpenClaw 不再提供 BlueBubbles 通道。iMessage 支持现在由内置的 imessage 插件驱动，该插件在本地或通过 SSH 包装启动 imsg，并通过 stdin/stdout 使用 JSON-RPC 通信。

如果你的配置中仍有 channels.bluebubbles，请迁移到 channels.imessage。旧的 /channels/bluebubbles 文档 URL 会重定向到 从 BlueBubbles 迁移，那里有完整的配置翻译表和切换核对清单。

哪些地方变了

• 在 OpenClaw 官方支持的 iMessage 路径中，不再有 BlueBubbles HTTP 服务器、webhook 路由、REST 密码或 BlueBubbles 插件运行时。
• OpenClaw 通过 Mac 上已登录 Messages.app 的 imsg 读取和监控消息。
• 基础的发送、接收、历史记录和媒体使用 imsg 的标准 API 与 macOS 权限。
• 高级操作（如线程回复、tapbacks、编辑、撤回、特效、已读回执、打字指示器和群组管理）需要 imsg launch 配合可用的私有 API 桥。
• Linux 和 Windows 网关仍可使用 iMessage：将 channels.imessage.cliPath 设置为一个 SSH 包装器，该包装器在已登录 iMessage 的 Mac 上运行 imsg。

迁移步骤

1. 在 iMessage Mac 上安装并验证 imsg：

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

2. 授予权限：为运行 imsg 和 OpenClaw 的进程上下文授予全盘访问和自动化权限（系统设置 → 隐私与安全性）。

3. 转换旧配置：将 channels.bluebubbles 替换为以下格式：

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

   根据你的实际号码和策略调整字段。

4. 重启网关并验证：

   openclaw channels status --probe

5. 在删除旧 BlueBubbles 服务器前测试：测试私信、群组、附件以及依赖的任何高级操作是否正常。

迁移注意事项

• channels.bluebubbles.serverUrl 和 channels.bluebubbles.password 在 iMessage 中无对应项。
• channels.bluebubbles.allowFrom、groupAllowFrom、groups、includeAttachments、附件根目录、媒体大小限制、分块和行为开关等都有对应的 iMessage 等效字段。
• channels.imessage.includeAttachments 默认关闭，如果你需要接收入站图片、语音备忘录、视频或文件，请显式设为 true。
• 使用 groupPolicy: "allowlist" 时，请复制旧的 groups 块，包括通配符 "*" 条目。群组发送者白名单和群组注册是独立的两道门。
• 旧 ACP 绑定中 channel: "bluebubbles" 必须改为 channel: "imessage"。
• 旧的 BlueBubbles 会话密钥不会变为 iMessage 会话密钥。配对审批按句柄延续，但 BlueBubbles 会话密钥下的聊天历史不会继承。

常见问题

迁移后 OpenClaw 收不到 iMessage 怎么办？

先检查 imsg 是否正常：运行 imsg chats --limit 3 看看能否列出聊天列表。再确认 OpenClaw 配置中 cliPath 路径正确，且运行 OpenClaw 的进程有全盘访问和自动化权限。最后用 openclaw channels status --probe 诊断通道连接状态。

Linux/Windows 网关能用 iMessage 吗？

可以，但需要一台已登录 iMessage 的 Mac 作为中转。将 channels.imessage.cliPath 设置为一个 SSH 包装脚本，让远程 Mac 执行 imsg 命令，并将 stdin/stdout 流返回给 OpenClaw。权限和 imsg 安装仍在该 Mac 上完成。

旧 BlueBubbles 配置里的 serverUrl 和 password 怎么处理？

这两个字段在 iMessage 通道中没有对应项，直接删除。OpenClaw 不再需要连接 BlueBubbles HTTP 服务器，所有交互通过 imsg 的 JSON-RPC 进行。