OpenClaw 为什么会“健忘”？从 session 到 workspace 的长期记忆配置排查

1. 从“昨天明明说过”说起OpenClaw 的记忆到底存在哪OpenClaw 是一个可以本地部署、通过配置文件驱动的 AI 助手框架它能接入不同模型、维护多轮对话、把重要信息沉淀成长期记忆。适合谁适合那些想让 AI 记住项目背景、个人偏好、固定规则而不是每次开新对话都从头解释一遍的人。但很多人第一次用就会撞上一个很具体的现象第一天告诉它的项目结构、命名习惯、回答风格第二天再问它像没听过一样。你以为是模型变笨了其实大概率是记忆链路里某一环没走通。OpenClaw 的记忆不是“说过了就永远记得”的天然属性它更像一条流水线当前对话先进入 session 上下文重要内容需要被写入 workspace 下的持久化文件下一次启动时再从 workspace 加载回 session。任何一环断了体感就是“隔天失忆”。这篇就按这条链路从 session 和 workspace 两个层面拆开排查并给出可复制的config.toml骨架和 TaoToken 统一 Key/API 通道配置最后用重启验证记忆是否真的落盘。2. 前置准备TaoToken 统一 Key 与 API 通道在排查记忆之前先把模型通道理顺。OpenClaw 本身不绑定某一家模型它通过 API 调用外部模型所以你需要一个稳定的 Key 和 Base URL。我这边用的是 TaoToken 的统一通道好处是一个 Key 可以走多个模型配置里不用来回换。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台生成 API Key。API 地址是 https://taotoken.net/api注意这个地址不加 UTM 参数直接填进配置即可。如果你还没生成 Key可以走这个 deep link 直达https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。生成后先别急着写进 OpenClaw建议用模型对话页面单独验证一下 Key 是否可用https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite。这一步能排除“Key 本身有问题”这个变量后面排查记忆时就不会被干扰。注意Key 只放在本地配置文件或环境变量里不要提交到 Git 仓库。OpenClaw 的config.toml如果纳入版本管理记得把 Key 字段用环境变量引用。3. 可复制配置config.toml 骨架与记忆落盘参数下面这份骨架是我实际跑通过的重点看[memory]和[workspace]两段它们直接决定记忆会不会落盘、落到哪、重启后能不能加载回来。# config.toml [model] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} # 从环境变量读取别硬编码 model claude-sonnet-4-20250514 timeout 60 [session] # 会话作用域按渠道用户隔离避免第二天换了渠道就接不上 scope channel_user max_turns 40 # 单次会话保留的最大轮数 ttl_hours 24 # 会话过期时间超过后上下文清空 [workspace] # 工作区根目录所有持久化记忆都写在这里 root ./openclaw_workspace auto_save true # 关键开启自动落盘 save_interval_sec 30 # 每 30 秒把 session 增量写入 workspace [memory] # 长期记忆开关关掉的话就只剩当天上下文 long_term true store file # 记忆存储方式file / sqlite path ./openclaw_workspace/memory # 哪些内容值得沉淀为长期记忆 extract_rules [preference, project_context, naming_convention] # 写入前是否让模型做一次摘要压缩 summarize_on_write true几个参数值得单独说。session.ttl_hours如果设得太短比如 6 小时那你第二天来的时候 session 早就过期了workspace 里就算有记忆也不会自动挂回当前会话。workspace.auto_save必须为true否则 session 里的内容只存在内存进程一退就没了。memory.long_term是总开关很多人配置里漏了这一行结果所有对话都只停留在 session 层第二天自然接不上。环境变量这样设置export TAOTOKEN_API_KEYsk-你的key然后启动 OpenClawopenclaw --config ./config.toml4. 验证请求重启后记忆是否真的持久化配置写完不算完得验证。我一般分三步走每一步都能定位到具体是哪一层断了。第一步在对话里明确写入一条可检索的记忆。比如直接说“记住我的项目叫 nova所有变量命名用 snake_case。” 然后看 workspace 目录有没有新文件生成ls -la ./openclaw_workspace/memory/正常的话会看到类似2025-06-01.jsonl或memory.db的文件里面应该包含刚才那条偏好。如果目录是空的说明auto_save没生效或者long_term被关了。第二步正常退出进程然后重新启动openclaw --config ./config.toml第三步开一个新会话直接问“我的项目叫什么变量命名用什么风格” 如果它能答出 nova 和 snake_case说明 workspace 加载链路是通的。如果答不出来但memory/目录里确实有那条记录那就是加载环节的问题重点查session.scope和memory.path是否对得上。也可以用 API 方式直接验证模型通道是否正常排除 Key 问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 ok}] }返回里有正常内容说明通道没问题记忆丢失就跟模型无关专心查 session 和 workspace。5. 本篇常见错排查session 过期还是 workspace 没落盘排查时先分清两种体感。第一种是“完全接不上”第二天问什么都说不知道这通常是 session 过期加上 workspace 没落盘等于两头都没保住。第二种是“记得一半”有些设定还在有些丢了这往往是 workspace 写了但加载不全或者extract_rules没覆盖到那类信息。常见错误一session.ttl_hours设得太短。默认 24 小时看着够但如果你习惯隔天下午才来可能刚好卡在过期边缘。可以先临时调到 72 小时验证确认是过期问题后再调回合理值。常见错误二workspace.root用了相对路径但启动时工作目录变了。比如你在~/projects下启动配置里写./openclaw_workspace实际写到~/projects/openclaw_workspace下次在~下启动读的是~/openclaw_workspace自然读不到。改成绝对路径最稳。常见错误三memory.store设成sqlite但没建表。切到file模式先跑通再换 sqlite。常见错误四session.scope设成global多个渠道共用一个会话互相覆盖。按channel_user隔离更稳。如果排查中需要确认 Key 权限或重新生成走 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。接入细节和字段说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。6. 长期编码与 Agent 场景让记忆真正稳定下来如果你不只是聊天而是拿 OpenClaw 跑长期编码任务或 Agent 流程记忆稳定性要求更高。这时候建议把 Coding Plan 用起来它针对长周期任务做了会话保持和记忆沉淀的优化https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。配合前面config.toml里的save_interval_sec调小到 10 秒基本可以做到进程异常退出也不丢关键上下文。最后说个我踩过的坑一开始我只开了long_term没开auto_save结果 session 里的内容一直没写进 workspace重启后全没了。后来把两个开关都打开并且把workspace.root改成绝对路径隔天再问项目名和命名风格它都能准确答出来。记忆这件事配置对了就不玄学。