本页内容
本页内容
主流消息传递
BlueBubbles 的移除与 imsg iMessage 路径
BlueBubbles 的移除与 imsg iMessage 路径
OpenClaw 不再提供 BlueBubbles 通道。 iMessage 支持通过官方 @openclaw/imessage 插件运行:网关在本地或通过 SSH 包装器生成 imsg 作为子进程,并通过 stdin/stdout. 与 JSON-RPC 进行对话,无服务器,无 Webhook,无端口。
如果您的配置仍然包含 channels.bluebubbles,请将其迁移到 channels.imessage。旧版 /channels/bluebubbles 文档 URL 重定向到 ,来自 BlueBubbles,它具有完整的配置转换表和切换清单。
改变了什么
- 支持的 iMessage 路径不再包含 BlueBubbles HTTP server、webhook 路由、REST 密码或 BlueBubbles 插件运行时。
- OpenClaw 通过
imsg在已登录 Messages.app 的 Mac 上读取和监视 Messages。 - 基础发送、接收、历史记录和媒体使用标准
imsg接口和 macOS 权限。 - 高级操作(线程回复、tapback、编辑、撤回、特效、已读回执、输入指示、群组管理)需要私有 API 桥接:运行
imsg launch,这要求关闭 SIP。 - Linux 和 Windows 网关仍然可以使用 iMessage,只需将
channels.imessage.cliPath指向一个 SSH 包装器,由它在已登录的 Mac 上运行imsg。
该怎么做
-
在 Gateway 主机上安装官方插件,然后重启 Gateway:
bash -
在 Messages Mac 上安装并验证
imsg:bash -
为运行
imsg和 OpenClaw 的进程上下文授予“完全磁盘访问权限”和“自动化”权限。 -
转换旧配置:
json5 -
重新启动网关并验证:
bash -
在删除旧的 BlueBubbles 服务器之前,测试您依赖的 DM、群组、附件和任何私人 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 会话键下的对话历史不会迁移过来。
另请参阅
本页有帮助吗?