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 权限。
禁用 SIP、注入辅助程序,并解锁原生操作。
针对静默入站、被忽略的聊天和附件失败的修复方法。
每个页面涵盖的内容¶
- iMessage 设置 — 安装插件,在 Messages Mac 上配置
imsg,并授予完全磁盘访问权限和自动化权限。 - 启用 imsg 私有 API — SIP 与库验证流程、辅助程序注入,以及 SIP 保持开启时仍然可用的功能。
- iMessage 访问控制与路由 — 私聊与群组策略、提及门控、按群组提示、ACP 绑定和配置写入。
- iMessage 部署模式 — 专用机器人 macOS 用户、通过 Tailscale 连接远程 Mac、多账号和私聊历史。
- iMessage 媒体与附件 — 附件摄取与暂存、出站分块和投递目标格式。
- iMessage 私有 API 操作 — 点按回应、线程回复、特效、原生投票、审批控制和问答反应。
- iMessage 消息行为 — 拆分发送私聊合并,以及重启后的自动入站恢复。
- iMessage 故障排查 — 以症状为先的修复方法和配置参考链接。
各章节迁移位置¶
旧版单页版本中的每个章节标题都在此处保留了其锚点,因此诸如 /channels/imessage#troubleshooting 的现有链接仍然可以解析。每个条目都指向当前承载相应内容的页面。
- 安装插件
- 快速设置
- 要求与权限(macOS)
- 启用 imsg 私有 API
- 设置
- SIP 保持开启时
- 访问控制与路由
- ACP 会话绑定
- 部署模式
- 媒体、分块与投递目标
- 私有 API 操作
- 配置写入
- 合并拆分发送的私聊(命令 + URL 合为一条消息)
- 合并拆分发送的私聊(命令 + URL 合为一条消息)
- bridge 或 gateway 重启后的入站恢复
- 运维人员可见信号
- 迁移
- 故障排查
- 配置参考指引
- 要求与权限(macOS)
- 媒体、分块与投递目标
- 合并拆分发送的私聊(命令 + URL 合为一条消息)
- 本地 Mac(快速路径)
- 安装并验证 imsg
- 配置 OpenClaw
- 启动 Gateway
- 批准首次私聊配对(默认 dmPolicy)
- 通过 SSH 连接远程 Mac
- SSH 包装器发送失败并报 AppleEvents -1743
- 私聊策略
- 群组策略 + 提及
- 会话与确定性回复
- 专用机器人 macOS 用户(独立的 iMessage 身份)
- 通过 Tailscale 连接远程 Mac(示例)
- 多账号模式
- 私聊历史
- 附件与媒体
- 出站文本与分块
- 寻址格式
- 可用操作
- 消息 ID
- 能力检测
- 已读回执与正在输入状态
- 入站点按回应
- 审批投票与反应
- 问答反应(1️⃣ / 2️⃣ / 3️⃣ / 4️⃣)
- 找不到 imsg 或 RPC 不受支持
- 消息可发送但入站 iMessage 未到达
- Gateway 未在 macOS 上运行
- 私聊被忽略
- 群组消息被忽略
- 远程附件失败
- 错过了 macOS 权限提示
相关¶
所有支持的渠道。
配置转换表和逐步切换步骤。
私信身份验证和配对流程。
message 工具的表情回应语义。
群聊行为和提及门控。
消息的会话路由。
完整的 iMessage 字段参考。
OpenClaw 与 imsg rpc 通信时使用的行分隔 JSON-RPC stdio 协议。
当希望将 iMessage 与主 Mac 隔离时,可在本地或托管的沙盒 macOS 虚拟机中运行 OpenClaw。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw