Agent 引导初始化

引导初始化（Bootstrapping）是 Agent 首次运行时执行的准备仪式，用于搭建工作区并收集身份信息。它在 onboarding 完成之后、Agent 第一次启动时触发。

引导初始化做了什么

Agent 首次运行时，OpenClaw 会初始化工作区（默认路径 ~/.openclaw/workspace）：

• 生成 AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md 等种子文件。
• 运行一组简短的问答流程（逐题进行）。
• 将身份信息和偏好写入 IDENTITY.md、USER.md、SOUL.md。
• 完成后删除 BOOTSTRAP.md，确保引导流程只执行一次。

运行位置

引导初始化始终在 Gateway 主机上运行。如果 macOS 应用连接的是远程 Gateway，那么工作区和引导文件都位于那台远程机器上。

注意： 当 Gateway 运行在另一台机器上时，需要到 Gateway 主机上编辑工作区文件（例如 user@gateway-host:~/.openclaw/workspace）。

相关文档

• macOS 应用 onboarding 流程：Onboarding
• 工作区目录结构：Agent 工作区