【Bug已解决】openclaw: session ID mismatch / Resume target not found — OpenClaw 会话 ID 不匹配解决方案1. 问题描述OpenClaw 使用 --resume 恢复会话时会话 ID 不匹配或找不到目标# 会话 ID 不匹配 $ openclaw --resume session-abc123 Error: Session ID mismatch Session session-abc123 not found in session store. # 或恢复目标不存在 $ openclaw --resume abc123 Error: Resume target not found No session with ID abc123. # 或会话 ID 格式错误 $ openclaw --resume ses_abc Error: Invalid session ID format Expected format: session-xxxxxxxx. # 或旧会话已过期 $ openclaw --resume session-old123 Error: Session expired Session session-old123 has been cleaned up.这个问题在以下场景中特别常见会话 ID 拼写错误会话已被清理格式不正确会话文件损坏多用户环境冲突清理工具误删2. 原因分析原因分类具体表现占比ID 拼写错误typo约 35%会话已清理expired约 25%格式错误ses_约 20%文件损坏corrupt约 10%多用户冲突覆盖约 5%清理误删rm约 5%3. 解决方案方案一使用 --list-sessions 查找正确 ID最推荐# 步骤 1列出所有会话 openclaw --list-sessions # 步骤 2复制正确的 ID openclaw --resume session-correct-id-123 # 步骤 3或使用 --continue 恢复最近的 openclaw --continue # 步骤 4验证 openclaw --debug 21 | grep -i session方案二检查会话文件# 步骤 1检查会话目录 ls -la ~/.openclaw/sessions/ # 步骤 2查找特定会话 ls ~/.openclaw/sessions/ | grep session-abc # 步骤 3如果不存在使用 --continue openclaw --continue # 步骤 4验证 openclaw --print hello方案三使用 --continue 代替# 步骤 1使用 --continue 恢复最近的会话 openclaw --continue # 步骤 2如果最近会话也不对 openclaw --continue --print 继续上次的任务 # 步骤 3或新会话 openclaw task # 新会话 # 步骤 4验证 openclaw --print hello方案四修复会话 ID 格式# 步骤 1检查 ID 格式 # 正确: session-xxxxxxxx (UUID 格式) # 错误: ses_abc, abc123, session-abc # 步骤 2使用 --list-sessions 获取正确格式 openclaw --list-sessions # 步骤 3复制完整的 ID openclaw --resume session-a1b2c3d4-e5f6-7890-abcd-ef1234567890 # 步骤 4验证 openclaw --print hello方案五检查会话文件损坏# 步骤 1检查 JSON 格式 python3 -m json.tool ~/.openclaw/sessions/session-abc123.json # 步骤 2如果损坏删除 rm ~/.openclaw/sessions/session-abc123.json # 步骤 3使用 --continue 恢复其他会话 openclaw --continue # 步骤 4验证 openclaw --print hello方案六保存上下文到文件# 步骤 1保存当前会话上下文 openclaw --print 将讨论要点保存到 docs/context.md # 步骤 2新会话引用 openclaw 参考 docs/context.md 继续工作 # 步骤 3或使用 Git git add -A git commit -m Save session context # 步骤 4验证 cat docs/context.md openclaw --print hello4. 各方案对比总结方案适用场景推荐指数难度方案一--list-sessions排查⭐⭐⭐⭐⭐低方案二检查文件文件⭐⭐⭐⭐⭐低方案三--continue替代⭐⭐⭐⭐⭐低方案四修复格式格式⭐⭐⭐⭐⭐低方案五修复损坏损坏⭐⭐⭐⭐低方案六保存上下文长期⭐⭐⭐⭐⭐低5. 常见问题 FAQ5.1 如何查找会话 IDopenclaw --list-sessions5.2 --resume 和 --continue 的区别--resume id: 恢复指定会话--continue: 恢复最近的会话5.3 会话 ID 格式通常session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxUUID 格式。5.4 会话已被清理使用--continue或开始新会话。5.5 会话文件在哪里~/.openclaw/sessions/目录下。5.6 如何检查会话是否损坏python3 -m json.tool ~/.openclaw/sessions/session-id.json5.7 多用户冲突每个用户使用独立的~/.openclaw/目录。5.8 如何保存上下文openclaw --print 将讨论保存到 docs/context.md5.9 清理工具误删将~/.openclaw/sessions/加入排除列表。5.10 排查清单速查表□ 1. openclaw --list-sessions 列出 □ 2. 复制正确的 session ID □ 3. openclaw --continue 恢复最近 □ 4. ls ~/.openclaw/sessions/ 检查 □ 5. python3 -m json.tool 验证 □ 6. rm 损坏的会话文件 □ 7. 检查 ID 格式: session-uuid □ 8. 保存上下文到 docs/context.md □ 9. git commit 保存进度 □ 10. 新会话代替恢复6. 总结根本原因会话 ID 不匹配最常见原因是拼写错误35%和会话已清理25%最佳实践使用openclaw --list-sessions查找正确的会话 ID--continue使用openclaw --continue恢复最近的会话保存上下文使用openclaw --print 保存到 docs/context.md保存讨论最佳实践建议检查 ID 格式UUID将 sessions/ 加入清理排除列表故障排查流程图flowchart TD A[会话 ID 不匹配] -- B[openclaw --list-sessions] B -- C{会话存在?} C --|是| D[复制正确 ID] C --|否| E[使用 --continue] D -- F[openclaw --resume 正确 ID] F -- G{成功?} G --|是| H[✅ 问题解决] G --|否| I[检查 ID 格式] E -- j[openclaw --continue] j -- G I -- K{格式正确?} K --|否| L[修复为 UUID 格式] K --|是| M[检查文件损坏] L -- F M -- N[python3 -m json.tool] N -- O{JSON 有效?} O --|否| P[rm 损坏文件] O --|是| Q[检查权限] P -- E Q -- R[ls -la sessions/] R -- S{权限正确?} S --|否| T[sudo chown -R] S --|是| U[保存上下文] T -- F U -- V[openclaw --print 保存到 docs] V -- W[新会话引用] W -- H H -- X[长期: list-sessions --continue 保存] X -- Y[✅ 长期方案]