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                                          │ 用户偏好
相关推荐
Databend28 分钟前
活动邀请函|AI 时代的湖仓实践,从应用场景到 Cloud Agent 上手
大数据·数据库·agent
前端双越老师30 分钟前
程序员 1v1 访谈系列第十五期:不要着急学副业
agent·ai编程·全栈
沉默王二41 分钟前
真狠啊,DeepSeek 开放全家桶 API。
人工智能·agent·deepseek
吴名氏.2 小时前
Java转AI Agent教程(第十五周)政策时效:过期政策不该被召回,也不能被删掉
java·人工智能·python·ai·ai agent
Csvn13 小时前
同一个问题问 100 遍,钱就扣 100 次?精确缓存让它只扣一次(C02)
人工智能·aigc·agent
岁月宁静14 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
小七-七牛开发者16 小时前
周 1 上线 | DSH 喜提原神进场动画,Anthropic 启动 IPO 路演;黄仁勋辞任;微软全球大宕机超 24 小时
ai·大模型·agent·token·工作流·claudecode·ai coding
泯泷16 小时前
Multica 真正打动我的,不是更多 Agent,而是一种新的团队协作方式
人工智能·llm·agent
阿里云大数据AI技术16 小时前
云栖实录|倍思科技 × 阿里云:让VOC洞察从“生成报告”走向“业务可用”
人工智能·elasticsearch·agent