切换渠道与查找消息记录全技巧指南
找不到三天前的数据库迁移对话记录？这不是OpenClaw的“记忆”问题，而是它的本地会话存档机制——所有历史对话都以独立的JSONL文件形式存储在你本地，相当于一套完整的离线聊天档案馆。我们直接进入核心，帮你精准定位并恢复目标会话。
定位本地会话文件存储位置
所有会话数据默认存储在你的本地磁盘。根据系统不同，核心路径如下：
- Linux/macOS 用户:
~/.openclaw/agents/main/sessions/ - Windows 用户:
%USERPROFILE%\.openclaw\agents\main\sessions\
进入目录后，你会看到一系列以UUID命名的.jsonl文件。每个文件对应一次独立对话，采用标准的JSON Lines格式逐行记录消息、角色和时间戳。文件结构清晰，但为保持完整性和可读性，请避免直接编辑。
在Linux/macOS环境中，可使用以下命令快速查看最近修改的会话文件：ls -lh ~/.openclaw/agents/main/sessions/*.jsonl | head -20，便于你根据时间线索进行初步筛选。
快速筛选含关键词的历史会话
要从海量会话文件中精准定位，最有效的方式是使用终端命令进行内容检索。
方法一：关键词全局检索
执行以下命令，对所有会话文件进行内容扫描：
grep -l “数据库\|migration\|schema” ~/.openclaw/agents/main/sessions/*.jsonl
命令会直接输出包含任意指定关键词（如“数据库”、“migration”、“schema”）的文件名列表。
方法二：文件内容预览验证
获取疑似文件名后，建议预览文件头部内容以确认：
head -n 10 ~/.openclaw/agents/main/sessions/目标文件名.jsonl
这将显示文件的前10行，足以判断会话主题是否匹配你的数据库迁移问题。
重要提示：JSONL文件格式要求严格，每行必须是一个有效的JSON对象。任何直接的手动编辑都可能导致文件解析失败，进而使会话无法加载。请仅将此文件用于查看和检索。
切换到指定历史会话
定位到目标文件后，需要通过修改配置文件来引导OpenClaw加载该历史会话。请按顺序执行以下操作：
第一步：停止网关服务
执行openclaw gateway stop。此步骤至关重要，可防止运行中的服务覆盖你的配置修改。
第二步：备份当前会话配置
操作前备份配置文件，为回滚做好准备：
cp ~/.openclaw/agents/main/sessions/sessions.json ~/.openclaw/agents/main/sessions/sessions.json.backup
第三步：编辑核心配置文件
使用文本编辑器打开sessions.json文件，定位并修改以下两个关键字段：
sessionId: 填入目标会话的ID（即JSONL文件名中的UUID部分）。sessionFile: 填入该.jsonl文件的绝对路径。
第四步：重启并验证会话激活
启动网关服务：openclaw gateway start
随后，运行openclaw sessions命令进行验证。检查输出中的activeSessionId字段，确认其值与你填入的目标会话ID完全一致。若一致，则表明你已成功恢复至指定历史对话的完整上下文中。