如何在Mac mini M4上为OpenClaw接入iMessage

最早折腾OpenClaw接入iMessage时，按照官方文档依葫芦画瓢跑openclaw onboard --install-daemon，结果查日志永远是exited code 1，折腾了两天才发现——问题出在macOS的TCC权限机制上，并非教程本身错了，而是系统变得太严了。这篇笔记把踩过的坑和最终的解决方案完整记录下来，希望能帮到同样在Mac mini M4上碰到这个问题的朋友。

零、为什么官方教程的启动方式无法接入iMessage？

# 此命令无法有效接入iMessage
openclaw onboard --install-daemon

macOS系统对权限的管控越来越紧。

和权限是直接授予“负责进程”的，而不是凭空分配给一个子进程。具体情况是这样的：

• 当你手动在终端里跑 openclaw gateway 时，负责进程是 Terminal.app，子进程（imsg rpc）能继承终端已有的FDA和Automation权限，一切正常。

• 但daemon通过 launchd 启动时，负责进程就变成了 launchd 本身（或包装外壳脚本），而 launchd 压根没有FDA/Automation权限，imsg子进程继承不到，自然启动失败，报错exited code 1——通常是连不上 chat.db 或 Apple Events 被拒。

macOS从Sonoma到Sequoia，对TCC（透明、同意与控制）的检查越来越严格，重启后非GUI启动的进程几乎无法可靠继承权限。onboard --install-daemon 装的服务本质是LaunchAgent（用户级守护进程），登录后自动启动，但没有GUI上下文权限链，所以直接挂了。

说实话，这里被苹果的权限设计搞到有点无奈，但理解了原理就好办。

如果你已经安装了OpenClaw但卡在iMessage接入，可以直接从第三章开始看，重点是第四章——那是真正能解决问题的关键。

一、什么是 OpenClaw？

OpenClaw（原名 clawdbot）是一个完全本地化的开源AI助手，能把各种消息平台（WhatsApp、Telegram、Discord、iMessage等）与AI模型连接起来。所有推理都在本地完成，数据不出设备，适合对隐私敏感的用户。

二、安装 OpenClaw

在终端里跑一行命令就能完成安装（macOS环境）：

curl -fsSL https://openclaw.bot/install.sh | bash

1. 进入配置流程

初次安装后通常会直接进入配置向导。如果没有自动启动，手动输入：

openclaw onboard --install-daemon

基本配置选择：

• Step 1: 同意声明 → 选 Yes
• Step 2: Onboarding Mode → 选 QuickStart

2. 模型配置

需要准备大模型的订阅或API Key。国产模型推荐 MiniMax-M2.1 或 Kimi K2，性价比不错。具体申请方法各家开放平台都有教程，这里不展开。

3. 功能配置

• Step 1: 按需选择 channel——你想在哪个App里跟AI对话（比如选 iMessage）。

• Step 2: 按需配置 Skill（AI的技能）。

• Step 3: 可选启用 Hooks：

  • session-memory：执行 /new 时自动保存会话上下文
  • command-logger：把所有命令记录到日志文件
  • boot-md：网关启动时运行 BOOT.md 脚本

4. 测试对话

输入 openclaw tui，如果能正常对话说明核心配置成功了：

三、接入 iMessage

提前准备：一台Mac + 一部iPhone，且Mac端的「信息」应用已登录iMessage账号。

1. 添加邮箱到 Apple ID

为了让AI不和自己对话（电脑用邮箱发，手机用手机号收），需要给Apple ID添加一个邮箱地址：

1. 在苹果设备上打开「设置」App
2. 点击顶部「Apple ID」
3. 点击「登录与安全性」
4. 在「电子邮件」栏点击「添加电子邮件」
5. 输入邮箱地址并完成验证

2. 在 iMessage 里启用邮箱

1. 在Mac上打开「信息」App
2. 点左上角菜单栏「信息」→「设置」
3. 确保「iMessage 信息」已开启
4. 点击「发送与接收」，确认新添加的邮箱开关已打开

3. 安装核心工具 imsg

imsg是一个CLI工具，用来操作iMessage。在终端依次执行：

# 安装 imsg 工具
brew install steipete/tap/imsg

# 验证安装是否成功
imsg chats --limit 1

4. 手动触发 Automation 权限提示（关键一步）

直接跑一条发送消息的命令，系统会弹出自动化授权弹窗：

imsg send --to "你的手机号或邮箱" --text "测试消息 from imsg CLI"

第一次执行，系统会弹窗问：“Terminal 想控制 Messages.app”，点

。这一步目的是让 imsg 获得操作 Messages.app 的Automation权限。

5. 配置 iMessage 通道

在终端输入配置命令：

openclaw configure

按以下步骤操作：

• Step 1: 「Where will the Gateway run?」→ Local (this machine)
• Step 2: 「Select sections to configure」→ channels
• Step 3: 「Select a channel to configure/link」→ iMessage Local
• Step 4: 「Configure iMessage Local?」→ Skip (lea ve as-is)
• Step 5: 「Finished configuring?」→ Finished
• Step 6: 「DM Access」→ Pairing

6. 修改 iMessage 配置文件

打开OpenClaw的配置文件：

open ~/.openclaw/openclaw.json

找到 channels 下的 imessage 部分，确保内容如下（路径根据实际修改）：

"imessage": {
    "enabled": true,
    "cliPath": "imsg路径",
    "dbPath": "chat.db路径"
}

• imsg路径：终端输入 which imsg，通常返回 /opt/homebrew/bin/imsg 或者真实二进制路径 /opt/homebrew/Cellar/imsg/0.4.0/bin/imsg。
• chat.db路径：在Finder → 菜单栏「前往」→ 按住Option点「资源库」→ 打开Messages文件夹 → 找到chat.db → 右键按住Option → 选择「将…拷贝为路径名称」，一般是 /Users/用户名/Library/Messages/chat.db。

保存文件后重启网关服务：

openclaw gateway restart

7. 授权访问权限

操作完成后，电脑端会弹出权限授权弹窗，点击允许。如果没有弹窗，需要手动给终端添加完全磁盘访问权限：

1. 系统设置 → 隐私与安全性 → 完全磁盘访问权限
2. 点「+」→ 按 ⌘+⇧+G
3. 粘贴 /Applications/Utilities/Terminal.app
4. 点「打开」

四、更换启动方式！【重中之重】

上面配置完成后，如果直接用 openclaw gateway 或 daemon 方式启动，很可能仍然跑不起来。原因前面分析了——daemon没有GUI上下文权限链。正确做法是用

来保持会话。

1. 停止网关

openclaw gateway stop

2. 使用 tmux 启动

tmux是一个终端多路复用器，能让你在后台保持终端会话。用Homebrew安装：

brew install tmux

检查版本：

tmux -V

创建一个新会话（命名为 openclaw-gateway）：

tmux new -s openclaw-gateway

进入tmux后屏幕会变黑（或有绿色边框），底部会出现状态栏。然后在tmux会话里启动OpenClaw网关：

openclaw gateway

这时就可以关闭终端窗口了，进程会在后台继续跑。

3. 配对连接

用手机向iMessage账号（之前配置的邮箱）发送任意消息，系统会返回一个配对码。在终端执行（将 <配对码> 替换为实际收到的码）：

openclaw pairing approve imessage <配对码>

4. 确认配置状态

在OpenClaw的Channels界面查看，应该显示为 OK 状态。

5. 开始对话

配对完成后，通过iMessage向自己的邮箱发消息，AI就会回复了。

五、为什么不能用 daemon 启动

这里把两种启动方式的优劣整理成对比表，一目了然：

方面	tmux	launchd daemon (OpenClaw 的 --install-daemon)
主要目的	终端多路复用器，创建可分离/重连的完整终端会话	系统级服务管理器，让进程作为“服务”自动启动、监控、重启
后台持久性	优秀：detach 后进程继续跑，关终端/SSH/重启可重连，但重启Mac需手动attach	最佳：开机/登录自动启动，进程崩溃可配置自动重启，真正“set it and forget it”
能否交互/查看输出	可以：随时 attach 进去，像正常终端一样看日志、输入命令	不能直接交互：日志去文件或系统日志，需 tail 或 openclaw logs 查看
重启Mac后行为	不自动：需手动 tmux attach（可写脚本加到登录项）	自动：登录后 launchd 立刻启动
崩溃恢复	无自动：crash 了就没了，得手动重启	可配置：launchd 支持 KeepAlive=true 自动重启
权限继承（TCC）	好：从 shell 继承 Full Disk Access / Automation → imsg 通道稳	差：launchd 启动不带 GUI 上下文，容易丢权限 → imsg rpc exited code 1
资源占用	中等：tmux 服务本身小，但多会话会多占点	低：launchd 是系统内置
适合场景	开发/测试/需要查看日志的长期进程（如你的 gateway）	生产级、无人值守、开机自启的服务（但macOS TCC坑多）
缺点	重启Mac后要手动 attach（可自动化）	TCC权限不继承 → iMessage通道常掉，重启后Running: No

简单说：tmux 方式虽然重启后需要手动激活，但它完美绕过了launchd的权限继承缺陷，是目前在Mac mini M4上稳定使用OpenClaw + iMessage的最可靠方案。