夜雨聆风前言：
OpenClaw不管是在个人PC或者云部署都非常简单，安装后自动在用户目录~/.openclaw下生成文件，本文对该文件夹的内容介绍说明，同时在不同使用场景下文件备份详细介绍。
1 目录结构概览
⁘ 1.1 单Agent（默认）
├── agents #智能体会话与配置├── canvas #画布│ └── index.html├── completions #自动补全脚本├── credentials #认证凭证（飞书等第三方服务）├── cron #定时任务配置├── delivery-queue #消息投递队列(失败消息暂存)│ └── failed├── devices #设备配对管理│ ├── paired.json│ └── pending.json├── exec-approvals.json #执行审批记录（危险操作确认）├── extensions #扩展插件│ ├── ddingtalk│ ├── lossless-claw├── identity #设备身份认证│ ├── device-auth.json│ └── device.json├── logs #日志│ ├── config-audit.jsonl│ └── config-health.json├── media #媒体文件存储├── memory #记忆数据库（SQLite）├── openclaw.json #主配置文件（全局）├── skills #技能（全局）│ └── skill-vetter│ ├── _meta.json│ └── SKILL.md├── tasks #任务│ ├── runs.sqlite│ ├── runs.sqlite-shm│ └── runs.sqlite-wal├── update-check.json #更新检查记录├── workspace #智能体工作区│ ├── AGENTS.md│ ├── BOOTSTRAP.md│ ├── HEARTBEAT.md│ ├── IDENTITY.md│ ├── memory│ │ └── 2026-03-27.md│ ├── skills│ │ ├── find-skills│ │ │ └── SKILL.md│ │ └── weather│ │ ├── _meta.json│ │ └── SKILL.md│ ├── SOUL.md│ ├── TOOLS.md│ └── USER.md⁘ 1.2 Multi Agent
如果配置了多个Agent，对应配置如下所示：
├── agents│ ├── main #主agent│ │ ├── agent│ │ │ └── models.json│ │ └── sessions│ │ ├── 99b450b5-0c4d-4897-b28e-09f30d7293be.jsonl│ │ └── sessions.json│ ├── publisher #publisher│ │ ├── agent│ │ │ └── models.json│ │ └── sessions│ │ ├── d93f8859-0642-4889-a1ee-6ea0d4e1bb9a.jsonl.reset.2026-03-31T11-06-16.716Z│ │ └── sessions.json│ └── stocker #stocker│ └── sessions│ └── sessions.json├── canvas│ └── index.html├── completions│ ├── openclaw.bash│ ├── openclaw.fish│ ├── openclaw.ps1│ └── openclaw.zsh├── credentials #不同的agent认证凭证│ ├── feishu-main-allowFrom.json│ ├── feishu-pairing.json│ ├── feishu-publisher-allowFrom.json│ └── feishu-stocker-allowFrom.json├── cron│ └── jobs.json├── delivery-queue│ └── failed├── devices│ ├── paired.json│ └── pending.json├── exec-approvals.json├── extensions│ ├── ddingtalk│ ├── lossless-claw├── flows│ ├── registry.sqlite│ ├── registry.sqlite-shm│ └── registry.sqlite-wal├── identity│ ├── device-auth.json│ └── device.json├── logs│ ├── config-audit.jsonl│ └── config-health.json├── media├── memory│ ├── main.sqlite│ ├── publisher.sqlite│ └── stocker.sqlite├── openclaw.json├── skills│ └── skill-vetter│ ├── _meta.json│ └── SKILL.md├── tasks│ ├── runs.sqlite│ ├── runs.sqlite-shm│ └── runs.sqlite-wal├── update-check.json├── workspace #主agent的workspace│ ├── AGENTS.md│ ├── BOOTSTRAP.md│ ├── HEARTBEAT.md│ ├── IDENTITY.md│ ├── memory│ │ └── 2026-03-27.md│ ├── skills│ │ ├── find-skills│ │ │ └── SKILL.md│ │ └── weather│ │ ├── _meta.json│ │ └── SKILL.md│ ├── SOUL.md│ ├── TOOLS.md│ └── USER.md├── workspace-publisher #publisher的workspace│ ├── AGENTS.md│ ├── HEARTBEAT-IMPLEMENTATION.md│ ├── HEARTBEAT.md│ ├── IDENTITY.md│ ├── memory #长期记忆，每日的记忆文件│ │ ├── 2026-03-26.md│ │ ├── 2026-03-27.md│ │ ├── 2026-03-28.md│ │ ├── 2026-03-30.md│ │ ├── 2026-04-01.md│ │ ├── 2026-04-02.md│ │ ├── 2026-04-03.md│ │ ├── 2026-04-05.md│ │ ├── 2026-04-06.md│ │ └── heartbeat│ │ ├── config.json│ │ ├── heartbeat.log│ │ └── last-check.txt│ ├── MEMORY.md #长期记忆，关键信息│ ├── scripts│ │ ├── heartbeat-check.sh│ ├── skills #workspace生效的skills│ │ ├── agent-browser│ │ │ ├── CONTRIBUTING.md│ │ │ ├── _meta.json│ │ │ └── SKILL.md│ ├── SOUL.md│ ├── TOOLS.md│ └── USER.md└── workspace-stocker ├── AGENTS.md ├── BOOTSTRAP.md ├── HEARTBEAT.md ├── IDENTITY.md ├── SOUL.md ├── TOOLS.md └── USER.md2 关键文件和目录介绍
⁘ 2.1 openclaw.json文件
openclaw.json文件位于~/.openclaw/目录下，为全局配置文件，文件内容包括如下几个部分：
models: 配置的 AI 模型 agents: Agent 列表和默认设置，多agent配置不同路由。 channels: 聊天渠道配置（Telegram、微信，飞书，QQbot等） gateway: 网关端口、认证、Tailscale 等 tools: 工具配置 plugins: 已安装的插件
⁘ 2.2 workspace
创建multi-agent的时候建议选择单独的workspace(具体参考前文[[OpenClaw多Agent部署]])，用于区分不同的agent。
⁘ 2.3 Agents
包括main，publisher，stocker等3个agent，每个agent的目录下包含sessions的短期记忆文件。
⁘ 2.4 logs
网关日志，用于存储Gateway运行日志。
⁘ 2.5 cron
定时任务，用于存放定时配置和执行历史。
⁘ 2.6 devices
存储配对的设备信息（手机、平板，camera等）。
⁘ 2.7 memory
向量索引（SQLite）文件目录。
3 文件备份
⁘ 3.1 更改配置前备份
更改配置前先备份~/.openclaw/openclaw.json文件到其它目录，比如使用如下命令进行备份：
cp ~/.openclaw/openclaw.json /home/ubuntu/openclaw.json.bak
⁘ 3.2 版本升级前备份
版本升级前建议将~/.openclaw/进行整体备份，使用如下命令备份：
cp -r ~/.openclaw /home/ubuntu/openclawbackup/
设备迁移也可以使用该命令进行整体迁移，也可以先使用zip命令打包后直接加压即可。
⁘ 3.3 定时备份
定时备份只需要备份workspace下的markdown文件即可，如果多个agent需要分别备份。 我们也可以使用如下脚本进行一次性备份所有markdown文件。
BACKUP_DIR="/home/ubuntu/openclawbackup-$(date +%Y%m%d)"mkdir -p "$BACKUP_DIR"find /root/.openclaw -type f -name "*.md" -execcp --parents {} "$BACKUP_DIR" \;echo"已备份到: $BACKUP_DIR"后记：
通过对openclaw的安装目录详细了解，在后续的安装，备份，故障排查过程中能够快速找到对应的文件。