Memory Self-Heal Skill

---

name: memory-self-heal

version: 1.1.0

description: General-purpose self-healing loop that learns from past failures, retries safely, and records reusable fixes.

metadata:

openclaw:

emoji: "[HEAL]"

category: resilience

---

# Memory Self-Heal Skill

Use this skill when the agent starts failing repeatedly, stalls, or keeps asking the user for steps that could be inferred from prior evidence.

Goals

1. Recover execution without user micromanagement

2. Reuse previous fixes from memory/logs/tasks

3. Escalate only with minimal unblock input when truly blocked

4. Leave reusable evidence for future runs

When To Trigger

Trigger when any of these appear:

Inputs

Portable Evidence Scan Order

Scan these in order; skip missing paths silently:

1. `memory/` (or equivalent workspace memory path)

2. `tasks/` or queue files

3. runtime logs / channel logs

4. skill docs (`skills/*/SKILL.md`) for known fallback recipes

5. core docs (`TOOLS.md`, `CAPABILITIES.md`, `AGENTS.md`)

Shell examples (use whichever shell is active):

# PowerShell
Get-ChildItem -Recurse memory, tasks -ErrorAction SilentlyContinue |
  Select-String -Pattern "error|blocked|retry|fallback|auth|token|proxy|timeout|context" -Context 2

# POSIX shell
rg -n "error|blocked|retry|fallback|auth|token|proxy|timeout|context" memory tasks 2>/dev/null

Failure Classification

Classify first, then act:

Recovery Policy (3-Tier)

Attempt 1: Direct Fix

Attempt 2: Safe Fallback

Attempt 3: Controlled Escalation

Safety Rules

Completion Contract

Do not claim done unless all are true:

Required output block:

DONE_CHECKLIST
- Objective met: yes/no
- Artifact: <path or URL or command output ref>
- Validation: <what was checked>
- Remaining blocker: <none or exact unblock input>

Memory Writeback Template

Append one concise entry after each self-heal cycle:

## Self-heal: <date-time> <short task>
- Signature: <normalized error signature>
- Class: <classification>
- Attempt1: <action> -> <result>
- Attempt2: <action> -> <result>
- Final: <success | blocked>
- Artifact/Evidence: <path|url|log ref>
- Reusable rule: <one-line rule>

Generic Known Fixes (Seed Set)

Integration Notes