零、为什么官方教程的启动方式无法接入iMessage？！
# 此命令无法有效接入iMessage
openclaw onboard --install-daemon
因为macOS系统权限收紧，Full Disk Access (FDA)无法给imsg权限，只能给Terminal权限，FDA 只对 Terminal 有效。
Full Disk Access (FDA)和 Automation权限是给负责进程（responsible process）的。
你手动在 Terminal 跑 openclaw gateway 时：负责进程是 Terminal.app → 子进程（imsg rpc）继承权限 → 一切正常。
但 daemon 用 launchd 启动时：负责进程是 launchd 本身（或 gateway 的 wrapper shell/node）→ launchd 没有FDA/Automation → imsg 子进程继承不到权限 → 启动失败，exited code 1（通常是 permission denied on chat.db 或 Apple Events）。
macOS（Sonoma/Sequoia）对 TCC 很严，重启后这些权限不总是可靠继承，尤其是非 GUI 启动的进程。
onboard --install-daemon 装的服务就是 LaunchAgent（用户级 daemon），它在登录后自动起，但不带 GUI 上下文的权限链。
在这里谴责一下Apple！！！折腾了我两天！
如果小伙伴已经安装过openclaw，但是卡在接入iMessage，直接跳转第三章开始，重中之重是第四章！
一、什么是 OpenClaw？
OpenClaw（原 clawdbot） 是一个开源的 AI 助手，完全本地化 ，可以将各种消息平台与 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】
直接去相关AI的开放平台有详细教程，这里不做过多讲解
3.功能配置
Step 1: 按需选择 channel（需要在什么 App 中进行对话）
Step 2: 按需配置 Skill
Step 3: 按需启用 Hooks（可选）：
💾 session-memory: 执行
/new时自动保存会话上下文📝 command-logger: 记录所有命令到日志文件
🚀 boot-md: 网关启动时运行 BOOT.md
4.测试对话
输入 openclaw tui，若成功对话则表示配置成功：
三、接入 iMessage
需要准备：Mac 电脑 + iPhone，且 Mac 端「信息 (Messages)」应用需完成登录。
1.添加邮箱到 Apple ID
电脑需用邮箱登录 iMessage（手机上则是用手机号发送信息），防止自己和自己陷入循环对话。若之前 Apple ID 没有添加邮箱：
在苹果设备上打开「设置」App
点击顶部「Apple ID」
点击「登陆与安全性」
在「电子邮件」栏点击「添加电子邮件」
输入邮箱地址并按提示完成验证
2.在 iMessage 里启用邮箱
在 Mac 上打开「信息」App
在左上方菜单栏点击「信息」→「设置」
开启「iMessage 信息」
点击「发送与接收」
确保新添加的邮箱开关已打开
3.安装核心工具 imsg
打开 Mac 终端，依次执行以下命令：
# 安装 imsg 工具
brew install steipete/tap/imsg
# 验证安装是否成功
imsg chats --limit 1
4.手动触发 Automation 权限提示（关键一步！）
打开终端，跑下面命令（这些会尝试发消息，会强制弹出 Automation 授权，这会触发 Automation 给 Messages.app）
imsg send --to "你的手机号或邮箱" --text "测试消息 from imsg CLI"
第一次跑这个，系统应该弹出弹窗：Terminal 想控制 Messages.app → 允许
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 (leave as-is)
Step 5: 「Finished configuring?」→ Finished
Step 6: 「DM Access」→ Pairing
6.修改 iMessage 配置文件
打开配置文件：
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/imsgchat.db 路径: Finder → 菜单栏「前往」→ 按住 Option 点击「资源库」→ 打开 Messages 文件夹 → 找到 chat.db → 右键按住 Option → 选择「将…拷贝为路径名称」，通常是
/Users/用户名/Library/Messages/chat.db
保存后重启网关服务：
openclaw gateway restart
7.授权访问权限
操作完成后，电脑端会弹出访问权限授权弹窗，点击「允许」。如果没有弹窗，需要手动授权。打开终端的完全磁盘访问权限：
系统设置 → 隐私与安全性 → 完全磁盘访问权限
点「+」→ 按 ⌘+⇧+G
粘贴
/Applications/Utilities/Terminal.app点「打开」
四、更换启动方式！【重中之重】
1.停止网关
openclaw gateway stop
2.使用tmux启动
安装 tmux（用 Homebrew，最推荐）：
brew install tmux
安装完后，检查版本：
tmux -V
安装后使用 tmux 启动：
tmux new -s openclaw-gateway
成功进入 tmux 会话（屏幕会变黑或有绿色边框，底部有状态栏）。
然后在里面跑，可以关闭命令窗口
3.配对连接
用手机给 iMessage 账号（即前面配置的邮箱）发消息，会收到一个配对码。在终端执行以下配对命令（将 <配对码>替换为收到的配对码）：
openclaw pairing approve imessage <配对码>
4.openclaw后配置显示ok
在Channels界面查看配置情况：
5.开始对话
配对完成后，您就可以通过 iMessage 与 openclaw进行对话了！
五、为什么不能用daemon启动
我一开始在这里卡了很久！问了很多AI都没有解决我的问题，最后问到了Grok，还是有实力的！感谢马老板！
