核心用法
本技能面向 OpenClaw 运维场景，覆盖 Gateway + Mac nodes 的跨设备稳定性治理。用户遭遇「又报错了/审批超时/pairing required/system.run failed」等典型故障时，系统引导执行七步标准化流程：
1. 全量只读体检：openclaw status/security audit/gateway health 等五条命令获取基线状态
2. Node 执行能力诊断：确认 system.run 指令存在，并按 approval timeout → pairing required → system.run unsupported → gateway timeout 顺序归因
3. 强制执行稳定性策略：nodeId 替代 displayName、单节点串行禁用并发、失败重试1次后告警
4. CLI-only Mac 标准化：固定 ws://127.0.0.1:18789 与 openclaw-gateway 的 SSH 目标
5. 变更验收闭环：最小命令验证 + 二次深度状态扫描
6. 结构化输出：可用性判定、成功/失败清单、根因分析、遗留风险、优先级行动建议
7. 对外脱敏：自动过滤 token/key/password/IP/用户名/绝对路径
显著优点
- 防呆设计强制化：将「用 nodeId 不用 displayName」「串行不并发」等易踩坑点写入刚性规则，减少人为遗漏
- 故障归因路径清晰：四层递进式排查（审批→配对→指令支持→网关），缩短 MTTR
- CLI-only 环境兼容：针对无 GUI 的 Mac 节点提供固定模板，降低配置碎片化
- 发布安全闭环：内置脱敏检查清单，阻断敏感信息外泄
潜在缺点与局限性
- 依赖 OpenClaw 专有 CLI：若用户环境未部署或版本差异大，模板可能失效
- Mac-only 场景聚焦：CLI-only 模板未覆盖 Linux/Windows 节点，泛化性有限
- 重试策略单一：固定「1次重试」可能不足以应对网络抖动，需人工介入调整
- 审批超时根因未细化：未区分网络延迟 vs 策略引擎负载 vs 凭证失效，需结合
failure-playbook.md二次诊断
适合人群
- 管理 10+ Mac 节点的 SRE/运维工程师
- 需通过 Gateway 集中纳管异构设备的 DevOps 团队
- 对 CLI-only 环境有合规要求的金融/医疗行业 IT 管理员
常规风险
| 风险类型 | 描述 | 缓释措施 |
|---------|------|---------|
| 凭证泄露 | 调试日志可能残留 token | 强制脱敏检查第7步拦截 |
| 并发执行雪崩 | 误用 displayName 导致多节点误匹配 | 规则3强制 nodeId 绑定 |
| 变更回滚盲区 | 验收通过但隐性依赖未暴露 | 双次 `status --deep` 对比快照 |