{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-watchdog",
    "name": "OpenClaw Watch Dog",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Abdullah4AI/openclaw-watchdog",
    "canonicalUrl": "https://clawhub.ai/Abdullah4AI/openclaw-watchdog",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-watchdog",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-watchdog",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "openclaw-watchdog/SKILL.md",
      "openclaw-watchdog/_meta.json",
      "openclaw-watchdog/references/troubleshooting.md",
      "openclaw-watchdog/scripts/setup.sh",
      "openclaw-watchdog/scripts/test-message.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-watchdog"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-watchdog",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-watchdog/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-watchdog/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-watchdog/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "openclaw-watchdog",
        "body": "Description: Self-healing monitoring system for OpenClaw gateway. Monitors health, auto-restarts on failure, and sends Telegram alerts. Diagnostics and log analysis run locally on-device. Alert notifications are sent to the user's Telegram bot. Use when user wants to set up gateway monitoring, watchdog, or auto-recovery."
      },
      {
        "title": "Prerequisites",
        "body": "Telegram Bot Token — Create via @BotFather\nTelegram Chat ID — Your personal chat ID for receiving alerts\nPython 3 — Required for the watchdog service\nOpenClaw — Installed and running"
      },
      {
        "title": "Trigger Keywords",
        "body": "watchdog, monitoring, auto-fix, gateway health, self-healing, auto-recovery, watch dog"
      },
      {
        "title": "Setup",
        "body": "Send the user ONE message with everything they need:\n\n🐕 Watch Dog — Self-Healing Gateway Monitor\n\nWatch Dog is a background service that pings your OpenClaw gateway every 15 seconds. If the gateway goes down, it automatically attempts to restart it and sends you Telegram alerts so you're always in the loop. All diagnostics run locally on your device.\n\nTo set it up, I need:\n\nTelegram Bot Token — Create a bot via @BotFather on Telegram, then send me the token (looks like 123456:ABC-DEF...)\n\n\nYour Telegram Chat ID — Send /start to your bot, then visit https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates to find your chat ID\n\nSend me the token and chat ID and I'll handle the rest (including a test run to make sure everything works)!"
      },
      {
        "title": "After Receiving Credentials",
        "body": "Run these steps in order:"
      },
      {
        "title": "1. Validate credentials",
        "body": "python3 ~/.openclaw/workspace/openclaw-watchdog/scripts/validate.py \"$TELEGRAM_TOKEN\""
      },
      {
        "title": "2. Run setup script",
        "body": "chmod +x ~/.openclaw/workspace/openclaw-watchdog/scripts/setup.sh\n~/.openclaw/workspace/openclaw-watchdog/scripts/setup.sh \\\n  --telegram-token \"$TELEGRAM_TOKEN\" \\\n  --telegram-chat-id \"$TELEGRAM_CHAT_ID\" \\\n  --gateway-port \"$GATEWAY_PORT\"  # optional, auto-detected from openclaw.json"
      },
      {
        "title": "3. Connect via Telegram (Pairing)",
        "body": "python3 ~/.openclaw/workspace/openclaw-watchdog/scripts/test-message.py \"$TELEGRAM_TOKEN\" \"$TELEGRAM_CHAT_ID\"\n\nWait for user to confirm they received the Telegram message before proceeding."
      },
      {
        "title": "4. Verify it's running",
        "body": "# Check service status\nif [[ \"$(uname)\" == \"Darwin\" ]]; then\n  launchctl list | grep openclaw.watchdog\nelse\n  systemctl --user status openclaw-watchdog\nfi\n\n# Check logs\ntail -20 ~/.openclaw/watchdog/watchdog.log"
      },
      {
        "title": "5. Confirm to user",
        "body": "Tell them Watch Dog is active, what it monitors, and that they'll get Telegram alerts if anything goes wrong."
      },
      {
        "title": "How It Works",
        "body": "Pings gateway health endpoint every 15 seconds (auto-detects port from config, or set via --gateway-port)\nAfter 3 consecutive failures, attempts openclaw gateway restart\nUp to 2 restart attempts, then asks user for reinstall permission via Telegram\nUser approves by running: touch ~/.openclaw/watchdog/approve-reinstall\nWithout approval, only sends notifications — no destructive actions\nLocal pattern-matching diagnostics (no logs sent externally)\nRuns as macOS LaunchAgent or Linux systemd user service\nCredentials encrypted with AES-256 using machine-specific key"
      },
      {
        "title": "Uninstall",
        "body": "if [[ \"$(uname)\" == \"Darwin\" ]]; then\n  launchctl unload ~/Library/LaunchAgents/com.openclaw.watchdog.plist 2>/dev/null\n  rm -f ~/Library/LaunchAgents/com.openclaw.watchdog.plist\nelse\n  systemctl --user stop openclaw-watchdog 2>/dev/null\n  systemctl --user disable openclaw-watchdog 2>/dev/null\n  rm -f ~/.config/systemd/user/openclaw-watchdog.service\nfi\nrm -rf ~/.openclaw/watchdog"
      }
    ],
    "body": "openclaw-watchdog\n\nDescription: Self-healing monitoring system for OpenClaw gateway. Monitors health, auto-restarts on failure, and sends Telegram alerts. Diagnostics and log analysis run locally on-device. Alert notifications are sent to the user's Telegram bot. Use when user wants to set up gateway monitoring, watchdog, or auto-recovery.\n\nPrerequisites\nTelegram Bot Token — Create via @BotFather\nTelegram Chat ID — Your personal chat ID for receiving alerts\nPython 3 — Required for the watchdog service\nOpenClaw — Installed and running\nTrigger Keywords\nwatchdog, monitoring, auto-fix, gateway health, self-healing, auto-recovery, watch dog\nSetup\n\nSend the user ONE message with everything they need:\n\n🐕 Watch Dog — Self-Healing Gateway Monitor\n\nWatch Dog is a background service that pings your OpenClaw gateway every 15 seconds. If the gateway goes down, it automatically attempts to restart it and sends you Telegram alerts so you're always in the loop. All diagnostics run locally on your device.\n\nTo set it up, I need:\n\nTelegram Bot Token — Create a bot via @BotFather on Telegram, then send me the token (looks like 123456:ABC-DEF...)\n\nYour Telegram Chat ID — Send /start to your bot, then visit https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates to find your chat ID\n\nSend me the token and chat ID and I'll handle the rest (including a test run to make sure everything works)!\n\nAfter Receiving Credentials\n\nRun these steps in order:\n\n1. Validate credentials\npython3 ~/.openclaw/workspace/openclaw-watchdog/scripts/validate.py \"$TELEGRAM_TOKEN\"\n\n2. Run setup script\nchmod +x ~/.openclaw/workspace/openclaw-watchdog/scripts/setup.sh\n~/.openclaw/workspace/openclaw-watchdog/scripts/setup.sh \\\n  --telegram-token \"$TELEGRAM_TOKEN\" \\\n  --telegram-chat-id \"$TELEGRAM_CHAT_ID\" \\\n  --gateway-port \"$GATEWAY_PORT\"  # optional, auto-detected from openclaw.json\n\n3. Connect via Telegram (Pairing)\npython3 ~/.openclaw/workspace/openclaw-watchdog/scripts/test-message.py \"$TELEGRAM_TOKEN\" \"$TELEGRAM_CHAT_ID\"\n\n\nWait for user to confirm they received the Telegram message before proceeding.\n\n4. Verify it's running\n# Check service status\nif [[ \"$(uname)\" == \"Darwin\" ]]; then\n  launchctl list | grep openclaw.watchdog\nelse\n  systemctl --user status openclaw-watchdog\nfi\n\n# Check logs\ntail -20 ~/.openclaw/watchdog/watchdog.log\n\n5. Confirm to user\n\nTell them Watch Dog is active, what it monitors, and that they'll get Telegram alerts if anything goes wrong.\n\nHow It Works\nPings gateway health endpoint every 15 seconds (auto-detects port from config, or set via --gateway-port)\nAfter 3 consecutive failures, attempts openclaw gateway restart\nUp to 2 restart attempts, then asks user for reinstall permission via Telegram\nUser approves by running: touch ~/.openclaw/watchdog/approve-reinstall\nWithout approval, only sends notifications — no destructive actions\nLocal pattern-matching diagnostics (no logs sent externally)\nRuns as macOS LaunchAgent or Linux systemd user service\nCredentials encrypted with AES-256 using machine-specific key\nUninstall\nif [[ \"$(uname)\" == \"Darwin\" ]]; then\n  launchctl unload ~/Library/LaunchAgents/com.openclaw.watchdog.plist 2>/dev/null\n  rm -f ~/Library/LaunchAgents/com.openclaw.watchdog.plist\nelse\n  systemctl --user stop openclaw-watchdog 2>/dev/null\n  systemctl --user disable openclaw-watchdog 2>/dev/null\n  rm -f ~/.config/systemd/user/openclaw-watchdog.service\nfi\nrm -rf ~/.openclaw/watchdog"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Abdullah4AI/openclaw-watchdog",
    "publisherUrl": "https://clawhub.ai/Abdullah4AI/openclaw-watchdog",
    "owner": "Abdullah4AI",
    "version": "1.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-watchdog",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-watchdog",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-watchdog/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-watchdog/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-watchdog/agent.md"
  }
}