claw-sos

Emergency recovery tool for OpenClaw. Diagnoses and fixes unresponsive bots via SSH.

Install

The script is bundled at scripts/sos.sh. Install locally:

cp scripts/sos.sh /usr/local/bin/sos
chmod +x /usr/local/bin/sos

To install on a remote machine:

scp scripts/sos.sh root@<IP>:/usr/local/bin/sos
ssh root@<IP> "chmod +x /usr/local/bin/sos"

Alternative — install from GitHub:

curl -fsSL https://raw.githubusercontent.com/clawsos/claw-sos/main/install.sh | bash

Usage

Interactive (human via SSH)

sos          # whiptail arrow-key menu

Non-interactive (agent or cron)

sos auto     # autofix: diagnose → doctor → restart → force → nuclear
sos net      # network check only
sos tg       # telegram test message
sos --version
sos --help

When the bot is down — decision tree

1. Run sos auto — handles 95% of cases automatically
2. If autofix fails → run sos net — if network is broken, fix DNS/internet first
3. If network is fine but bot still down → run sos tg — check Telegram delivery
4. If Telegram fails → check bot token validity
5. Last resort → sos menu option 9 (Nuclear) — kills everything and starts fresh

Menu Options

Autofix Escalation Order

1. Diagnose: process, RAM, disk
2. Clean RAM/disk if critical
3. openclaw doctor --fix
4. Graceful restart → wait 15s → check
5. Force kill + restart → wait 15s → check
6. Nuclear (kill all + reload)

Stops as soon as gateway is healthy.

Log Location

All actions logged to ~/.openclaw/backups/sos.log. Read this to understand what happened during recovery:

cat ~/.openclaw/backups/sos.log

Platform Support

• Linux: Full support (systemd, journalctl, free, /proc)
• macOS: Full support (launchctl, log show, vm_stat, purge, dialog fallback)
• Docker: Partial — no systemd, manual fallback works

Credentials

This skill uses no API keys or tokens of its own. It reads existing OpenClaw config to:

• Check gateway status (local process, no network)
• Send Telegram test messages (uses the bot token already configured in openclaw.json)
• Check Anthropic API reachability (HTTPS ping only, no auth)

No credentials are stored, transmitted, or required to install or run SOS.

Source

GitHub: https://github.com/clawsos/claw-sos