self-heal-openclaw

Repair OpenClaw health, gateway token mismatches, and disconnected channels.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/AIDEN0602/openclaw --skill self-heal-openclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-heal-openclaw
Source: https://github.com/AIDEN0602/openclaw/tree/main/skills/self-heal-openclaw
Command: npx skills add https://github.com/AIDEN0602/openclaw --skill self-heal-openclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Auto-recover OpenClaw when health goes offline, gateway token mismatch (1008) appears, Telegram stops replying, or browser/control-ui disconnects.

Core Features & Use Cases

  • Safe first-pass repair that does not touch token/config by default (stability-first mode)
  • Ensures LaunchAgent/service is installed
  • Restarts only if health fails twice in a row with a 30-minute cooldown
  • Runs health and channel probe checks
  • Optional deep-clean mode to purge local session caches
  • Supports --sync-token to align gateway.remote.token with gateway.auth.token

Quick Start

Run bash scripts/self_heal_openclaw.sh --profile jarvis to perform a safe repair.

Frequently Asked Questions about self-heal-openclaw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I auto-heal OpenClaw when Telegram stops replying or the control UI disconnects?

To auto-heal OpenClaw when Telegram stops replying or the control UI disconnects, you run a safe repair script that verifies the LaunchAgent installation, probes health and channels, and applies restart cooldowns to restore service connectivity without altering configurations by default.

What is the best way to fix gateway token mismatch error 1008 in OpenClaw?

The best way to fix gateway token mismatch error 1008 in OpenClaw is to execute the recovery workflow with the sync-token option, which aligns the gateway remote token with the gateway auth token to re-establish secure authentication.

Do I need to perform a deep-clean to repair OpenClaw health when it goes offline?

You do not need to perform a deep-clean to repair OpenClaw health when it goes offline, as the default stability-first mode safely restores service by checking LaunchAgent and probing health; deep-clean is an optional mode to purge local session caches.

How does the restart cooldown mechanism work during OpenClaw self-healing?

The restart cooldown mechanism during OpenClaw self-healing works by triggering a service restart only if health checks fail twice consecutively, enforcing a 30-minute cooldown period to maintain system resilience and prevent aggressive recovery loops.

Can I run OpenClaw self-healing scripts without affecting my existing token configuration?

You can run OpenClaw self-healing scripts without affecting your existing token configuration because the default stability-first mode performs safe first-pass repairs that ensure service installation and health monitoring without touching tokens or config files.

Why does OpenClaw fail to recover automatically after a browser control UI disconnects?

OpenClaw might fail to recover automatically after a browser control UI disconnects if the LaunchAgent is missing or the gateway tokens are mismatched; running a guarded auto-heal script ensures installation, token sync, and health probes to repair the disconnection.