Part 2: 技术架构

Agent 工作区

Agent Workspace

每个 Agent 在文件系统中有一个独立的工作区目录，所有配置、记忆、技能都以纯文本文件的形式存在。

目录结构

workspace/
├── AGENTS.md           # Agent 定义（身份、行为规则）
├── SOUL.md             # 灵魂/人格指令（不可变内核）
├── USER.md             # 用户信息与偏好
├── MEMORY.md           # 长期记忆存储
├── HEARTBEAT.md        # 心跳配置（定时任务）
├── memory/              # 日志目录
│   └── YYYY-MM-DD.md    # 每日 append-only 日志
├── skills/              # 本地技能目录
└── sessions.json       # 会话存储

核心文件说明

文件	用途	加载时机
AGENTS.md	Agent 的身份定义、行为边界、回复风格。相当于 system prompt 的文件化版本	每次 Session 启动时
SOUL.md	不可变的人格内核。定义 Agent「是谁」，不应被后续对话修改	每次 Session 启动时
USER.md	关于用户的结构化信息：称呼、偏好、关系	Main session 启动时
MEMORY.md	长期记忆，Agent 在对话中主动写入的持久化事实和决策	仅 main session
HEARTBEAT.md	定义定时任务和主动行为（如每30分钟检查一次任务状态）	Gateway 启动时
memory/	Daily Logs 目录，按日期自动创建，append-only	读取今日+昨日日志
skills/	工作区级技能，优先级最高（高于全局和内置技能）	Session 启动时扫描
sessions.json	会话元数据存储，记录各 session 的状态和历史	按需读取

核心建议 所有配置文件都是纯 Markdown 或 JSON。你可以直接用文本编辑器修改它们，不需要任何专用工具。这是 OpenClaw 哲学的体现：一切皆文本。