核心用法
本 Skill 提供完整的 macOS 网关监控栈本地部署方案，通过三个 Bash 脚本实现全生命周期管理：
| 命令 | 功能 |
|------|------|
| `bash scripts/install.sh` | 安装监控服务至 `~/.openclaw/tools/gateway-monitor`，注册两个 LaunchAgent（主服务 `ai.openclaw.gateway-monitor` + 看门狗 `ai.openclaw.gateway-watchdog`），验证 API 健康端点 |
| `bash scripts/status.sh` | 查询服务运行状态 |
| `bash scripts/uninstall.sh` | 完整卸载并清理 LaunchAgent |
安装流程具备幂等性，可安全重复执行；更新 plist 前会自动备份至 ~/.openclaw/config-backups，支持回滚。
显著优点
1. 原生 macOS 集成：深度利用 launchd 实现系统级服务托管，随用户登录自动启动，无需手动维护进程
2. 高可用设计：双服务架构（主监控 + 看门狗），故障自动重启，通过 /api/summary 健康检查确保服务可观测
3. 零配置开箱：单命令完成安装、注册、验证全流程，降低运维门槛
4. 安全回滚机制：配置文件变更前自动备份，降低误操作风险
潜在局限
- 平台锁定：仅支持 macOS，Linux/Windows 用户需寻找替代方案
- 用户级服务：LaunchAgent 绑定当前用户会话，系统级守护需额外改造
- 依赖 Bash 环境：假设目标系统已预装标准 Unix 工具链，未明确处理极简环境缺失
curl/jq等工具的情况 - 网络隐式依赖：健康检查需访问本地 API 端口，若防火墙拦截可能导致安装流程报错
适合人群
- macOS 开发者需在本地搭建网关监控开发/测试环境
- 运维人员快速标准化部署 OpenClaw 监控组件
- 追求「安装即运行」体验、不愿手动编写 plist 的技术用户
常规风险
| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| plist 覆盖 | 重复安装可能覆盖用户自定义配置 | 自动备份机制，建议恢复前检查备份目录 |
| 权限问题 | `~/` 路径需当前用户写权限，共享机器可能冲突 | 明确安装到用户目录，避免系统级权限争端 |
| 服务残留 | 异常卸载可能导致僵尸 LaunchAgent | 提供专用 `uninstall.sh`，建议优先使用而非手动删除 |
| 端口占用 | 监控 API 默认端口被占用时健康检查失败 | 安装前确认端口可用，或修改配置后重装 |