Messages 必须已登录
像电话卡真的插在那台 Mac 里，不然 imsg 没东西可控制。
Channels 导读
iMessage 接入：旧通道，新用户请走 BlueBubbles
这是基于 `imsg` 的旧版 iMessage 通道，新部署请直接用 BlueBubbles。配置核心是填对 `cliPath` 和 `dbPath`，首次配对需在 1 小时内用 `openclaw pairing approve` 批准。最容易踩坑的是 macOS 权限：必须给运行 gateway 的进程上下文授予“完全磁盘访问”和“自动化”权限，且需在相同上下文先跑一次 `imsg chats --limit 1` 触发授权弹窗。
先讲这一页到底在解决什么
iMessage 接入：旧通道，新用户请走 BlueBubbles
这是基于 `imsg` 的旧版 iMessage 通道，新部署请直接用 BlueBubbles。配置核心是填对 `cliPath` 和 `dbPath`，首次配对需在 1 小时内用 `openclaw pairing approve` 批准。最容易踩坑的是 macOS 权限：必须给运行 gateway 的进程上下文授予“完全磁盘访问”和“自动化”权限，且需在相同上下文先跑一次 `imsg chats --limit 1` 触发授权弹窗。
第一站
🍎 这条路最核心的现实条件只有一句：Messages 得真登录在那台 Mac 上
没有这块地基，后面配置再漂亮都只是空房子。
Full Disk Access
像给工具人进资料室的门卡，不然它连消息数据库都看不到。
Automation 权限
像允许这个工具人去按 Messages 的按钮，不然它不能代发消息。
一句话
iMessage 这条路最怕的不是配置错，而是那台 Mac 根本没被授权好。
第二站
🧰 Local Mac 和 Remote Mac 的区别，其实只是“工具人住你身边，还是住在远方的那台 Mac 上”
世界观没变，跑腿地点变了。
🏠 Local Mac
像工具人就在你屋里，直接调用本机的 imsg。
🌐 Remote Mac over SSH
像你写了个 wrapper，让命令先 SSH 过去，再让远方那台 Mac 上的 imsg 跑腿。
exec ssh -T gateway-host imsg \"$@\"这行脚本翻成人话就是：“我不在本地跑，所有跑腿动作都转交给远方那位 Mac 助手。”
remoteHost像写明远方那位工具人住哪儿，附件也要靠这个地址去拿。
第三站
👥 群聊这块最要命的一句是：iMessage 没有原生 mention 元数据，所以你得靠模式识别“别人是不是在喊我”
这就是为什么 mentionPatterns 在这里格外重要。
🚫 没有原生 @ 提示
不像 Discord / Telegram 那样会明确告诉你“它被提到了”。
🔤 要靠 regex 模式
像给 OpenClaw 一张“别人可能会怎么喊我”的小抄。
📋 groupPolicy / groupAllowFrom
先管这群和这些人能不能叫，再管有没有真的点名叫到它。
🎈 一句话
iMessage 群聊里最重要的不是 bot 权限，而是“识别点名”的耳朵。