Agent 运行时

概述

OpenClaw 运行单一嵌入式 Agent 运行时——每个 Gateway 进程对应一个 Agent，拥有独立的工作区、引导文件和会话存储。这是 OpenClaw 的核心执行单元。

工作区路径由 agents.defaults.workspace 配置，默认 ~/.openclaw/workspace
每次新会话的第一轮，OpenClaw 将工作区引导文件注入系统提示的 Project Context
引导文件（均在工作区内，用户可编辑）：
- AGENTS.md — 操作指令与记忆
- SOUL.md — 人格、边界、语气
- TOOLS.md — 工具使用约定（不控制工具可用性）
- IDENTITY.md — Agent 名称/风格/emoji
- USER.md — 用户画像
- BOOTSTRAP.md — 首次运行仪式（完成后删除）
大文件会被截断注入，空文件跳过，缺失文件注入占位标记
Skill 加载优先级（从高到低）：工作区 skills → 项目 skills → 个人 skills → 托管 skills → 内置 skills → extraDirs
会话记录存储于 ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

最小配置：

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace"
    }
  }
}

禁用引导文件创建（预置工作区时）：

{ agents: { defaults: { skipBootstrap: true } } }

模型引用格式：provider/model（如 anthropic/claude-opus-4-6）