引导
智能体启动引导
Bootstrapping 是准备智能体工作区并收集身份详情的首次运行流程。它发生在新手引导之后,也就是智能体第一次启动时。
Bootstrapping 会做什么
在首次运行智能体时,OpenClaw 会 bootstrap 工作区(默认
~/.openclaw/workspace):
- 生成
AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md。 - 运行一段简短的问答流程(一次一个问题)。
- 将身份 + 偏好写入
IDENTITY.md、USER.md、SOUL.md。 - 完成后移除
BOOTSTRAP.md,因此它只会运行一次。
对于嵌入式/本地模型运行,OpenClaw 会将 BOOTSTRAP.md 排除在
特权系统上下文之外。在主要的交互式首次运行中,它仍会在用户提示中传入
文件内容,以便那些不能可靠调用 read 工具的模型也能完成该流程。如果当前运行无法安全访问
工作区,智能体会收到一条受限的 bootstrap 说明,而不是通用问候语。
跳过 bootstrapping
要为预先填充好的工作区跳过此步骤,请运行 openclaw onboard --skip-bootstrap。
运行位置
Bootstrapping 始终在 Gateway 网关主机上运行。如果 macOS 应用连接到 远程 Gateway 网关,工作区和 bootstrapping 文件就位于那台远程 机器上。