核心功能
BlueBubbles Healthcheck 是一款专门解决 iMessage 网关连接故障的诊断与自愈工具，针对 BlueBubbles 服务器与 OpenClaw 平台之间的 webhook 通信失效问题提供自动化修复方案。
诊断流程
该技能执行 4 步系统性检测：验证 BlueBubbles 服务器可达性、检查 webhook 注册状态、确认 OpenClaw 网关端点响应性、分析近期 webhook 投递活动。诊断脚本（diagnose.sh）以退出码 0 表示健康状态，便于集成到自动化监控流程。
自动修复机制
当检测到故障时，heal.sh 执行分层修复策略：若网关服务异常则触发 openclaw gateway restart；若 webhook 进入退避状态或配置陈旧，则调用 reset-webhook.sh 完成原子化的删除-重注册操作；最终重新运行诊断验证修复效果。支持 --dry-run 模式预览操作而不实际执行。
显著优点
- 故障精准定位：覆盖网关层、传输层、应用层的三维检测体系
- 零配置自愈：自动处理最常见的三种故障模式（网关重启断连、BB 退避冻结、服务未运行）
- 安全设计：webhook URL 中的密码参数用于 BB→OpenClaw 双向认证，且限定 localhost 通信
- 生态集成：原生支持 OpenClaw CLI，可嵌入 HEARTBEAT.md 实现 4 小时周期巡检
局限性与风险
- 平台锁定：专为 macOS + BlueBubbles + OpenClaw 技术栈设计，无跨平台移植性
- 本地执行依赖：要求 BB 与 OpenClaw 同机部署，不支持远程 BB 实例（安全设计所致）
- 密码持久化风险：
BB_PASSWORD将以明文形式存储于 BlueBubbles 的 webhook 配置文件 - 手动干预边界：BlueBubbles.app 未运行等系统级故障无法自动修复，需用户介入
- 供应链信任：依赖
openclaw二进制执行网关重启，需确保二进制来源可信
适用人群
- 使用 OpenClaw 自动化框架的 iMessage 场景开发者
- 需要高可用 iMessage 网关的 macOS 自动化运维人员
- 已将 BlueBubbles 集成至工作流且需降低人工排障成本的技术用户
常规风险提示
建议在测试环境验证 --dry-run 输出后再部署至生产；定期检查 BlueBubbles 配置文件权限（建议 0600）；避免将 BB_URL 指向非信任网络地址。