jarvis4wang

jarvis4wang / watchclaw

Public

A watchdog CLI for your OpenClaw gateway. No more lobster suicide.

14
1
100% credibility
Found Mar 02, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Watchclaw is a bash-based watchdog that monitors an OpenClaw AI gateway for crashes, automatically restarts it, rolls back problematic configurations to a known-good state, and sends configurable alerts.

How It Works

1
😩 AI Chats Go Silent

Your AI helper's gateway crashes from a bad setting tweak, cutting off WhatsApp, Telegram, and Discord messages.

2
📥 Find the Guardian Angel

Discover Watchclaw, the simple protector that keeps your AI gateway alive without manual fixes.

3
⚙️ Share Your Setup Details

Copy the ready-made preferences file and note your AI port, settings folder, and how to ping you if trouble arises.

4
🚀 Awaken the Watchdog

Start it with one command, and it slips into the background, learning your safe setup during a quick test period.

5
👀 Quiet Vigil Begins

It gently checks your gateway's health every 10 seconds, staying invisible unless something's wrong.

6
🛡️ Smart Auto-Rescue

On detecting a crash, it restarts the gateway and smartly reverts to your last proven-good settings if that's the culprit.

😌 Peace of Mind Achieved

Your AI stays reliable, with alerts only for stubborn issues via text, chat, or custom notice, so you sip coffee worry-free.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is watchclaw?

Watchclaw is a pure Bash CLI watchdog for your OpenClaw gateway, preventing "lobster suicide" crashes from bad config tweaks that silence WhatsApp, Telegram, and Discord channels. It polls the gateway port for health, auto-restarts processes or Docker containers, and rolls back configs to the last git-known-good state using stashes or reverts. Run simple commands like `watchclaw start`, `status`, or `logs` to monitor and recover without SSH scrambles.

Why is it gaining traction?

Unlike generic linux watchdog github tools or watchdog timer github scripts, it smartly diagnoses config errors via logs, enforces probation periods before trusting new setups, and plugs into iMessage, Slack webhooks, or custom commands for alerts. Zero dependencies beyond curl and git make it dead simple for macOS or Linux, with Docker mode for containerized gateways—no Python bloat like watchdog python github alternatives. Devs dig the structured `status` output that agents can parse for proactive checks.

Who should use this?

OpenClaw users tweaking gateway configs for multi-channel messaging, especially solo devs or ops folks running personal Mac Minis or Linux servers. Ideal if you're iterating auth profiles and tired of client watchdog timeout panics, or deploying Dockerized setups where bind-mounted git configs need auto-rollback. Skip if you're not on OpenClaw.

Verdict

Solid for OpenClaw loyalists despite 14 stars and 1.0% credibility score—excellent docs, full test suite covering crash scenarios, and MIT license scream maturity beyond the numbers. Grab it if you run a gateway; otherwise, watch from afar.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.