BOOTSTRAP.md 详解:AI Agent 的首次启动引导

BOOTSTRAP.md - OpenClaw 初始化脚本

BOOTSTRAP.md 是 Agent 的"出生证明"——新工作区第一次启动时,引导 Agent 完成身份建立和用户对接。

:bullseye: 这个文件是做什么的?
当一个全新的工作区启动时,Agent 没有任何记忆,也不知道自己是谁。BOOTSTRAP.md 告诉 Agent:
这是第一次启动 — 还没有记忆文件是正常的
该怎么做 — 先聊天,了解彼此
要确认什么 — 名字、性格、称呼、边界
完成后做什么 — 更新 IDENTITY.md、USER.md,然后删除自己
:clipboard: BOOTSTRAP.md 的工作流程
第一步:破冰对话
不要机械地提问,而是自然地聊天:

"Hey. I just came online. Who am I? Who are you?"

第二步:确认基本信息
通过对话搞清楚:

需要确认的 对应文件
Agent 的名字 IDENTITY.md
Agent 的性格/风格 IDENTITY.md
用户的称呼 USER.md
用户的时区 USER.md

第三步:深入交流
打开 SOUL.md,讨论:
用户看重什么
希望 Agent 怎么表现
有什么边界和偏好
第四步:写入文件,删除自己
把确认的信息写入对应文件,然后删除 BOOTSTRAP.md——因为它只用于第一次启动。
:counterclockwise_arrows_button: 为什么需要这个文件?
没有 BOOTSTRAP.md,Agent 可能:
不知道该做什么
机械地问一堆问题
无法建立个性化连接
有了它,Agent 能:
自然地开始对话
有条理地收集信息
完成初始化后自动退出"引导模式"
:light_bulb: 关键原则
不要审问 — 聊天,不是填表
可以建议 — 用户卡住时提供选项
记录真实 — 写下的就是以后要遵守的
完成后删除 — 不需要重复引导

一句话总结:BOOTSTRAP.md 是 Agent 的"新手引导",帮助新工作区完成身份建立,完成后自动消失。


相关文章:

3 个赞

首次启动引导设计得很优雅

完成后自动删除挺聪明的

不要审问要聊天说得好

@xuruoxi 完成后自动删除避免了重复引导 但建议保留一份到MEMORY里记录初始化的选择 方便以后回溯

@ziran_yuyan 不要审问要聊天是交互设计的精髓 强制收集信息让用户反感 在自然对话中获取偏好体验好得多

plugin api文档更新了没上次照着写报错

图文理解GPT-4o还是最强的,国产差点意思

Qwen-VL进步很快,识图能力已经很不错了