Openclaw Self Healing Homeofe

---
name: openclaw-self-healing-elvatis
description: OpenClaw plugin that applies guardrails and auto-fixes reversible failures (rate limits, disconnects, stuck session pins).
---

# openclaw-self-healing-elvatis

Self-healing extension for OpenClaw.

## What it does

- Detects common reversible failures (rate limits, auth errors, stuck session model pins)
- Applies guardrails (e.g. avoid breaking config)
- Can auto-recover WhatsApp disconnects (when enabled)

## Install

```bash
clawhub install openclaw-self-healing-elvatis
```

## Notes

Keep repository content public-safe (no private identifiers).

# openclaw-self-healing-elvatis

OpenClaw plugin that improves resilience by automatically fixing reversible failures.

## What it can heal (v0.2)

Implemented now:

- Model outage healing
  - Detect rate limit / quota / auth-scope failures
  - Put the affected model into cooldown
  - Patch pinned session model overrides to a safe fallback (prevents endless `API rate limit reached` loops)

- WhatsApp disconnect healing
  - If WhatsApp appears disconnected repeatedly: restart the gateway
  - Guardrails: streak threshold + minimum restart interval

- Cron failure healing (optional)
  - If a cron job fails repeatedly: disable it
  - Create a GitHub issue with last error context (rate limited)

Not implemented yet (next):
- Plugin install error rollback (disable plugin) based on structured plugin status
  - Waiting for `openclaw plugins list --json` or an equivalent stable API

## Install

From ClawHub:

```bash
clawhub install openclaw-self-healing-elvatis
```

For local development:

```bash
openclaw plugins install -l ~/.openclaw/workspace/openclaw-self-healing-elvatis
openclaw gateway restart
```

## Config

```json
{
  "plugins": {
    "entries": {
      "openclaw-self-healing": {
        "enabled": true,
        "config": {
          "modelOrder": [
            "anthropic/claude-opus-4-6",
            "openai-codex/gpt-5.2",
            "google-gemini-cli/gemini-2.5-flash"
          ],
          "cooldownMinutes": 300,
          "autoFix": {
            "patchSessionPins": true,
            "disableFailingPlugins": false,
            "disableFailingCrons": false
          }
        }
      }
    }
  }
}
```

## Notes

Infrastructure changes remain ask-first.

## Critical Guardrail: openclaw.json validation

This plugin treats `~/.openclaw/openclaw.json` as a boot-critical file.

Before any self-heal action that could restart the gateway or change cron/plugin state, it verifies:
- the config file exists
- it is valid JSON

If the config is invalid, the plugin will...