Openclaw本地存储文件架构说明
OpenClaw 本地存储架构
~/.openclaw/ ├── openclaw.json # 核心配置文件 ├── openclaw.json.bak* # 自动备份 ├── .env # 环境变量 │ ├── agents/ # Agent 配置目录 │ ├── main/ # 默认 agent │ │ ├── agent/ │ │ │ ├── models.json # 模型配置 │ │ │ └── auth-profiles.json # 认证信息 │ │ └── sessions/ │ ├── will/ # 自定义 agent │ │ ├── agent/ │ │ │ ├── models.json │ │ │ └── auth-profiles.json │ │ └── sessions/ │ └── ollama_test/ # 测试 agent │ ├── workspace/ # 主工作空间 (Git 仓库) │ ├── .git/ # 版本控制 │ ├── AGENTS.md # Agent 行为指南 │ ├── BOOTSTRAP.md # 首次运行配置 │ ├── SOUL.md # Agent 人格定义 │ ├── USER.md # 用户信息 │ ├── TOOLS.md # 工具说明 │ ├── HEARTBEAT.md # 心跳/状态 │ └── memory/ # 记忆存储 │ └── YYYY-MM-DD.md # 每日记忆 │ ├── workspace-will/ # Will agent 工作空间 ├── workspace-ollama_test/ # Ollama 测试工作空间 │ ├── subagents/ # 子 agent 配置 ├── memory/ # 全局记忆 ├── identity/ # 身份认证 ├── credentials/ # 加密凭据存储 ├── completions/ # 补全历史 ├── canvas/ # Canvas 数据 ├── cron/ # 定时任务 │ └── jobs.json ├── devices/ # 设备信息 ├── extensions/ # 扩展插件 ├── logs/ # 日志文件 │ ├── gateway.log │ ├── gateway.err.log │ └── commands.log └── update-check.json # 更新检查核心组件说明
目录/文件 │ 用途 │ 关键文件 ─────────────────────────────────────────────────────────────┼────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────── openclaw.json │ 全局配置 │ 模型、网关、插件、渠道配置 agents/ │ 多 agent 支持 │ 每个 agent 独立的模型和认证 workspace/ │ 工作空间 │ Git 管理的记忆和配置 credentials/ │ 安全存储 │ 加密后的 API keys memory/ │ 持久记忆 │ 跨会话的记忆保持 logs/ │ 运行日志 │ 排查问题用我的多 Agent 架构示例
┌─────────────────────────────────────┐ │ OpenClaw Gateway │ │ (端口 18789) │ └─────────────┬───────────────────────┘ │ ┌─────────┼─────────┐ ▼ ▼ ▼ ┌───────┐ ┌───────┐ ┌───────────┐ │ main │ │ will │ │ollama_test│ │agent │ │agent │ │ agent │ └───┬───┘ └───┬───┘ └─────┬─────┘ │ │ │ ▼ ▼ ▼ ┌───────┐ ┌───────┐ ┌───────────┐ │workspace│ │workspace-will│ │workspace-ollama│ └───────┘ └───────┘ └───────────┘每个 agent 有独立的：
- 模型配置 (models.json)
- 认证信息 (auth-profiles.json)
- 工作空间 (workspace-{name}/)
- 会话历史 (sessions/)
记忆系统
类型 │ 位置 │ 用途 ─────────────────────────────────────────────────────────────┼────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────── 每日记忆 │ workspace/memory/YYYY-MM-DD.md │ 原始对话记录 长期记忆 │ workspace/MEMORY.md │ 提炼的重要信息 Agent 指南 │ workspace/AGENTS.md │ 行为准则 用户画像 │ workspace/USER.md │ 用户偏好