本页内容
本页内容
代理工作区
Agent 引导
引导是首次运行时的仪式,用于为新的 agent 工作区播种,并引导 agent 选择一个身份。它只会运行一次,就在 onboarding 之后、agent 的第一次正式回合时执行。
会发生什么
在首次针对一个全新的工作区(默认 ~/.openclaw/workspace)运行时, OpenClaw 会:
- 种子
AGENTS.md、SOUL.md、IDENTITY.md、USER.md和BOOTSTRAP.md。特定于环境的工具说明位于AGENTS.md的## Tools部分。 - 作为代理遵循一个简短的出生顺序:它询问您想称呼它什么,共享一条简短的 soul/vibe 行,当
image_generate可用时生成四个头像选项,询问您是否想要最少的推荐插件集或最大的便利性。 - 将协商好的身份持久化两次:写入
IDENTITY.md和SOUL.md(代理读取自身信息的地方),以及通过openclaw agents set-identity(渠道和 UI 的显示内容)。 - 使用配置的图像生成模型或可用的提供程序(例如 OpenAI)在编号的 2×2 选择表中呈现四个生成的头像,供您选择或跳过。所选肖像将从工作表中裁剪出来,保存在工作区的
avatars/目录下,并同步到身份中。在此选择后保存身份文件,因此异步生成不会提前结束孵化。如果生成不可用或失败,则会继续使用表情符号进行孵化。 - 读取在 onboarding 期间已存储的应用推荐,而不重新扫描。官方插件使用
openclaw plugins install <id>;第三方 ClawHub 技能仍然保持为明确的可选加入。处理完选择后,代理会确认已存储的提议,因此以后再也不会询问。 - 一旦工作区看起来已配置完成,就删除
BOOTSTRAP.md,这样该仪式只会运行一次。
当 SOUL.md、IDENTITY.md 或 USER.md 中有任意一个与其初始模板发生偏离,或者存在 memory/ 文件夹时,工作区就算作已配置完成。
嵌入式和本地模型运行
对于嵌入式或本地模型运行,OpenClaw 会将 BOOTSTRAP.md 排除在特权系统上下文之外。在首次进行的主要交互式运行中,它仍会通过用户提示传递该文件内容,因此即使那些无法可靠调用 read 工具的模型也能完成这一流程。如果当前运行无法安全访问工作区,代理将收到一条简短的受限引导说明,而不是通用问候语。
跳过引导
要在已预置的工作区中跳过此步骤,请运行:
运行位置
引导始终在 gateway 主机上运行。如果 macOS 应用连接到远程 Gateway,则工作区及其引导文件位于那台远程机器上,而不是在 Mac 上。
相关文档
- macOS 应用程序入门:Onboarding
- Workspace layout: Agent 工作区
- Template contents: BOOTSTRAP.md 模板
本页有帮助吗?