1. openclaw 记忆文件到底在解决什么问题openclaw 的记忆 memory 文件配置说白了就是让本地 AI 工具链在跨会话时还能记住你的偏好、项目背景和昨天聊过的方案。它不是一个抽象概念而是落在磁盘上的一组 Markdown 与 JSONL 文件MEMORY.md存长期事实memory/YYYY-MM-DD.md存当天流水sessions/存原始会话USER.md和SOUL.md分别锚定用户画像与 Agent 人格。适合谁适合在本地跑 openclaw、又想把模型请求统一走一个 Key/API 通道的开发者——你既不想每次换模型都改一堆环境变量也不想记忆文件因为通道配置写错而根本没被加载。我见过最常见的翻车现场是settings.json里通道字段写对了但 memory 路径用了相对路径启动目录一换Agent 就“失忆”了或者 Key 塞进了错误的层级请求能通但记忆读写静默失败。这篇就围绕settings.json骨架把 memory 路径与 TaoToken 通道字段一次写清楚再附一次启动加载与记忆读写的验证动作让你自己能确认 memory 文件被正确识别。核心检索词先摆出来openclaw 记忆 memory 文件配置本质是两件事——记忆落盘位置和模型请求出口。前者决定 Agent 记不记得住后者决定它能不能稳定调用模型。两者在settings.json里是分开的字段混在一起写就会互相干扰。2. TaoToken 前置统一 Key 与通道字段怎么摆TaoToken 在这里的角色是统一 Key/API 通道。你不需要在 openclaw 里为每个模型单独配一套凭证而是把请求出口指向一个兼容接口Key 用同一套。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM。在动手改settings.json之前先把 Key 准备好。到控制台创建 API Key路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 然后在 API Keys 页面生成并复制页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这一步别跳过后面所有验证都依赖这个 Key。注意Key 只放在settings.json的通道字段里不要写进MEMORY.md或USER.md。记忆文件是给模型读的凭证泄露风险要自己兜住。如果你后面要长期跑编码或 Agent 任务可以了解 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和字段说明在文档里地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先验证模型通不通用模型对话页面最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. 可复制的 settings.json 骨架含 memory 路径与通道字段下面这份骨架可以直接抄改三个地方apiKey、workspace的绝对路径、model名称。其余字段保持结构即可。{ openclaw: { workspace: /Users/yourname/.openclaw/workspace, memory: { enabled: true, longTermFile: MEMORY.md, shortTermDir: memory, sessionsDir: sessions, userFile: USER.md, soulFile: SOUL.md, loadTodayAndYesterday: true, maxShortTermFiles: 7 }, provider: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-5, timeoutMs: 60000, maxRetries: 2 } } }几个字段值得单独说。workspace必须是绝对路径openclaw 启动时不会帮你解析~写成~/.openclaw/workspace在部分 shell 下会失败。memory.longTermFile和shortTermDir是相对workspace的路径不要写成绝对路径否则加载器会拼出双斜杠或找不到文件。loadTodayAndYesterday控制新会话是否自动加载今天和昨天的日志调试阶段建议保持true方便你观察记忆是否被读进来。provider.baseUrl指向https://taotoken.net/api注意结尾不要多加/v1openclaw 的兼容层会自己补。provider.type用openai-compatible即可这是最通用的对接方式。maxRetries设 2 是为了在网络抖动时自动重试但别设太大否则记忆写入失败会拖慢启动。提示如果你的 openclaw 版本把 provider 配置放在独立的providers.json把上面provider整块挪过去memory块留在settings.json。字段名不变。目录结构要和字段对应上启动前确认工作区长这样/Users/yourname/.openclaw/workspace/ ├── MEMORY.md ├── USER.md ├── SOUL.md ├── memory/ │ ├── 2026-03-05.md │ └── 2026-03-04.md └── sessions/ └── session-001.jsonlMEMORY.md里先写一行可识别的内容比如- 用户偏好使用 Python 3.12代码风格简洁。这行会在验证阶段被读出来用来确认长期记忆加载成功。4. 启动加载与记忆读写的验证动作配置写完先做启动加载验证。在终端里跑cd /Users/yourname/.openclaw openclaw --config ./settings.json --log-level debug观察日志里有没有这几行关键输出memory: long-term file loaded、memory: short-term files loaded count2、provider: baseUrlhttps://taotoken.net/api。如果long-term file loaded没出现说明longTermFile路径拼错了或者文件不存在。如果provider那行没出现说明provider块没被解析检查 JSON 是否有多余逗号。启动成功后做一次记忆读写验证。在 openclaw 交互界面里输入请读取 MEMORY.md 的第一条内容并原样返回预期返回类似用户偏好使用 Python 3.12代码风格简洁。如果返回的是“无法访问文件”或空内容说明记忆加载器没拿到workspace路径回到settings.json检查workspace是否为绝对路径。再验证写入。输入把“今天验证了 memory 加载”追加到今天的日志文件然后去memory/目录看当天的YYYY-MM-DD.md应该多出一行。如果文件没变化但对话里模型说“已写入”那多半是shortTermDir指向了别处或者进程没有写权限。用ls -la memory/确认目录权限必要时chmod 755 memory。最后验证通道是否真的走了 TaoToken。在 debug 日志里搜POST https://taotoken.net/api能看到请求记录就说明通道字段生效了。如果看到的是别的域名说明baseUrl被其他配置覆盖了检查有没有环境变量OPENAI_BASE_URL之类的在抢优先级。5. 本篇常见错排查报错一memory: long-term file not found。九成是workspace用了相对路径或~。openclaw 不做 shell 展开改成/Users/yourname/.openclaw/workspace这种绝对路径即可。另一个可能是longTermFile写成了./MEMORY.md去掉./。报错二provider: unauthorized 401。Key 错了或没带对前缀。TaoToken 的 Key 通常以sk-开头复制时别把前后空格带进去。如果 Key 正确仍 401检查baseUrl是不是写成了https://taotoken.net/api/带尾斜杠某些兼容层会把尾斜杠拼成双斜杠导致鉴权失败。报错三记忆文件被加载但内容为空。检查MEMORY.md的编码必须是 UTF-8 无 BOM。用file MEMORY.md确认。如果是 UTF-16加载器会读出乱码或空字符串。报错四新会话不加载昨天日志。loadTodayAndYesterday为true时加载器按系统日期找YYYY-MM-DD.md。如果你的系统时区和日志文件名日期不一致就会找不到。统一用本地日期命名或者把maxShortTermFiles调大让它按文件名排序兜底。报错五写入记忆后重启丢失。说明写的是内存缓存没落盘。检查memory.enabled是否为true以及shortTermDir是否有写权限。用touch memory/test.md手动测一下权限能创建就说明是配置问题不能创建就是权限问题。注意排查时优先看 debug 日志里的memory:和provider:前缀行这两类行能覆盖 80% 的配置错误。别一上来就改代码。6. 把通道和记忆分开管后面少踩坑实测下来openclaw 的记忆问题和通道问题经常被混在一起报错但它们的排查路径完全不同。记忆看workspace和memory块通道看provider块。把这两块在settings.json里物理隔开日志里也分开打前缀定位速度会快很多。如果你要长期跑编码或 Agent 任务建议把 Key 和通道配置固定下来用 Coding Plan 管理额度入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入字段有疑问就翻文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想快速确认某个模型在当前通道下能不能调通直接去模型对话页面发一条消息https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Key 管理和新建都在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我自己的习惯每次改完settings.json先跑一次openclaw --config ./settings.json --dry-run如果你的版本支持它会打印解析后的 memory 路径和 provider 基址不用真启动就能看出字段有没有被正确读取。这个动作比反复重启省时间。
1. openclaw 记忆文件到底在解决什么问题openclaw 的记忆 memory 文件配置说白了就是让本地 AI 工具链在跨会话时还能记住你的偏好、项目背景和昨天聊过的方案。它不是一个抽象概念而是落在磁盘上的一组 Markdown 与 JSONL 文件MEMORY.md存长期事实memory/YYYY-MM-DD.md存当天流水sessions/存原始会话USER.md和SOUL.md分别锚定用户画像与 Agent 人格。适合谁适合在本地跑 openclaw、又想把模型请求统一走一个 Key/API 通道的开发者——你既不想每次换模型都改一堆环境变量也不想记忆文件因为通道配置写错而根本没被加载。我见过最常见的翻车现场是settings.json里通道字段写对了但 memory 路径用了相对路径启动目录一换Agent 就“失忆”了或者 Key 塞进了错误的层级请求能通但记忆读写静默失败。这篇就围绕settings.json骨架把 memory 路径与 TaoToken 通道字段一次写清楚再附一次启动加载与记忆读写的验证动作让你自己能确认 memory 文件被正确识别。核心检索词先摆出来openclaw 记忆 memory 文件配置本质是两件事——记忆落盘位置和模型请求出口。前者决定 Agent 记不记得住后者决定它能不能稳定调用模型。两者在settings.json里是分开的字段混在一起写就会互相干扰。2. TaoToken 前置统一 Key 与通道字段怎么摆TaoToken 在这里的角色是统一 Key/API 通道。你不需要在 openclaw 里为每个模型单独配一套凭证而是把请求出口指向一个兼容接口Key 用同一套。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM。在动手改settings.json之前先把 Key 准备好。到控制台创建 API Key路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 然后在 API Keys 页面生成并复制页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这一步别跳过后面所有验证都依赖这个 Key。注意Key 只放在settings.json的通道字段里不要写进MEMORY.md或USER.md。记忆文件是给模型读的凭证泄露风险要自己兜住。如果你后面要长期跑编码或 Agent 任务可以了解 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和字段说明在文档里地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先验证模型通不通用模型对话页面最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. 可复制的 settings.json 骨架含 memory 路径与通道字段下面这份骨架可以直接抄改三个地方apiKey、workspace的绝对路径、model名称。其余字段保持结构即可。{ openclaw: { workspace: /Users/yourname/.openclaw/workspace, memory: { enabled: true, longTermFile: MEMORY.md, shortTermDir: memory, sessionsDir: sessions, userFile: USER.md, soulFile: SOUL.md, loadTodayAndYesterday: true, maxShortTermFiles: 7 }, provider: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-5, timeoutMs: 60000, maxRetries: 2 } } }几个字段值得单独说。workspace必须是绝对路径openclaw 启动时不会帮你解析~写成~/.openclaw/workspace在部分 shell 下会失败。memory.longTermFile和shortTermDir是相对workspace的路径不要写成绝对路径否则加载器会拼出双斜杠或找不到文件。loadTodayAndYesterday控制新会话是否自动加载今天和昨天的日志调试阶段建议保持true方便你观察记忆是否被读进来。provider.baseUrl指向https://taotoken.net/api注意结尾不要多加/v1openclaw 的兼容层会自己补。provider.type用openai-compatible即可这是最通用的对接方式。maxRetries设 2 是为了在网络抖动时自动重试但别设太大否则记忆写入失败会拖慢启动。提示如果你的 openclaw 版本把 provider 配置放在独立的providers.json把上面provider整块挪过去memory块留在settings.json。字段名不变。目录结构要和字段对应上启动前确认工作区长这样/Users/yourname/.openclaw/workspace/ ├── MEMORY.md ├── USER.md ├── SOUL.md ├── memory/ │ ├── 2026-03-05.md │ └── 2026-03-04.md └── sessions/ └── session-001.jsonlMEMORY.md里先写一行可识别的内容比如- 用户偏好使用 Python 3.12代码风格简洁。这行会在验证阶段被读出来用来确认长期记忆加载成功。4. 启动加载与记忆读写的验证动作配置写完先做启动加载验证。在终端里跑cd /Users/yourname/.openclaw openclaw --config ./settings.json --log-level debug观察日志里有没有这几行关键输出memory: long-term file loaded、memory: short-term files loaded count2、provider: baseUrlhttps://taotoken.net/api。如果long-term file loaded没出现说明longTermFile路径拼错了或者文件不存在。如果provider那行没出现说明provider块没被解析检查 JSON 是否有多余逗号。启动成功后做一次记忆读写验证。在 openclaw 交互界面里输入请读取 MEMORY.md 的第一条内容并原样返回预期返回类似用户偏好使用 Python 3.12代码风格简洁。如果返回的是“无法访问文件”或空内容说明记忆加载器没拿到workspace路径回到settings.json检查workspace是否为绝对路径。再验证写入。输入把“今天验证了 memory 加载”追加到今天的日志文件然后去memory/目录看当天的YYYY-MM-DD.md应该多出一行。如果文件没变化但对话里模型说“已写入”那多半是shortTermDir指向了别处或者进程没有写权限。用ls -la memory/确认目录权限必要时chmod 755 memory。最后验证通道是否真的走了 TaoToken。在 debug 日志里搜POST https://taotoken.net/api能看到请求记录就说明通道字段生效了。如果看到的是别的域名说明baseUrl被其他配置覆盖了检查有没有环境变量OPENAI_BASE_URL之类的在抢优先级。5. 本篇常见错排查报错一memory: long-term file not found。九成是workspace用了相对路径或~。openclaw 不做 shell 展开改成/Users/yourname/.openclaw/workspace这种绝对路径即可。另一个可能是longTermFile写成了./MEMORY.md去掉./。报错二provider: unauthorized 401。Key 错了或没带对前缀。TaoToken 的 Key 通常以sk-开头复制时别把前后空格带进去。如果 Key 正确仍 401检查baseUrl是不是写成了https://taotoken.net/api/带尾斜杠某些兼容层会把尾斜杠拼成双斜杠导致鉴权失败。报错三记忆文件被加载但内容为空。检查MEMORY.md的编码必须是 UTF-8 无 BOM。用file MEMORY.md确认。如果是 UTF-16加载器会读出乱码或空字符串。报错四新会话不加载昨天日志。loadTodayAndYesterday为true时加载器按系统日期找YYYY-MM-DD.md。如果你的系统时区和日志文件名日期不一致就会找不到。统一用本地日期命名或者把maxShortTermFiles调大让它按文件名排序兜底。报错五写入记忆后重启丢失。说明写的是内存缓存没落盘。检查memory.enabled是否为true以及shortTermDir是否有写权限。用touch memory/test.md手动测一下权限能创建就说明是配置问题不能创建就是权限问题。注意排查时优先看 debug 日志里的memory:和provider:前缀行这两类行能覆盖 80% 的配置错误。别一上来就改代码。6. 把通道和记忆分开管后面少踩坑实测下来openclaw 的记忆问题和通道问题经常被混在一起报错但它们的排查路径完全不同。记忆看workspace和memory块通道看provider块。把这两块在settings.json里物理隔开日志里也分开打前缀定位速度会快很多。如果你要长期跑编码或 Agent 任务建议把 Key 和通道配置固定下来用 Coding Plan 管理额度入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入字段有疑问就翻文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想快速确认某个模型在当前通道下能不能调通直接去模型对话页面发一条消息https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Key 管理和新建都在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我自己的习惯每次改完settings.json先跑一次openclaw --config ./settings.json --dry-run如果你的版本支持它会打印解析后的 memory 路径和 provider 基址不用真启动就能看出字段有没有被正确读取。这个动作比反复重启省时间。
