O
OpenClaw

会话管理

OpenClaw 使用会话来管理对话上下文,支持多会话并行和持久化存储。

会话概念

🎯 会话隔离

每个聊天频道都有独立的会话,不同频道的对话不会相互影响。

💾 持久化存储

会话历史会自动保存,重启后仍然可以继续之前的对话。

🔒 隐私保护

所有会话数据都存储在本地,不会上传到云端。

⚡ 内存优化

支持会话过期和自动清理,避免内存无限增长。

会话配置

{
  "memory": {
    "backend": "sqlite",
    "sqlite": {
      "path": "~/.openclaw/memory.db"
    }
  },
  "agents": {
    "defaults": {
      "maxHistoryMessages": 100,
      "sessionTimeoutMinutes": 60
    }
  }
}

配置项说明

memory.backendstring

会话存储后端,支持 sqlite、qmd 等

maxHistoryMessagesnumber

单个会话保留的最大消息数,超出部分会被截断

sessionTimeoutMinutesnumber

会话空闲超时时间(分钟),超时后会被清理

常用命令

/session/s

查看当前会话信息

/clear

清空当前会话历史

/reset

重置当前会话(相当于开始新对话)

/memory

查看长期记忆内容

多设备同步

如果你在多个设备上运行 OpenClaw,可以配置共享的存储后端来实现会话同步。

{
  "memory": {
    "backend": "qmd",
    "qmd": {
      "url": "http://your-qmd-server:7700"
    }
  }
}

⚠️ 注意事项

  • 会话数据包含对话内容,请确保存储位置安全
  • 定期备份重要的会话数据
  • 修改存储配置后需要重启 Gateway