必须安装v2026.4.8而非v2026.4.7,初始化memory/memory.md和日期命名的日志文件,并在config.yaml中启用memory.enable与auto_compact_threshold,否则memory-wiki记忆系统失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Windows、macOS或Linux上成功运行OpenClaw v2026.4.7并启用全新回归的Memory-Wiki结构化记忆系统,必须完成三件事:正确安装v2026.4.8(非v2026.4.7)、初始化MEMORY.md核心文件、配置daily日志自动加载路径——任何一步缺失都会导致AI“失忆”,所有跨会话记忆功能完全失效。
确认并安装v2026.4.8稳定版
OpenClaw v2026.4.7存在插件兼容性崩溃问题,【v2026.4.7不可直接使用】,必须升级至同日发布的v2026.4.8修复版。若已安装v2026.4.7,请先卸载再重装。
打开PowerShell(管理员),执行以下命令:
npm uninstall -g openclaw → npm install -g openclaw@2026.4.8
验证安装版本:openclaw --version,输出应为“v2026.4.8”。若显示v2026.4.7或报错,请检查网络是否绕过国内镜像源——此时需手动配置npm镜像:npm config set registry https://registry.npmmirror.com。
初始化Memory-Wiki双层文件结构
OpenClaw的记忆系统不依赖数据库,全部基于本地Markdown文件。首次启动前,必须手动创建两类基础文件,否则系统无法加载任何记忆。
第一步:在OpenClaw工作目录下新建memory文件夹(注意拼写全小写,大小写敏感)。
第二步:在memory文件夹内创建空文件MEMORY.md——这是长期记忆唯一入口,文件名必须全大写,且不能带空格或特殊字符。
第三步:在同一目录下创建当天日期命名的日志文件,例如2026-06-16.md。系统启动时会自动读取该文件与前一天日志,用于构建短期上下文。若跳过此步,当日操作将无法被后续会话回溯。
启用结构化记忆检索与压缩
v2026.4.8默认启用混合搜索(向量+BM25)和自动压缩机制,但需确认两项关键配置生效:
打开config.yaml,找到memory:区块,确保以下两行存在且未被注释:
enable: true
auto_compact_threshold: 5000(单位:字符数,达到即触发压缩)
⚠️ 注意:【MEMORY.md文件一旦被删除或改名,所有长期记忆永久丢失,无法恢复】。日常编辑务必只修改内容,不碰文件名与路径。
验证记忆系统是否正常工作
方法一:启动网关后访问Control UI(默认http://localhost:18789),进入「Memory」标签页,点击「Test Search」输入任意关键词,若返回匹配的MEMORY.md片段即成功。
方法二:终端执行openclaw memory list,应列出MEMORY.md及当日日志文件名;执行openclaw memory inspect MEMORY,可实时查看当前加载的长期记忆摘要。
方法三:开启新会话,发送指令“回顾我昨天设置的GitCode审核流程”,若AI准确复述内容,说明三层记忆(长期+日志+短期)已贯通。










