~/.openclaw — OpenClaw 的家 ~/.openclaw — OpenClaw 的家 完整目录结构 关键目录详解1️⃣ openclaw.json — 主配置文件2️⃣ workspace/ — Agent 工作区 ⭐3️⃣ agents/main/sessions/ — 会话存储 ⭐4️⃣ devices/ — 设备配对5️⃣ logs/ — 日志6️⃣ 其他目录 权限说明 目录大小估算 与安装目录的关系 常用操作查看配置查看会话备份工作区查看配对设备重置配置~/.openclaw— OpenClaw 的家这是 OpenClaw 的运行时数据目录所有配置、状态、会话、记忆都存储在这里。位置/home/ubuntu/.openclaw/ 完整目录结构~/.openclaw/ │ ├── openclaw.json # 主配置文件 ⭐ ├── openclaw.json.bak # 配置备份 ├── openclaw.json.bak.1 # 旧配置备份 ├── update-check.json # 更新检查状态 │ ├── workspace/ # Agent 工作区 (你的文件) │ ├── SOUL.md # 人格定义 │ ├── USER.md # 用户信息 │ ├── IDENTITY.md # 身份定义 │ ├── AGENTS.md # 工作区指南 │ ├── TOOLS.md # 本地工具笔记 │ ├── HEARTBEAT.md # 心跳任务 │ ├── memory/ # 每日记忆笔记 │ └── .git/ # Git 版本控制 │ ├── agents/ # Agent 运行时数据 │ └── main/ # 主 Agent (默认) │ ├── sessions/ # 会话存储 ⭐ │ │ ├── sessions.json # 会话索引 │ │ └── *.jsonl # 会话转录 (完整对话历史) │ └── agent/ # Agent 状态 │ ├── auth-profiles.json │ └── models.json │ ├── devices/ # 设备配对信息 │ ├── paired.json # 已配对设备 │ └── pending.json # 待批准设备 │ ├── logs/ # 日志文件 │ └── config-audit.jsonl # 配置审计日志 │ ├── cron/ # Cron 任务状态 │ ├── identity/ # 身份标识 │ ├── canvas/ # Canvas 画布文件 │ └── completions/ # 代码补全缓存 关键目录详解1️⃣openclaw.json— 主配置文件这是 OpenClaw 的核心配置包含{auth:{...},// 认证配置 (API Keys, OAuth)models:{...},// 模型提供商配置agents:{...},// Agent 默认设置tools:{...},// 工具配置session:{...},// 会话管理gateway:{...},// Gateway 配置 (端口、认证、Tailscale)plugins:{...}// 插件启用状态}2️⃣workspace/— Agent 工作区 ⭐这是你的文件Agent 在这里读写、记忆、工作。workspace/ ├── SOUL.md # Agent 的人格和行为规范 ├── USER.md # 你的信息 ├── IDENTITY.md # Agent 的身份 ├── AGENTS.md # 工作区使用指南 ├── TOOLS.md # 本地工具笔记 (相机、SSH 等) ├── HEARTBEAT.md # 周期性任务清单 └── memory/ └── YYYY-MM-DD.md # 每日笔记3️⃣agents/main/sessions/— 会话存储 ⭐这里存储所有对话历史。sessions/ ├── sessions.json # 会话索引 (元数据) └── dfghgsaef-....jsonl # 会话转录 (完整对话)sessions.json内容示例{agent:main:webchat:direct:openclaw-control-ui:{sessionId:1234-5678-910-1234-5678910,updatedAt:12345678910,inputTokens:15000,outputTokens:8000,totalTokens:23000,contextTokens:18000}}*.jsonl文件每行是一个 JSON 对象记录完整的对话历史 (user/assistant 消息)4️⃣devices/— 设备配对存储已配对的设备信息。paired.json内容{ushj8sk6...:{deviceId:ushj8sk6...,platform:linux,clientId:cli,role:operator,scopes:[operator.admin,operator.write,...],tokens:{...}},hd4k5oygs...:{deviceId:hd4k5oygs...,platform:Win32,clientId:openclaw-control-ui,role:operator,...}}你的设备Linux CLI— 你的 Ubuntu 终端Windows Web UI— 你的浏览器 (openclaw-control-ui)每个设备有 公钥/私钥对 OAuth Token 权限范围 (scopes)5️⃣logs/— 日志logs/ └── config-audit.jsonl # 配置审计日志记录配置变更、安全审计事件。6️⃣ 其他目录目录用途cron/定时任务状态和运行历史identity/设备身份标识canvas/Canvas 交互界面文件completions/代码补全缓存memory/(根目录)向量索引 SQLite 数据库 权限说明注意目录权限drwx------(700) — 只有所有者可读写执行drwxrwxr-x(775) — 组用户可读写敏感目录 (agents/,logs/,openclaw.json) 使用700 权限保护你的API Keys对话历史设备 Token 目录大小估算目录大小说明workspace/~50KB你的文件agents/main/sessions/~260KB会话数据 (会增长)openclaw.json*~8KB配置 备份devices/~2KB设备配对总计~320KB轻量级 与安装目录的关系┌─────────────────────────────────────────────────┐ │ /home/ubuntu/.npm-global/.../openclaw/ │ │ — 程序代码 (只读npm 管理) │ │ — dist/, extensions/, skills/, docs/ │ └─────────────────────────────────────────────────┘ │ │ 运行时读写 ▼ ┌─────────────────────────────────────────────────┐ │ /home/ubuntu/.openclaw/ │ │ — 你的数据 (可写用户管理) │ │ — openclaw.json, workspace/, agents/, ... │ └─────────────────────────────────────────────────┘简单说/home/ubuntu/.npm-global/.../openclaw/程序本身(代码)~/.openclaw/你的数据(配置、会话、记忆) 常用操作查看配置cat~/.openclaw/openclaw.json查看会话openclaw sessions--json# 或ls-la~/.openclaw/agents/main/sessions/备份工作区cd~/.openclaw/workspacegitadd.gitcommit-mBackup查看配对设备cat~/.openclaw/devices/paired.json重置配置cp~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json这就是~/.openclaw的完整说明这是你的数据家园所有个人配置、对话历史、记忆都存在这里。End你好少年未来可期~本文由作者最佳伙伴——阿程赞助推出