OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

概览

BlueBubbles removal and the imsg iMessage path

BlueBubbles removal and the imsg iMessage path

OpenClaw 不再提供 BlueBubbles 渠道。iMessage 支持通过内置的 imessage 插件实现：Gateway 网关在本地或通过 SSH 包装器将 imsg 作为子进程启动，并通过 stdin/stdout 使用 JSON-RPC 通信。无需服务器、webhook 或端口。

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

变更内容

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

操作步骤

  1. 在运行“信息”的 Mac 上安装并验证 imsg：

    bash
    brew install steipete/tap/imsgimsg --versionimsg chats --limit 3imsg rpc --help

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

  3. 转换旧配置：

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

  4. 重启 Gateway 网关并验证：

    bash
    openclaw channels status --probe

  5. 删除旧 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 会话键下的对话历史记录不会迁移。

另请参阅

Was this useful?
On this page

On this page