OpenClaw Agent重启后丢失上下文

症状

• Agent重启后，无法访问之前的对话历史
• memory_search返回空或旧结果
• 任务进行到一半，重启后需要重新开始

快速诊断（30秒内）

检查1：Session配置

# 查看当前Session配置
cat ~/.openclaw/openclaw.json | grep -A 5 'session'

检查2：Session文件是否存在

# 检查Session存储目录
ls -la ~/.openclaw/agents/*/sessions/

检查3：dmScope设置

# 检查DM隔离配置
grep 'dmScope' ~/.openclaw/openclaw.json

问题确认

• 如果dmScope为main，所有对话共享同一会话，重启后可能混淆
• 如果Session文件为空或不存在，说明未持久化

解决方案

方案1：启用Session持久化（推荐，2分钟）

编辑~/.openclaw/openclaw.json：

{
  "session": {
    "dmScope": "per-channel-peer",
    "maintenance": {
      "mode": "enforce",
      "pruneAfter": "30d"
    }
  }
}

重启Gateway生效：

openclaw gateway restart

方案2：手动恢复Session（紧急，5分钟）

如果Session文件存在但Agent未加载：

# 1. 找到最近的Session文件
ls -lt ~/.openclaw/agents/*/sessions/*.jsonl | head -5

# 2. 检查Session内容
head -20 ~/.openclaw/agents/*/sessions/{session-id}.jsonl

在Agent启动时指定Session ID（高级）：

openclaw sessions restore {session-id}

预防措施

配置项

• 设置dmScope: per-channel-peer确保会话隔离
• 设置maintenance.mode: enforce自动维护Session
• 设置maintenance.pruneAfter: 30d保留30天历史

最佳实践

• 重要信息及时写入MEMORY.md
• 长任务定期保存进度到文件
• 使用memory_flush在关键节点持久化

相关错误

• OpenClaw Session隔离失效
• OpenClaw Memory搜索无结果
• OpenClaw Bootstrap文件未加载

参考资料

• OpenClaw官方文档 - Session管理
• OpenClaw官方文档 - Memory系统
• OpenClaw GitHub - 配置示例