跳转至

引导

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

发生了什么

在针对全新工作区(默认 ~/.openclaw/workspace)的首次运行时,OpenClaw 会:

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

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

Note

BOOTSTRAP.md 涵盖完整的身份对话。其内容见 BOOTSTRAP.md 模板。

嵌入式和本地模型运行

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

跳过引导

要在预置工作区中跳过此步骤,请运行:

openclaw onboard --skip-bootstrap

运行位置

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

Note

当 Gateway 运行在另一台机器上时,请在 Gateway 主机上编辑工作区文件(例如,user@gateway-host:~/.openclaw/workspace)。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw