SemibotiMessage 详细配置
通过 BlueBubbles 桥接连接 iMessage，只支持 macOS。
1. 前置准备
你需要一台已经登录 iMessage 的 macOS 设备，并且装好、跑起 BlueBubbles Server（bluebubbles.app）。Semibot 不会直接连 iMessage，而是通过 BlueBubbles 这层桥接去收发消息。
2. 在 Semibot 创建实例
打开 Semibot 配置中心，进入 Bots > 新建，选择 iMessage。填好 bridgeUrl（BlueBubbles 服务地址，比如 http://localhost:1234）；如果你想指定默认发送目标，也可以把手机号或邮箱填到 defaultHandle。选好默认智能体后保存。
3. 配置 BlueBubbles 桥接
在 BlueBubbles Server 设置里，把 Webhook URL 指到：http://<semibot-host>:<port>/v1/integrations/imessage/events/internal，并在请求头里带上 x-semibot-internal-token。Semibot 会定期检查 BlueBubbles 是否在线，出站消息也会通过 BlueBubbles 的发送接口发出去。
4. 联调与验证
先确认 BlueBubbles Server 已经正常运行，再在 Semibot 里点「测试」，看消息能不能发出去。接着通过 iMessage 发一条真消息，到事件中心看有没有入站，再去会话详情确认执行过程和回传结果。常见问题一般是 BlueBubbles 没启动、Webhook 没配好，或者 macOS 这边的 iMessage 账号没登录。顺带提醒一下：iMessage 这里只支持纯文本和文件附件，不支持 Markdown 和消息线程。
FAQ
iMessage 接入为什么要求 macOS？
因为当前是通过 BlueBubbles 桥接 iMessage，而这套链路依赖 macOS 环境和 Apple 设备上的消息能力，所以不能像普通 Web Bot 那样跨平台直接跑。
最常见的接入失败原因是什么？
通常是 BlueBubbles 服务没正常运行、Webhook 没配好，或者 macOS 上的 iMessage 登录状态异常。建议先查 BlueBubbles 健康状态，再检查回调配置。
iMessage 接入适合哪些场景？
如果你的个人工作流或团队沟通本来就在 Apple 生态里，这种接入会比较自然。它更适合特定设备和特定环境，而不是通用公开渠道。