引导
引导是首次运行仪式,用于初始化新的 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 会收到一条简短的受限引导说明,而不是通用问候。
跳过引导¶
要在预置工作区中跳过此步骤,请运行:
运行位置¶
引导始终在 Gateway 主机上运行。如果 macOS 应用连接到远程 Gateway,则工作区及其引导文件位于该远程机器上,而不是 Mac 上。
Note
当 Gateway 运行在另一台机器上时,请在 Gateway 主机上编辑工作区文件(例如,user@gateway-host:~/.openclaw/workspace)。
相关文档¶
- macOS 应用入门引导:入门引导
- 工作区布局:Agent 工作区
- 模板内容:BOOTSTRAP.md 模板
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw