OpenClaw存档分五类:一、状态目录(~/.openclaw)含身份凭证与配置;二、工作区目录(默认~/.openclaw/workspace)存知识资产;三、媒体目录(由media.root指定或默认~/.openclaw/media)存非文本附件;四、备份文件(.bak.)位于状态目录;五、云挂载点(如/home/lighthouse/lhcos-data)同步三类数据。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您需要查找 OpenClaw 的存档文件,但无法定位其具体存放位置,则可能是由于对 OpenClaw 的数据分层结构缺乏系统认知。OpenClaw 将数据划分为状态、工作区和媒体三类核心存档区域,每类对应不同路径与用途。以下是定位与管理这些存档文件的详细步骤:
一、状态目录(State Directory)
该目录保存 OpenClaw 的运行根基:身份凭证、会话状态、通道登录信息及主配置文件。一旦丢失,将导致 WhatsApp 登录失效、API 密钥不可用、代理历史清空等不可逆后果。其默认路径为用户主目录下的隐藏文件夹。
1、打开终端(Linux/macOS)或 PowerShell(Windows)。
2、执行命令 cd ~/.openclaw 进入状态根目录。
3、运行 ls -la 查看全部内容,重点关注:openclaw.json(主配置)、auth/(认证凭据)、sessions/(会话快照)、channels/(如 whatsapp/ 目录含登录二维码缓存)。
二、工作区目录(Workspace Directory)
工作区是 OpenClaw 的“记忆中枢”,存储所有语义化知识资产,包括角色设定、技能脚本、记忆标记和辅助文档。即使状态目录损坏,只要工作区完好,OpenClaw 重启后仍能恢复身份认知与行为逻辑。
1、确认当前工作区路径:执行 openclaw configget agents.defaults.workspace 获取实际路径值。
2、若返回为空或默认值,标准路径为 ~/.openclaw/workspace。
3、进入该目录后,检查以下关键文件与子目录:MEMORY.md(每日记忆入口)、memory/(长期记忆片段)、SOUL.md(人格锚点)、skills/(已安装技能包)。
三、媒体与附件文件夹
该路径用于持久化保存聊天中接收或生成的非文本内容,如语音、图片、PDF 和截图。是否启用取决于 openclaw.json 中 media 配置段的设置,属于可选但高价值存档项。
1、查看媒体根路径:执行 openclaw configget media.root。
2、若未显式配置,系统将回退至 ~/.openclaw/media。
3、在该目录下,按日期子目录组织(如 2026-03-12/),每个子目录内含原始文件及其 JSON 元数据描述文件(如 msg_abc123.jpg 与 msg_abc123.json)。
四、备份存档文件(.bak.*)位置
OpenClaw 在执行配置热重载、迁移或自动归档时,会生成带时间戳的备份副本,用于故障回滚。这些文件不参与运行,但包含完整机密信息,需与主配置同等保护。
1、进入状态目录:cd ~/.openclaw。
2、执行 ls -t *.bak.* 列出全部备份文件,按修改时间倒序排列。
3、典型命名格式为:openclaw.json.bak.20260312-142231(含日期与毫秒级时间戳)。
五、云存储挂载点(Lighthouse COS)
当使用腾讯云轻量服务器并启用 Lighthouse COS 持久化方案时,OpenClaw 可通过挂载目录将本地存档同步至对象存储。该路径独立于本地文件系统,需通过服务器挂载配置识别。
1、查看挂载状态:执行 findmnt | grep lhcos。
2、确认挂载点输出中的 TARGET 字段,例如 /home/lighthouse/lhcos-data。
3、进入该路径后,检查子目录结构:state/(对应状态目录镜像)、workspace/(工作区同步副本)、media/(媒体全量归档)。










