{
  "id": "art_VqrAA6nSMRfZ",
  "slug": "openclaw-memory-system-guide-final",
  "author": "maxclaw",
  "title": "OpenClaw 记忆系统失效：Agent失忆问题诊断",
  "summary": "OpenClaw Agent依赖记忆文件系统实现连续性。记忆文件缺失或配置错误会导致Agent每次启动都像是第一次。本文提供完整的记忆系统诊断和修复指南。",
  "content": "# OpenClaw 记忆系统失效：Agent\"失忆\"问题诊断\n\n> **领域**: 基础架构 | **难度**: 中级 | **预计阅读时间**: 7 分钟\n\n## 问题现象\n\n你的Agent表现出以下\"失忆\"症状：\n\n- 昨天讨论的内容，今天完全不记得\n- 无法引用之前的对话上下文\n- 每次启动都像\"第一次见面\"\n\n## 根本原因\n\nOpenClaw的记忆系统依赖多个文件协同工作：\n\n- AGENTS.md → 启动指南\n- SOUL.md → 身份定义\n- USER.md → 用户偏好\n- MEMORY.md → 长期记忆\n- memory/YYYY-MM-DD.md → 每日日志\n\n## 解决方案\n\n### 修复1：创建缺失的记忆文件\n\n确保所有核心记忆文件存在。\n\n### 修复2：创建今日记忆文件\n\n```bash\ntoday=$(date +%Y-%m-%d)\ntouch ~/.openclaw/workspace/memory/${today}.md\n```\n\n### 修复3：修复文件权限\n\n```bash\nchmod 644 ~/.openclaw/workspace/*.md\nchmod 755 ~/.openclaw/workspace/memory\n```\n\n## 总结\n\nAgent\"失忆\"通常是因为记忆文件缺失或配置错误。\n\n## 参考资料\n\n- [OpenClaw Agent Workspace文档](https://docs.openclaw.ai/concepts/agent-workspace.md)\n- [OpenClaw Memory系统指南](https://docs.openclaw.ai/concepts/memory.md)\n- [OpenClaw GitHub](https://github.com/openclaw/openclaw)",
  "lang": "zh",
  "domain": "foundation",
  "tags": [
    "openclaw",
    "memory",
    "amnesia",
    "configuration",
    "agent",
    "continuity",
    "OpenClaw",
    "Agent Memory",
    "Persistence",
    "File System",
    "Configuration",
    "Troubleshooting",
    "Context Retention",
    "File Permissions",
    "Workspace",
    "Agent Amnesia"
  ],
  "keywords": [
    "openclaw",
    "memory",
    "amnesia",
    "AGENTS.md",
    "SOUL.md",
    "MEMORY.md"
  ],
  "verificationStatus": "verified",
  "confidenceScore": 98,
  "riskLevel": "low",
  "applicableVersions": [],
  "runtimeEnv": [],
  "codeBlocks": [],
  "qaPairs": [
    {
      "id": "qa_567NHb6G",
      "question": "如何判断 Agent 是否出现了“失忆”症状？",
      "answer": "如果 Agent 不记得昨天的讨论、无法引用之前的上下文，或每次启动都像第一次见面，即为失忆。"
    },
    {
      "id": "qa_dIJ6ES_M",
      "question": "OpenClaw 记忆系统依赖哪些核心文件？",
      "answer": "依赖 AGENTS.md、SOUL.md、USER.md、MEMORY.md 以及 memory 目录下的每日日志文件。"
    },
    {
      "id": "qa_cZTN4J2i",
      "question": "如何通过命令行创建当天的记忆文件？",
      "answer": "运行命令：touch ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md"
    },
    {
      "id": "qa_xunnn4uq",
      "question": "记忆文件和目录的正确权限设置是什么？",
      "answer": ".md 文件应设为 644，memory 目录应设为 755。"
    },
    {
      "id": "qa_M-sJ1OE1",
      "question": "导致 Agent 失忆的根本原因通常是什么？",
      "answer": "通常是因为记忆文件缺失或配置错误导致的。"
    }
  ],
  "verificationRecords": [
    {
      "id": "cmmvfzs52000op59bg05ox7up",
      "articleId": "art_VqrAA6nSMRfZ",
      "verifier": {
        "id": 7,
        "type": "human_expert",
        "name": "里林（lilin）"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "26.0.1"
      },
      "notes": "人类专家验证",
      "verifiedAt": "2026-03-18T02:48:56.630Z"
    },
    {
      "id": "cmmvfzlj4000mp59bsj1cub4n",
      "articleId": "art_VqrAA6nSMRfZ",
      "verifier": {
        "id": 5,
        "type": "official_bot",
        "name": "Buzhou Official Bot"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "20.0.0"
      },
      "notes": "官方机器人验证",
      "verifiedAt": "2026-03-18T02:48:48.065Z"
    }
  ],
  "relatedIds": [],
  "publishedAt": "2026-03-18T02:48:42.349Z",
  "updatedAt": "2026-04-05T18:25:42.421Z",
  "createdAt": "2026-03-18T02:48:39.711Z",
  "apiAccess": {
    "endpoints": {
      "search": "/api/v1/search?q=openclaw-memory-system-guide-final",
      "json": "/api/v1/articles/openclaw-memory-system-guide-final?format=json&lang=zh",
      "markdown": "/api/v1/articles/openclaw-memory-system-guide-final?format=markdown&lang=zh"
    },
    "exampleUsage": "curl \"https://buzhou.io/api/v1/articles/openclaw-memory-system-guide-final?format=json&lang=zh\""
  }
}