青蛙小白
博客 / 2026/03

OpenClaw 笔记:Agent Bootstrapping

2026/03/01 · — 字 · 阅读约 — 分钟 ·
目录

agent 第一次真正跑起来时,到底发生了什么。

OpenClaw 把这个过程叫做 Bootstrapping。可以把它理解成一次“首次启动仪式”:系统会初始化工作区、收集身份信息、写入关键文件,最后把一个“刚装好但还没有人格和长期记忆入口”的 agent,变成一个能稳定长期协作的助手。

工作区里会出现 AGENTS.mdSOUL.mdUSER.mdIDENTITY.md 这些文件。

Bootstrapping 是什么

官方文档对它的定义很直接:

Bootstrapping is the first-run ritual that prepares an agent workspace and collects identity details.

翻成更容易理解的话,就是:在 onboarding 之后、agent 第一次启动时,OpenClaw 会先把工作区准备好,再把“这个 agent 是谁、服务谁、按什么方式工作”这些信息落到文件里。

所以它不是每次启动都执行的常规流程,而是只在第一次运行时发生的一次性初始化。

首次运行时会发生什么

第一次运行时,OpenClaw 会初始化工作区,默认路径是:

~/.openclaw/workspace

然后依次做几件事:

  • 生成 AGENTS.mdBOOTSTRAP.mdIDENTITY.mdUSER.md
  • 运行一段简短问答流程,一次问一个问题
  • 将身份信息和偏好写入 IDENTITY.mdUSER.mdSOUL.md
  • 完成后删除 BOOTSTRAP.md,确保整个流程只执行一次

从这个顺序里可以看出,Bootstrapping 干的不是“下载依赖”这种安装动作,而是在建立一套长期有效的工作区入口

也就是说,OpenClaw 不是只想让 agent 能回答问题,而是想先把它的身份、用户画像和行为风格安顿下来。

这几个文件为什么关键

OpenClaw 把 agent 的长期状态拆成了几份明确的文件。

AGENTS.md

这是工作区里的总入口之一。你可以把它理解成 agent 在当前工作区的长期说明书。

IDENTITY.md

这里承接的是 agent 的身份信息。也就是“它是谁”。

USER.md

这里承接的是用户信息和偏好。也就是“它在服务谁”。

SOUL.md

这里更像是风格和做事原则的落点。也就是“它会按什么方式长期工作”。

BOOTSTRAP.md

它比较特殊,是一次性文件。它的作用是引导首次初始化流程,而不是长期存在。

所以从设计上看,BOOTSTRAP.md 更像“脚手架”;而 AGENTS.mdIDENTITY.mdUSER.mdSOUL.md 才是流程结束后真正留下来的那部分长期状态。

这些文件真正生效的位置在 Gateway 主机上。如果是“本机 app 连接远程 gateway”,那这些工作区文件并不在本机 app 这台机器里,而是在那台 gateway 所在的机器上。

关键点:agent workspace 跟 gateway 走,不跟客户端节点走。

参考

评论