Skip to main content
引导初始化是首次运行时执行的流程，用于为新的 Agent 工作区填充初始内容，并 引导智能体选择身份。它只运行一次，即新手引导完成后智能体的 第一次真实轮次。

​
会发生什么

首次针对全新工作区（默认 ~/.openclaw/workspace）运行时， OpenClaw 会：
  • 填充 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md 和 BOOTSTRAP.md。
  • 让智能体遵循最多三个步骤的诞生流程：询问你想如何 称呼它，分享一句简短的灵魂/氛围描述，并询问你希望使用 推荐的最小插件集还是获得最大便利性。
  • 将约定的身份保存两次：写入 IDENTITY.md 和 SOUL.md（智能体 读取的自身信息），并通过 openclaw agents set-identity 保存（渠道 和 UI 显示的信息）。
  • 读取新手引导期间已存储的应用推荐，而不重新扫描。 官方插件使用 openclaw plugins install <id>；第三方 ClawHub Skills 仍需明确选择加入。处理选择后，智能体会确认已存储的推荐， 因此不会再次询问。
  • 工作区看起来已配置后删除 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）。

​
相关文档