【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 2>&1 | 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 "hello"

4. 各方案对比总结

方案	适用场景	推荐指数	难度
方案一：--list-sessions	排查	⭐⭐⭐⭐⭐	低
方案二：检查文件	文件	⭐⭐⭐⭐⭐	低
方案三：--continue	替代	⭐⭐⭐⭐⭐	低
方案四：修复格式	格式	⭐⭐⭐⭐⭐	低
方案五：修复损坏	损坏	⭐⭐⭐⭐	低
方案六：保存上下文	长期	⭐⭐⭐⭐⭐	低

5. 常见问题 FAQ

5.1 如何查找会话 ID

openclaw --list-sessions

5.2 --resume 和 --continue 的区别

• --resume <id>: 恢复指定会话
• --continue: 恢复最近的会话

5.3 会话 ID 格式

通常 session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（UUID 格式）。

5.4 会话已被清理

使用 --continue 或开始新会话。

5.5 会话文件在哪里

~/.openclaw/sessions/ 目录下。

5.6 如何检查会话是否损坏

python3 -m json.tool ~/.openclaw/sessions/session-id.json

5.7 多用户冲突

每个用户使用独立的 ~/.openclaw/ 目录。

5.8 如何保存上下文

openclaw --print "将讨论保存到 docs/context.md"

5.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. 总结

1. 根本原因：会话 ID 不匹配最常见原因是拼写错误（35%）和会话已清理（25%）
2. 最佳实践：使用 openclaw --list-sessions 查找正确的会话 ID
3. --continue：使用 openclaw --continue 恢复最近的会话
4. 保存上下文：使用 openclaw --print "保存到 docs/context.md" 保存讨论
5. 最佳实践建议：检查 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[✅ 长期方案]