首次 Agent 运行时的引导仪式,准备工作区和身份文件。

引导内容

首次运行时,OpenClaw 引导工作区(默认 ~/.openclaw/workspace):

  1. 生成 AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md
  2. 运行简短问答仪式(每次一个问题)
  3. 将身份和偏好写入 IDENTITY.md、USER.md、SOUL.md
  4. 完成后删除 BOOTSTRAP.md(确保只运行一次)

跳过引导

openclaw onboard --skip-bootstrap

适用于已预置工作区文件的场景。

运行位置

引导始终在 Gateway 主机上运行。若 macOS App 连接远程 Gateway,工作区和引导文件在远程机器上。

注意事项

  • 嵌入式/本地模型运行时,BOOTSTRAP.md 不进入特权系统上下文
  • 首次交互运行时,文件内容通过用户提示传递(确保不可靠调用 read 工具的模型也能完成仪式)
  • 若当前运行无法安全访问工作区,Agent 收到有限引导说明而非通用问候

相关

  • agent-workspace — 工作区文件布局
  • concepts/start-wizard — CLI 引导参考