Files
openclaw-backups/archive/old-projects/openclaw-watchdog/README-KRILLY.md

95 lines
2.2 KiB
Markdown

# 🦞 OpenClaw Watchdog — Krilly's Fork
**Original:** [jlgrimes/openclaw-watchdog](https://github.com/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
```bash
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`:
```bash
# 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
```bash
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
```bash
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* 🦀