跳转至

iMessage

Note

对于常规的 OpenClaw iMessage 部署,请在同一台已登录 Messages 的 macOS 主机上同时运行 Gateway 和 imsg。如果你的 Gateway 运行在其他位置,请将 channels.imessage.cliPath 指向一个透明的 SSH 包装器,让 imsg 在 Mac 上运行。

入站恢复是自动的。 在 bridge 或 gateway 重启后,iMessage 会重放停机期间错过的消息,并抑制 Apple 在 Push 恢复后可能推送的过时“积压炸弹”,通过去重确保不会重复分发任何消息。无需任何配置即可启用——请参阅 bridge 或 gateway 重启后的入站恢复。

Warning

BlueBubbles 支持已被移除。请将 channels.bluebubbles 配置迁移到 channels.imessage。OpenClaw 现在仅通过 imsg 支持 iMessage。简要通告请从 BlueBubbles 移除与 imsg iMessage 路径开始,完整迁移对照表请参阅 来自 BlueBubbles。

状态:原生外部 CLI 集成。Gateway 启动 imsg rpc 并通过 stdio 进行 JSON-RPC 通信——无需单独的守护进程或端口。强烈建议使用私有 API 模式以获得完整的 iMessage 通道。回复、点按回应、特效、投票、附件回复和群组操作都需要 imsg launch 并成功通过私有 API 检查。

对于常见的本地部署,OpenClaw setup 可以在已登录 Messages 的 Mac 上提供需用户确认的 Homebrew 安装或更新 imsg 选项。手动安装和 SSH 包装器拓扑仍由运维人员自行管理:请在将运行 Gateway 或包装器的同一用户上下文中安装或更新 imsg。

设置

安装插件、配置 imsg,并授予 macOS 权限。

私有 API

禁用 SIP、注入辅助程序,并解锁原生操作。

故障排查

针对静默入站、被忽略的聊天和附件失败的修复方法。

每个页面涵盖的内容

各章节迁移位置

旧版单页版本中的每个章节标题都在此处保留了其锚点,因此诸如 /channels/imessage#troubleshooting 的现有链接仍然可以解析。每个条目都指向当前承载相应内容的页面。

渠道概览

所有支持的渠道。

从 BlueBubbles 迁移

配置转换表和逐步切换步骤。

配对

私信身份验证和配对流程。

表情回应

message 工具的表情回应语义。

群组

群聊行为和提及门控。

渠道路由

消息的会话路由。

配置参考

完整的 iMessage 字段参考。

RPC 适配器

OpenClaw 与 imsg rpc 通信时使用的行分隔 JSON-RPC stdio 协议。

macOS 虚拟机

当希望将 iMessage 与主 Mac 隔离时,可在本地或托管的沙盒 macOS 虚拟机中运行 OpenClaw。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw