$cd ../troubleshooting/
网关重启后 Telegram 群组会话重置
// 重启 OpenClaw 网关后，绑定到 Telegram 群组的代理会创建全新会话，而不是从 sessions.json 恢复。会话密钥映射存在，但群组会话在启动时不会被恢复。
symptoms.log
🔍 症状
✗网关重启后，机器人失去之前对话的记忆
✗代理的行为好像第一次与群组见面
✗sessions.json 存在且具有正确的会话条目
✗Telegram 群聊受影响 — 私信 DM 可能正常恢复
check_sessions.sh
✅ 修复方法 1 — 验证 sessions.json 是否被持久化
验证会话持久化
# 检查 sessions.json 是否存在并包含您的 Telegram 群组会话 cat ~/.openclaw/sessions.json | jq 'keys' # 查找类似条目：telegram:group:-1001234567890 # 如果为空或缺失，则会话从未被持久化
agent_config.yaml
✅ 修复方法 2 — 为群组代理设置明确的 sessionKey
设置与 sessions.json 键匹配的明确 sessionKey
agents:
- name: my-group-bot
channel: telegram
sessionKey: "telegram:group:-1001234567890" # 明确的 key
memory:
persist: truegateway.yaml
✅ 修复方法 3 — 在网关启动时启用会话恢复
网关启动时强制从 sessions.json 恢复会话
gateway:
sessions:
restoreOnBoot: true
restoreChannels:
- telegramℹ 已知问题
这是在 Issue #35283 中追踪的已确认错误。根本原因是当会话密钥映射存在但指向群聊时，网关启动不会从 sessions.json 重新水化 Telegram 群组会话。修复正在进行中。
❓ 常见问题
Q1. sessions.json 存储在哪里？
默认在主机的 ~/.openclaw/sessions.json 或 Docker 内的 /app/data/sessions.json。确保此文件在重启后持久化。如使用 Docker，为数据目录添加卷挂载：'./data:/app/data'。没有此挂载，每次容器重启都会清除会话文件。
Q2. 可以手动恢复会话吗？
可以。如果有 sessions.json 备份，用 'docker compose down' 停止网关，将文件替换到 ~/.openclaw/sessions.json，然后用 'docker compose up -d' 重启。网关在启动时读取 sessions.json。重启后通过向 Telegram 群发送测试消息验证会话是否已恢复——机器人应该记住之前的上下文。
Q3. 这会影响 WhatsApp 或 Discord 会话吗？
WhatsApp 会话使用独立的认证状态目录（Baileys auth 文件夹），不受 sessions.json 问题影响。Discord 会话基于令牌——机器人令牌是无状态的，重启后无需会话文件即可自动重连。此 Bug 特定于 sessions.json 中的 Telegram 群组会话键映射。
Q4. 如何找到我的 Telegram 群组聊天 ID？
聊天 ID 是 sessionKey 中的数字（如 'telegram:group:-1001234567890'）。查找方式：(1) 在群组中添加 @userinfobot——它会报告群组 ID；(2) 查看 OpenClaw 调试日志，群组消息到达时会记录 chat_id；(3) 使用 Telegram Bot API：从群组发送消息后，GET 请求 'https://api.telegram.org/bot<token>/getUpdates'。
Q5. 修复后几天又重置了，这是怎么回事？
这通常意味着 sessions.json 被覆盖而非更新。检查部署流程是否有 'docker compose down -v'（会删除卷）或在部署时覆盖数据目录。同时检查是否使用了 '--force-recreate'（会销毁容器文件系统）。使用命名 Docker 卷（'sessions_data:/app/data'）而非绑定挂载——命名卷在 '--force-recreate' 后仍会保留。
Q6. 有办法在会话重置时收到通知吗？
有。在监控配置中设置 webhook 或 Telegram 通知。OpenClaw 可以在检测到会话重置时向特定 Telegram 聊天发送自我通知。或者在网关配置中设置 'notify_on_session_reset: true'——每当会话从头创建而非从备份恢复时，它会向机器人自己的聊天（或指定的管理员聊天）发送消息。