核心用法
OpenClaw Operations 是一个面向 OpenClaw Gateway 运维人员的诊断与维护技能，严格限定两大场景：救援（Gateway 宕机） 与 健康检查（Gateway 运行中）。技能遵循「诊断→判断→行动→验证」的四步原则，禁止跳过任何环节。
救援场景（Rescue）
1. 状况评估：检测平台（Linux systemd/macOS launchd）、进程状态、端口监听
2. 日志分析：通过 journalctl（Linux）或 ~/.openclaw/logs/（macOS）定位崩溃根因，内置常见故障对照表（EADDRINUSE、ENOMEM、SyntaxError、MODULE_NOT_FOUND 等）
3. 配置修复：强制备份后校验 JSON 语法，修复 schema 错误，同步环境变量与令牌
4. 资源检查：磁盘、内存、Node.js 可用性
5. 重启验证：仅修复根因后重启，最终通过 openclaw doctor --non-interactive 确认恢复
健康检查场景（Health Check）
- 使用
openclaw doctor [--fix|--deep|--non-interactive]进行交互式或自动化巡检 - 升级管理：版本比对 → 备份 → npm update → 重启 → 差异对比 → 支持一键回滚
- 清理维护：会话转录本归档、孤立文件清理、30 天+旧文件安全删除
- 备份策略：完整备份配置、密钥、代理数据、服务单元文件至时间戳目录
- Tailserve 检测：验证反向代理状态与本地连通性
显著优点
- 平台覆盖完整：原生适配 Linux（systemd）与 macOS（launchd），命令自动区分
- 故障定位精准：日志关键词过滤 + 结构化故障对照表，缩短 MTTR
- 安全约束严格：强制备份、JSON 校验、禁止打印密钥、破坏性操作需确认
- 回滚机制成熟：升级前后 doctor 基线对比，版本与配置双重回滚能力
- 非侵入式设计：明确排除日常业务配置、Agent 行为调优、首次部署等场景，避免误用
潜在局限
- 平台局限：仅支持 Linux 与 macOS，Windows 服务管理未覆盖
- 权限假设：依赖
--user级 systemd 或 GUI 级 launchd，系统级安装需手动适配 - 网络诊断薄弱：对上游 API 连通性仅提示检查，无内置 traceroute/curl 深度探测
- 日志持久化：macOS 统一日志（
log show）需额外权限，部分环境可能受限
适合人群
- OpenClaw Gateway 自托管运维人员
- 需要 7×24 保障网关可用性的平台工程师
- 熟悉 shell 与 systemd/launchd 的 Linux/macOS 系统管理员
常规风险
- 配置误修复：JSON 语法错误可能导致服务无法启动，需严格遵循「备份→校验→验证」流程
- 升级回滚失败：若未按流程保存 pre-upgrade 配置，回滚后可能出现状态不一致
- 数据误删：
--fix与手动清理脚本涉及文件删除，需确认--non-interactive与--force的行为差异 - 令牌泄露风险：虽然技能明文禁止
cat密钥文件，但环境变量导出仍需人工警惕