核心功能
BlueBubbles Healthcheck 是一套面向 macOS 平台的自动化运维技能，专注于解决 iMessage 网关（BlueBubbles）与 OpenClaw 代理之间的连接故障。该工具通过四步诊断流程（服务器可达性、webhook 注册状态、网关端点响应、近期投递活动）定位问题根源，并具备完整的自愈能力：可自动重启 OpenClaw 网关、清除僵死 webhook 并重注册、验证修复效果。
显著优点
1. 自动化闭环：从诊断到修复全程无需人工介入，特别适合无人值守场景
2. 精准故障定位：针对 BlueBubbles↔OpenClaw 生态的特定失败模式（网关重启断连、指数退避、端口未监听）设计专用检测逻辑
3. 安全沙箱设计：所有交互限制在 127.0.0.1 本地环路，密码字段在日志中脱敏处理
4. 灵活执行模式：支持只读诊断、自动修复、模拟运行（dry-run）三种模式，便于 CI/CD 集成
5. 心跳集成友好：提供标准 HEARTBEAT.md 模板，支持周期性健康巡检
潜在局限与风险
1. 平台绑定：专为 macOS + BlueBubbles + OpenClaw 技术栈设计，无法迁移至其他 iMessage 桥接方案
2. 本地部署限制：设计假设两服务同机运行，不支持远程 BlueBubbles 实例的安全修复
3. 密码存储权衡：webhook URL 需包含明文密码参数以满足 BB→OpenClaw 的认证需求，虽限制在本地但仍存在磁盘持久化风险
4. 依赖外部二进制：需预装 openclaw CLI（非系统自带），缺失时仅能部分修复
5. 权限边界：无法自动启动 BlueBubbles.app 本身，需用户手动介入的场景（应用未运行）只能上报而非自愈
适用人群
- 使用 BlueBubbles + OpenClaw 搭建个人 iMessage 自动化工作流的 macOS 用户
- 需要降低消息网关运维负担的进阶用户或家庭服务器管理员
- 希望将消息通道健康检查纳入定时任务（cron/launchd）的自动化爱好者
常规风险
- 配置泄露风险：
BB_PASSWORD会被写入 BlueBubbles 的 webhook 配置并持久化到磁盘，需确保设备物理安全 - 误修复风险：自动删除并重建 webhook 可能清除 BlueBubbles 端的调试信息，建议配合诊断日志使用
- 网络依赖盲区：仅检测本地端口可达性，无法发现上游网络（如 Apple ID 封禁、iCloud 服务异常）导致的真实投递失败