BlueBubbles

这就像给你的智能助手一个魔法电话，让它能通过你电脑上的 BlueBubbles 软件，看到和回复 iMessage 短信。BlueBubbles 软件就是那个“电话听筒”。

第一步：准备好你的“电话听筒”（BlueBubbles）

1. 首先，你要在你的苹果电脑上安装 BlueBubbles 软件。就像安装一个新游戏一样，去它的网站（bluebubbles.app/install）按照说明做。
2. 安装好后，打开 BlueBubbles 的设置，找到“网络 API”并把它打开，然后设置一个密码。这个密码很重要，就像你家的门锁密码。

第二步：告诉你的智能助手怎么用这个“电话” 3. 现在，告诉你的智能助手（OpenClaw）去连接这个“电话听筒”。最简单的方法是打开一个叫“终端”的窗口，输入 openclaw onboard 命令，然后跟着屏幕上的提示选 BlueBubbles。 4. 你需要告诉它三样东西： * 服务器地址：就是你的 BlueBubbles 软件在你家网络里的“门牌号”，比如 http://192.168.1.100:1234。 * 密码：就是你刚才在 BlueBubbles 里设置的那个密码。 * Webhook 路径：这是一个特别的“收件箱”地址，可以就用默认的 /bluebubbles-webhook。 5. 最后，你还要回到 BlueBubbles 软件里，告诉它把收到的消息送到智能助手的那个“收件箱”地址去。地址看起来像这样：https://你的网关地址:3000/bluebubbles-webhook?password=<你的密码>。

重要提醒：安全第一！

• 一定要设置密码！没有密码，坏消息可能会溜进来。
• 这个密码检查发生在智能助手看消息内容之前，所以很安全。

如果你的电脑是“无头”的（比如一直开着的服务器电脑） 有时候，电脑上的“信息”App 会偷偷睡着，收不到新消息。我们需要每隔 5 分钟轻轻“戳”它一下，让它保持清醒。

1. 制作一个“戳一戳”小脚本：把一段特别的“苹果脚本”代码保存到电脑里一个叫 ~/Scripts/poke-messages.scpt 的文件里。这段代码会轻轻打开“信息”App 看看，但不会打扰你。
2. 设置一个“定时戳”任务：再把另一段代码保存到 ~/Library/LaunchAgents/com.user.poke-messages.plist 这个文件里。这个文件会告诉电脑：“每隔 300 秒（就是 5 分钟），自动运行一次那个‘戳一戳’脚本。”
3. 启动任务：最后，在“终端”里输入 launchctl load ~/Library/LaunchAgents/com.user.poke-messages.plist 这个命令，定时任务就开始啦！

• 注意：第一次运行可能会弹出一个窗口问“是否允许”，记得点“允许”哦。

谁可以和智能助手聊天？

• 和一个人聊天：默认需要“配对”。陌生人发消息来，会得到一个配对码，等你用 openclaw pairing approve bluebubbles <配对码> 命令批准后，才能开始聊天。
• 在群里聊天：默认是“允许名单”模式。只有在名单里的人（比如 +15555550123 这个号码）在群里说话，智能助手才会回应。你还可以设置，在群里必须@提到智能助手，它才会说话。

智能助手能做什么？ 它能做很多酷酷的事情！比如：

• 自动显示“正在输入…”和“已读”标记。
• 对消息点“赞”（发送 tapback 反应）。
• 编辑或撤回已发送的消息（需要 macOS 13 以上，但目前在 macOS 26 上编辑功能坏了）。
• 用特效发送消息（比如“震撼”效果）。
• 管理群聊：改名、换头像、加人、踢人、自己退群。
• 发送图片、文件，甚至能把 MP3 音频变成语音备忘录发送！ 不过，有些高级功能（比如编辑消息、换群头像）在最新的 macOS 26 系统上可能不太灵，要小心。

一些小贴士和限制

• 智能助手发送很长的消息时，可能会把它切成几段发，每段最多 4000 个字。
• 发送的图片、视频等文件不能太大，默认不能超过 8 MB。
• 如果用了“无头”电脑，记得设置“定时戳”任务，不然信息 App 会睡着。
• 如果功能突然不工作了，可以检查密码对不对，或者用 openclaw status --all 命令看看健康状态。