iMessage

状态：原生外部 CLI 集成。Gateway 会生成 imsg rpc 并通过 stdio 使用 JSON-RPC 通信——没有单独的守护进程或端口。强烈建议使用私有 API 模式以获得完整的 iMessage 通道。回复、轻点回应、效果、投票、附件回复和群组操作需要 imsg launch 以及成功的私有 API 探测。

对于常见的本地设置，OpenClaw 设置可以提供用户确认的 Homebrew 安装或更新，用于在已登录 Messages 的 Mac 上安装或更新 imsg。手动设置和 SSH 包装器拓扑仍由操作员管理：请在将运行 Gateway 或包装器的同一用户上下文中安装或更新 imsg。

设置

安装插件，设置 imsg，并授予 macOS 权限。

私有 API

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

故障排除

解决入站静默、聊天被忽略和附件失败的问题。

每个页面涵盖的内容¶

• iMessage 设置 — 安装插件，在 Messages Mac 上设置 imsg，并授予完全磁盘访问权限和自动化权限。
• 启用 imsg 私有 API — SIP 和库验证流程、辅助程序注入，以及当 SIP 保持开启时仍可用的功能。
• iMessage 访问控制和路由 — DM 和群组策略、提及门控、按组提示、ACP 绑定和配置写入。
• iMessage 部署模式 — 专用机器人 macOS 用户、通过 Tailscale 的远程 Mac、多账户和 DM 历史。
• iMessage 媒体和附件 — 附件摄取和暂存、出站分块以及投递目标格式。
• iMessage 私有 API 操作 — 轻点回应、线程回复、效果、原生投票、审批控制和提问反应。
• iMessage 消息行为 — 拆分发送 DM 的合并以及重启后的自动入站恢复。
• iMessage 故障排除 — 以症状为先的修复以及配置参考链接。

每个章节迁移到了哪里¶

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

• 安装插件
• 快速设置
• 要求和权限（macOS）
• 启用 imsg 私有 API
• 设置
• 当 SIP 保持启用时
• 访问控制和路由
• ACP 会话绑定
• 部署模式
• 媒体、分块和投递目标
• 私有 API 操作
• 配置写入
• 合并拆分发送的 DM（命令 + URL 在一个组合中）
• 合并拆分发送的 DM（命令 + URL 在一个组合中）
• 桥接器或 Gateway 重启后的入站恢复
• 操作员可见信号
• 迁移
• 故障排除
• 配置参考指针
• 要求和权限（macOS）
• 媒体、分块和投递目标
• 合并拆分发送的 DM（命令 + URL 在一个组合中）
• 本地 Mac（快速路径）
• 安装并验证 imsg
• 配置 OpenClaw
• 启动 Gateway
• 批准首次 DM 配对（默认 dmPolicy）
• 通过 SSH 的远程 Mac
• SSH 包装器发送失败，出现 AppleEvents -1743
• DM 策略
• 群组策略 + 提及
• 会话和确定性回复
• 专用机器人 macOS 用户（独立 iMessage 身份）
• 通过 Tailscale 的远程 Mac（示例）
• 多账户模式
• 私信历史
• 附件和媒体
• 出站文本和分块
• 寻址格式
• 可用操作
• 消息 ID
• 能力检测
• 已读回执和正在输入
• 入站轻点回应
• 审批投票和反应
• 提问反应（1️⃣ / 2️⃣ / 3️⃣ / 4️⃣）
• 未找到 imsg 或 RPC 不受支持
• 消息可以发送，但入站 iMessage 未到达
• Gateway 未在 macOS 上运行
• DM 被忽略
• 群组消息被忽略
• 远程附件失败
• 错过了 macOS 权限提示

相关¶

频道概览

所有受支持的频道。

从 BlueBubbles 迁移

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

配对

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

反应

message 工具的 emoji 反应语义。

群组

群聊行为和提及门控。

频道路由

消息的会话路由。

配置参考

完整的 iMessage 字段参考。

RPC 适配器

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

macOS 虚拟机

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