（7797期）Bluebubbles Healthcheck – iMessage 网关故障自愈专家

iMessage 网关故障自愈专家 自动化诊断与修复 BlueBubbles 与 OpenClaw 之间的 iMessage 连接中断问题，支持 webhook 故障自愈与网关重启。 使用说明 核心功能 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 指向非信任网络地址。 原始说明 Diagnoses and auto-heals BlueBubbles ↔ OpenClaw iMessage connectivity. Use when: iMessages stop arriving after a gateway restart, webhook connection is broke...