开始使用

npm install -g openclaw-doctor
openclaw-doctor watch -d

就这样。Doctor 在后台监控你的 OpenClaw 网关，挂了自动重启，全程通知你。无需任何配置——它会自动读取你现有的 OpenClaw 设置。

核心命令

openclaw-doctor watch            # 开始监控（前台）
openclaw-doctor watch -d         # 开始监控（后台）
openclaw-doctor unwatch          # 停止监控

openclaw-doctor status           # 快速健康检查

这四个命令覆盖日常 90% 的使用场景。

网关管理

openclaw-doctor gateway start    # 启动 OpenClaw 网关
openclaw-doctor gateway stop     # 停止网关
openclaw-doctor gateway restart  # 重启网关

诊断和日志

openclaw-doctor doctor           # 完整诊断（二进制、网关、通道）
openclaw-doctor logs             # 查看网关日志
openclaw-doctor logs --error     # 只看错误日志
openclaw-doctor logs --doctor    # 查看 Doctor 自身事件日志
openclaw-doctor dashboard        # Web 管理面板（http://localhost:9090）

安装

# npm（推荐）
npm install -g openclaw-doctor

# 或免安装直接跑
npx openclaw-doctor status

需要 Node >= 22（和 OpenClaw 一致）。

工作原理

Doctor 自动探测你的 OpenClaw 安装：

• 读取 ~/.openclaw/openclaw.json 获取网关端口、通道、Agent 信息
• 扫描 ~/Library/LaunchAgents/ 找到 launchd 服务
• 通过 openclaw health --json 检查健康（真正的网关 RPC，不是 HTTP 探测）
• 需要时通过 launchctl kickstart 重启

你不需要配置 OpenClaw 的任何信息。 Doctor 会自动搞定。

完整命令

| 命令 | 说明 | |------|------| | 监控 | | | watch | 开始健康监控（前台） | | watch -d | 开始健康监控（后台） | | watch -d --dashboard | 后台监控 + Web 面板 | | unwatch | 停止监控 | | 网关 | | | gateway start | 启动 OpenClaw 网关 | | gateway stop | 停止网关 | | gateway restart | 重启网关 | | 信息 | | | status | 显示网关和通道健康状态 | | status --json | 机器可读的 JSON 输出 | | doctor | 运行完整诊断 | | dashboard | 启动 Web 管理面板 | | logs | 查看网关日志 | | logs --error | 只看错误日志 | | logs --doctor | 查看 Doctor 事件日志 |

配置

配置文件位于 ~/.openclaw-doctor/config.json，首次运行时自动创建。只包含 Doctor 自身的偏好——无需配置 OpenClaw 的信息。

{
  "checkInterval": 30,
  "failThreshold": 3,
  "dashboardPort": 9090,
  "maxRestartsPerHour": 5,
  "openclawProfile": "default",
  "notify": {
    "webhook": {
      "enabled": false,
      "url": "",
      "bodyTemplate": "{\"msgtype\":\"text\",\"text\":{\"content\":\"{{message}}\"}}"
    },
    "system": {
      "enabled": true
    }
  }
}

| 字段 | 说明 | 默认值 | |------|------|--------| | checkInterval | 健康检查间隔（秒） | 30 | | failThreshold | 连续失败几次后重启 | 3 | | dashboardPort | Web 面板端口 | 9090 | | maxRestartsPerHour | 每小时最多重启次数 | 5 | | openclawProfile | 监控的 OpenClaw 配置（default、dev...） | default | | notify.webhook.url | Webhook 通知地址 | -- | | notify.system.enabled | macOS 系统通知 | true |

通知系统

Doctor 在整个生命周期都会通知你：

| 事件 | 示例消息 | |------|----------| | 开始监控 | "Doctor 正在守护你的 OpenClaw 服务" | | 状态异常 | "服务异常（第 2/3 次检测）" | | 准备重启 | "正在重启网关..." | | 重启成功 | "网关已恢复上线" | | 重启失败 | "重启失败：[错误详情]" | | 重启受限 | "重启次数过多，需要人工介入" | | 自行恢复 | "服务自行恢复，无需重启" | | 停止监控 | "Doctor 已停止" |

支持渠道：Webhook（钉钉、飞书、Slack、企业微信等）+ macOS 系统通知。

Skills 集成

Doctor 作为独立守护进程运行，可被 OpenClaw 或其他工具调用：

openclaw-doctor status --json    # 机器可读输出
openclaw-doctor watch -d         # 幂等——重复调用安全

即使调用方崩溃，Doctor 继续运行。

架构

                          +-----------------+
                          |     通知系统     |
                          |  (Webhook/OS)   |
                          +--------^--------+
                                   |
+-------------+    CLI    +--------+--------+    RPC      +-----------+
|  OpenClaw   | --------> |                 | ---------> |  OpenClaw |
|  / 脚本     |           | openclaw-doctor |            |    网关    |
|  / Skills   | <-------- |   (守护进程)     | <--------- |  :18789   |
+-------------+  stdout   +--------+--------+   health   +-----------+
                                   |
                          +--------v--------+
                          | ~/.openclaw/logs |
                          |   (读取并分析)    |
                          +-----------------+

开发

git clone https://github.com/Sobranier/openclaw-doctor.git
cd openclaw-doctor
npm install

npm run dev -- status          # 快速测试
npm run dev -- watch           # 前台监控
npm run dev -- watch -d        # 后台守护
npm run dev -- unwatch         # 停止守护

npm run build                  # 构建发布版本

路线图

• [x] 通过 openclaw health --json 检查健康 + 自动重启（含频率限制）
• [x] 自动探测 OpenClaw 配置（网关端口、通道、Agent、launchd）
• [x] 后台守护模式（watch -d / unwatch）
• [x] 网关管理（gateway start/stop/restart）
• [x] 读取并展示 OpenClaw 网关日志
• [x] Web 状态面板
• [x] status --json 输出
• [ ] 通知系统（Webhook + macOS）
• [ ] logs --tail（实时跟踪）
• [ ] config 命令（get/set）
• [ ] 多服务监控
• [ ] Linux systemd 支持

协议

MIT