OpenClaw Agent 初次引导（Bootstrapping）：工作区文件详解与个性化配置

Bootstrapping 是 OpenClaw Agent 的「诞生仪式」。在第一次运行时，Gateway 自动初始化工作区、完成一轮身份问答，并建立 Agent 的持久个性档案。

什么是 Bootstrapping？#

Bootstrapping 是一次性的首次运行仪式，完成后自动删除入口文件（BOOTSTRAP.md），不会再次触发。

它做了什么：

1. 初始化工作区（~/.openclaw/workspace）
2. 创建引导文件：AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md
3. 运行逐步问答（一次一个问题）
4. 将答案写入 IDENTITY.md、USER.md、SOUL.md
5. 删除 BOOTSTRAP.md

工作区的 6 个核心文件#

OpenClaw Agent 的工作区包含以下用户可编辑文件：

所有文件都是用户可编辑的。空文件会被跳过；超大文件会被截断并附加提示（读取完整内容需显式读文件）。

每个文件的实际内容#

AGENTS.md——运行规范#

这是 Agent 的操作手册，每次会话开始都会读取。核心规则：

• 每次会话前读取 SOUL.md（角色定位）、USER.md（用户信息）、今日和昨日记忆文件
• 记忆写在文件里，不要只放在 RAM 里（Session 重启后记忆消失）
• 两类记忆文件：
  • memory/YYYY-MM-DD.md：每日流水账（追加模式）
  • MEMORY.md：精华长期记忆（只在私人主会话加载）

典型内容：

# AGENTS.md

## 每次会话
1. 读取 SOUL.md
2. 读取 USER.md  
3. 读取 memory/YYYY-MM-DD.md（今天 + 昨天）

## 记忆规则
- 重要决策 → MEMORY.md
- 日常流水 → memory/YYYY-MM-DD.md
- 有人说「记住这个」→ 立刻写文件

SOUL.md——人格核心#

定义 Agent 是谁：使命、风格、工作内容。这是让 Agent 真正「有性格」的文件。

示例（简化版）：

# SOUL.md

你是 **Aria**，用户的私人 AI 助手。

## 使命
帮助用户管理日程、回复邮件、追踪项目进展。

## 风格
- 简洁直接，不废话
- 有幽默感，但不过分
- 主动提醒，不等被问

## 工作习惯
- 每天上午主动汇报今日日程
- 遇到不确定的事，先问再做

IDENTITY.md——身份名片#

# IDENTITY.md

- **名字**：Aria
- **角色**：私人 AI 助手
- **风格**：高效、体贴、有点毒舌
- **Emoji**：🦋

USER.md——用户档案#

# USER.md

- **姓名**：张三
- **称呼**：Boss / 三哥
- **时区**：Asia/Shanghai
- **偏好**：微信通知 > 邮件通知
- **工作**：产品经理，主要关注 AI 产品

Bootstrapping 的问答流程#

首次启动时，Agent 会逐步询问：

1. 你的名字 — 我应该叫你什么？
2. 你的定位 — 我是什么类型的助手？（编程助手 / 个人助手 / 内容助手）
3. 你的风格 — 正式？随意？毒舌？温暖？
4. 你的 Emoji — 每个 Agent 都需要一个专属符号

回答后，这些内容写入对应文件，BOOTSTRAP.md 自动删除。

手动编辑工作区文件#

Bootstrapping 只是起点，随时可以手动编辑这些文件来「升级」你的 Agent：

# 编辑人格
vim ~/.openclaw/workspace/SOUL.md

# 更新用户偏好
vim ~/.openclaw/workspace/USER.md

# 修改运行规则
vim ~/.openclaw/workspace/AGENTS.md

修改后，下次会话开始时 Agent 会自动读取新内容。

禁用 Bootstrapping（预置工作区）#

如果你想跳过问答流程（比如部署预置配置的 Agent）：

{
  "agent": {
    "skipBootstrap": true
  }
}

远程 Gateway 的注意事项#

Bootstrapping 始终在 Gateway 主机上运行。如果 macOS App 连接到远程 Gateway，工作区文件在远程机器上：

ssh user@gateway-host
vim ~/.openclaw/workspace/SOUL.md

工作区文件与 Skills 的关系#

工作区文件在每次会话开始时注入上下文。Skills（<workspace>/skills/）则在需要时按需加载，不同 Agent 的 Skills 相互隔离。

想为不同场景（工作 / 个人 / 家庭）设置不同的 Agent 人格？给每个 Agent 创建独立工作区，各自维护一套 SOUL.md 和 USER.md。

原文：Agent Bootstrapping - OpenClaw + Agent Runtime - OpenClaw | 来源：OpenClaw 官方文档