Skip to main content
引导是首次运行时的仪式，用于为新的 agent 工作区播种，并 引导 agent 选择一个身份。它只会运行一次，就在 onboarding 之后、agent 的第一次正式回合时执行。

​
会发生什么

在首次针对一个全新的工作区（默认 ~/.openclaw/workspace）运行时， OpenClaw 会：
  • 种下 AGENTS.md、SOUL.md、IDENTITY.md、USER.md 和 BOOTSTRAP.md。环境特定的工具说明应放在 AGENTS.md 的 ## Tools 部分。
  • 让代理遵循一个受限的三拍出生序列：它会询问你希望如何称呼它，分享一句简短的灵魂/氛围语句，并询问你想要最小推荐插件集还是最大便利性。
  • 将协商好的身份持久化两次：写入 IDENTITY.md 和 SOUL.md（代理读取自身信息的地方），以及通过 openclaw agents set-identity（渠道和 UI 的显示内容）。
  • 读取在 onboarding 期间已存储的应用推荐，而不重新扫描。官方插件使用 openclaw plugins install <id>；第三方 ClawHub 技能仍然保持为明确的可选加入。处理完选择后，代理会确认已存储的提议，因此以后再也不会询问。
  • 一旦工作区看起来已配置完成，就删除 BOOTSTRAP.md，这样该仪式只会运行一次。
当 SOUL.md、IDENTITY.md 或 USER.md 中有任意一个 与其初始模板发生偏离，或者存在 memory/ 文件夹时，工作区就算作已配置完成。
BOOTSTRAP.md 涵盖了完整的身份对话。请参阅 BOOTSTRAP.md 模板 中的内容。

​
嵌入式和本地模型运行

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

​
跳过引导

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

​
运行位置

引导始终在 gateway 主机上运行。如果 macOS 应用连接到远程 Gateway，则工作区及其引导文件位于那台远程机器上，而不是在 Mac 上。
当 Gateway 运行在另一台机器上时，请在 gateway 主机上编辑工作区文件（例如，user@gateway-host:~/.openclaw/workspace）。

​
相关文档