Files
openclaw-backups/openclaw-watchdog/README-KRILLY.md
2026-02-21 07:01:51 +00:00

2.2 KiB

🦞 OpenClaw Watchdog — Krilly's Fork

Original: jlgrimes/openclaw-watchdog
Modified by: Krilly the Crab 🦀

What's Different?

This fork adds Telegram and ntfy notifications alongside (or instead of) Discord.

Feature Original This Fork
Discord alerts (optional)
Telegram alerts
ntfy alerts
Multi-channel (simultaneous)

Quick Install

git clone https://github.com/jlgrimes/openclaw-watchdog.git
cd openclaw-watchdog
chmod +x setup.sh watchdog.sh
./setup.sh

The installer will ask for:

  • Telegram Bot Token
  • ntfy Token
  • ntfy URL (defaults to your setup)

Configuration

Edit ~/.openclaw/watchdog.env:

# Required for Telegram
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT=1793951355

# Required for ntfy
NTFY_URL=https://ntfy.sh
NTFY_TOPIC=anthony-krilly-9f3k2
NTFY_MIN_PRIORITY=4

# Optional: Legacy Discord
DISCORD_CHANNEL_ID=
DISCORD_BOT_TOKEN=

All three can work simultaneously — get alerts wherever you want!

How It Works

Same great watchdog behavior from the original:

  1. Health checks every 30s (configurable)
  2. Stage 1: Simple restart on first failure
  3. Stage 2: Config rollback + restart on second failure
  4. Stage 3: SOS alert after 3+ failures
  5. Recovery: Notification when gateway comes back

But now alerts go to Telegram and ntfy too!

Managing the Service

sudo systemctl status openclaw-watchdog   # Check status
sudo systemctl restart openclaw-watchdog  # Restart
sudo systemctl stop openclaw-watchdog     # Stop
tail -f ~/.openclaw/watchdog.log          # View logs

Test Notifications

export TELEGRAM_BOT_TOKEN="your_token"
export TELEGRAM_CHAT="1793951355"
export NTFY_TOPIC="your_topic"

# Source the functions and test
source ~/.openclaw/watchdog.sh
telegram_send "🦀 Test message from Krilly!"
gotify_send "Test" "🦀 Test message from Krilly!" 5

Credits

  • Original: Jared Grimes and Claw 🦞
  • Fork modifications: Krilly the Crab for Anthony Martin
  • License: MIT

Part of the Krilly Automation Stack 🦀