Failure Memory — Development skill for Claude Code

🧠 Failure Memory

**Never repeat the same mistake twice.** An automatic failure pattern recording & recall system for [OpenClaw](https://openclaw.ai) agents.

[](https://clawhub.com/skills/failure-memory-log) [](LICENSE)

---

Why?

AI agents make mistakes — misconfigurations, wrong flags, API quirks, permission errors. Without a structured way to log and recall these failures, **the same mistakes get repeated across sessions.**

Failure Memory solves this by:

1. Recording every failure with context, root cause, and resolution
2. Recalling relevant past failures before starting similar tasks
3. Reporting patterns so systemic issues get fixed

How It Works

Error occurs → Log to memory/failures.md → Next similar task → Auto-recall → Avoid repeat

Recording Format

## [2026-03-02 12:30] Docker permission denied on socket

- **Category:** permissions
- **Context:** Trying to run `docker compose up` for local dev
- **Error:** `Got permission denied while trying to connect to the Docker daemon socket`
- **Root Cause:** User not in docker group after fresh OS install
- **Resolution:** `sudo usermod -aG docker $USER && newgrp docker`
- **Prevention:** Check docker group membership in setup scripts
- **Tags:** docker, permissions, linux, setup

Pre-Task Recall

Before starting any significant task, the agent searches `memory/failures.md` for relevant history and surfaces known pitfalls:

⚠️ Known pitfall: Docker permission denied — check docker group membership first

Installation

Via ClawHub (recommended)

clawhub install failure-memory-log

Via Git

git clone https://github.com/VoidLight00/failure-memory.git
cp -r failure-memory /path/to/your/openclaw/workspace/skills/

Initialize

bash skills/fail