360 Secure SkillHub
360 安全技能中心

Clawdoctor

这是OpenClaw专属的自修复监控工具,核心功能为监控网关、定时任务、代理会话等组件状态,支持Telegram告警,可自动重启异常网关;提供init、start、status等命令行操作。典型场景是保障OpenClaw服务稳定,及时处理进程异常、定时任务遗漏等问题。输入为终端命令,输出含状态反馈、本地日志及Telegram告警,分三个服务层级。

relayplane
relayplane
热度 54.83
最近更新 2026-05-18 12:24:54
分类:自动化依赖:代码执行 / MCP 服务应用场景:DevOps / 自动化脚本 / 任务管理

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add turleydesigns-clawdoctor
Metadata
name
clawdoctor
description
Self-healing monitor for OpenClaw gateways, crons, and agent sessions. Use when you need to watch if OpenClaw is running, get Telegram alerts on failures, auto-restart the gateway, detect missed crons or stuck sessions, or monitor token costs. Install with `npm install -g clawdoctor`.
metadata
{"openclaw":{"requires":{"bins":["clawdoctor"]},"install":[{"id":"node","kind":"node","package":"clawdoctor","bins":["clawdoctor"],"label":"Install ClawDoctor (npm)"}]}}

ClawDoctor

Self-healing monitor for OpenClaw. Watches your gateway, crons, and agent sessions, sends Telegram alerts, and auto-fixes what it can.

Site: https://clawdoctor.dev
npm: https://www.npmjs.com/package/clawdoctor
GitHub: https://github.com/turleydesigns/clawdoctor

Install

npm install -g clawdoctor

Quick Start

# Interactive setup (Telegram bot token, chat ID, plan key)
clawdoctor init

# Start monitoring daemon
clawdoctor start

# Check health of all monitors
clawdoctor status

Commands

clawdoctor init              # Interactive setup
clawdoctor start             # Start monitoring daemon
clawdoctor start --dry-run   # Run without taking healing actions
clawdoctor stop              # Stop daemon
clawdoctor status            # Live health check of all monitors
clawdoctor log               # Show recent events from local database
clawdoctor log -n 100        # Show last 100 events
clawdoctor log -w GatewayWatcher -s critical  # Filter by watcher/severity
clawdoctor install-service   # Install as systemd user service

What It Monitors

Monitor What It Watches Interval
GatewayWatcher openclaw process running 30s
CronWatcher ~/.openclaw/state/cron-*.json for missed/failed crons 60s
SessionWatcher Agent session files for errors, aborts, stuck sessions 60s
AuthWatcher Gateway logs for 401/403/token expired patterns 60s
CostWatcher Session token costs — flags if >3x rolling average 5m

What It Fixes

Healer Action
ProcessHealer Restarts gateway via systemctl or openclaw gateway restart, then verifies
CronHealer Logs failure and includes manual rerun command in the alert

Pricing

Tier Price Monitors History Auto-fix Alerts
Watch Free 5 7 days ✗ Local only
Diagnose $9/mo 20 30 days ✗ ✅ Telegram
Heal $19/mo Unlimited 90 days ✅ ✅ Telegram

Alerts

Telegram alerts with rate limiting (max 1 per monitor per 5 minutes):

🔴 ClawDoctor Alert
Monitor: GatewayWatcher
Severity: critical
Message: openclaw process not found

Notes

  • Config stored at ~/.clawdoctor/config.json
  • Events stored in SQLite at ~/.clawdoctor/events.db
  • Free tier: 5 monitors, local alerts only, no auto-fix
  • Paid tiers activated via license key from https://clawdoctor.dev