引导

引导是首次运行仪式，用于初始化新的智能体工作区，并引导智能体选择身份。它只运行一次，在入门之后、智能体的第一个真实回合中运行。

发生了什么¶

首次针对全新工作区（默认 ~/.openclaw/workspace）运行时，OpenClaw 会：

• 初始化 AGENTS.md、SOUL.md、IDENTITY.md、USER.md 和 BOOTSTRAP.md。环境特定的工具说明应放在 AGENTS.md 的 ## Tools 部分。
• 让智能体遵循一个简短的出生流程：它会询问你想如何称呼它，分享一句简短的灵魂/气质描述，在 image_generate 可用时生成四个头像选项，并询问你想要最小推荐插件集还是最大便利。
• 将约定好的身份持久化两次：写入 IDENTITY.md 和 SOUL.md（智能体读取的关于自身的信息），并通过 openclaw agents set-identity（频道和 UI 显示的内容）。
• 展示四个生成的头像，放在带编号的 2×2 选择表中，供你选择或跳过，使用已配置的图片生成模型或可用的提供商（例如 OpenAI）。选中的肖像会从选择表中裁剪出来，保存在工作区的 avatars/ 目录下，并同步到身份中。身份文件在此选择之后保存，因此异步生成不会过早结束孵化。如果生成不可用或失败，孵化将使用表情符号继续。
• 读取在入门期间已存储的应用推荐，而不重新扫描。官方插件使用 openclaw plugins install <id>；第三方 ClawHub 技能仍为显式选择加入。处理完选择后，智能体会确认已存储的推荐，因此不会再询问。
• 一旦工作区看起来已配置，就删除 BOOTSTRAP.md，因此该仪式只运行一次。

当 SOUL.md、IDENTITY.md 或 USER.md 与其初始模板发生偏离，或存在 memory/ 文件夹时，工作区即被视为已配置。

嵌入式和本地模型运行¶

对于嵌入式或本地模型运行，OpenClaw 会将 BOOTSTRAP.md 排除在特权系统上下文之外。在主要交互式首次运行时，它仍会通过用户提示传递文件内容，因此不能可靠调用 read 工具的模型也能完成该仪式。如果当前运行无法安全访问工作区，智能体会收到一条简短的受限引导提示，而不是通用问候。

跳过引导¶

要在已预置的工作区上跳过此步骤，请运行：

openclaw onboard --skip-bootstrap

运行位置¶

引导始终在 Gateway 主机上运行。如果 macOS 应用连接到远程 Gateway，则工作区及其引导文件位于该远程机器上，而不是 Mac 上。

相关文档¶

• macOS 应用入门：入门
• 工作区布局：智能体工作区
• 模板内容：BOOTSTRAP.md 模板