什么是 失败记忆？

失败记忆是一个强大的框架，用于在 AI 开发环境中记录、分析技术挫折并从中学习。通过系统地记录每一个错误、根本原因和解决方案，该技能确保 Openclaw 技能能够持久记忆“哪里出了错”以及“如何修复”。它将被动的错误日志转化为主动的知识库，智能体可以查询该库以避免两次掉入同样的陷阱。

该技能对于复杂的开发周期尤其有价值，因为在这些周期中，特定环境的漏洞或依赖冲突经常重复出现。通过将失败记忆集成到您的 Openclaw 技能组中，您可以创建一个自我改进的闭环，其中每一个已解决的工单或失败的部署都能增强智能体成功应对未来挑战的能力。

下载入口:https://github.com/openclaw/skills/tree/main/skills/voidlight00/failure-memory-log

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

失败记忆 应用场景

• 自动记录 Shell 命令失败，以记录特定环境的修复方案。
• 在开始新的迁移或部署之前进行任务前历史检查，以识别已知陷阱。
• 生成结构化的失败报告，以识别软件架构中的系统性弱点。
• 追踪仅在特定网络或数据条件下出现的重复性 API 集成问题。

1. 检测：智能体识别任务失败或命令执行返回的非零退出代码。
2. 记录：该技能记录一条结构化条目，包括类别、上下文、准确的错误信息以及发现的具体根本原因。
3. 文档化：记录中会添加解决方案和预防策略，以指导未来的交互。
4. 搜索：在开始新操作之前，智能体使用与当前任务相关的关键词搜索 failures.md 文件。
5. 预防：如果找到匹配项，智能体会根据记录的预防提示提醒用户或调整其计划。

失败记忆 配置指南

要为这些 Openclaw 技能初始化跟踪环境，请执行技能目录中提供的初始化脚本：

bash scripts/init.sh ./memory

这将创建必要的目录结构和 failures.md 日志文件，所有未来的错误模式都将存储在此处。

失败记忆 数据架构与分类体系

该技能将其历史数据组织在一个结构化的 Markdown 文件中，以确保与标准 CLI 工具和 Openclaw 技能兼容。

name: failure-memory
description: "Automatic failure pattern recording and recall system. Prevents repeating the same mistakes by logging errors with context, root cause, and resolution. Use when: (1) a command/task fails and you want to record why, (2) starting a new task and want to check for known pitfalls, (3) reviewing accumulated failure patterns for learning, (4) agent makes an error and needs to log it for future prevention. Triggers: 'log failure', 'check failures', 'failure report', 'what went wrong', 'mistake log', or any error/failure during agent work."

Failure Memory

Record failures. Learn from them. Never repeat them.

Core Concept

Every failure has three parts:

1. What happened (error message, symptom)
2. Why it happened (root cause)
3. How to fix/avoid it (resolution)

This skill stores them in a searchable markdown file and provides a recall mechanism before starting similar tasks.

File Structure

memory/
└── failures.md      # All failure records (append-only log)

Recording a Failure

When an error occurs during work, append to memory/failures.md:

## [YYYY-MM-DD HH:mm] 

- **Category:** 
- **Context:** 
- **Error:** ``
- **Root Cause:** 
- **Resolution:** 
- **Prevention:** 
- **Tags:** 

When to Record

Record AUTOMATICALLY when:

• A shell command exits non-zero and you identify why
• An API call fails and you find the cause
• A config/setup step fails and you resolve it
• You catch yourself repeating a previously-solved mistake
• A sub-agent reports an error with resolution

Do NOT record:

• Transient network timeouts (unless pattern emerges)
• Intentional test failures
• User-cancelled operations

Pre-Task Recall

Before starting any significant task, search failures for relevant history:

grep -i "" memory/failures.md

Or use memory_search if vector search is available:

memory_search query=" failure error"

If matches found, mention them briefly:

?? Known pitfall: [title] — [prevention tip]

Failure Report

When asked for a failure report or review, generate a summary:

1. Read memory/failures.md
2. Group by category
3. Identify repeat patterns (same root cause appearing multiple times)
4. Suggest systemic fixes for patterns

Report Format

# Failure Report — YYYY-MM-DD

## Stats
- Total: N failures recorded
- Top category:  (N occurrences)
- Repeat offenders: N patterns seen 2+ times

## Repeat Patterns
### 
- Seen: N times
- Root cause: 
- Systemic fix: 

## Recent Failures (last 7 days)
- [date]