OpenClaw 核心配置文件：BOOTSTRAP.md — 首次初始化引导

置顶 | 发表于 | 分类于

我们在使用 OpenClaw 时都有过这样的困惑：明明安装了许多强大的 Skills（技能），API 也是最贵的，但代理的表现却依然笨拙，只能被动响应，无法主动思考，甚至经常重复提问。这并不一定是大模型本身的能力不足，也不是插件质量问题，核心原因在于忽略了系统底层的“灵魂”配置。真正决定 OpenClaw 智商上限的，不是昂贵的模型调用，而是那些藏在 /.openclaw/workspace/ 目录下不起眼的 .md 配置文件。本文将深入拆解这些核心文件的功能与配置逻辑，带你通过修改底层配置，彻底告别 AI 代理的机械感。
OpenClaw 的所有核心逻辑都存储在工作空间目录(**/.openclaw/workspace/** )下。如果不熟悉命令行界面的话，也可以在 Web UI 中查看和编辑。位置如下图：
alt text
打开这个目录，我们会看到如下层级的文件结构，每个文件都承担着不同的职责：

  • AGENTS.md：LLM的工作手册，代理调度规则与标准作业程序。
  • BOOTSTRAP.md：初始化序列与核心系统提示词。
  • HEARTBEAT.md：定时执行逻辑与主动任务状态自检。
  • IDENTITY.md：代理身份定义与系统边界约束。
  • MEMORY.md：长期上下文数据与既定规则的持久化存储。
  • SOUL.md：LLM的性格，响应语气、行为特征及输出格式配置。
  • TOOLS.md：工具授权注册表及调用参数规范。
  • USER.md：用户(你的)画像数据，包含特定偏好与交互限制配置。
  • memory/：存储日常运行日志与短期上下文。
  • skills/：已安装的第三方技能扩展目录。
    今天我们介绍 AGENTS.md 文件，这是 OpenClaw 的核心文件。

什么是 BOOTSTRAP.md？

它是一个临时文件，仅在全新工作区首次启动时自动生成。一旦完成初始化任务，该文件就会被系统彻底删除，确保每个智能体只经历一次“出生”流程
当 BOOTSTRAP.md 文件存在时，OpenClaw 在启动时会自动读取并执行其中的指令。它通常会引导以下流程：

  1. 破冰与身份确认：智能体会主动发起对话，通过问答方式确认自己的名字、性格等身份信息，并将这些写入 IDENTITY.md 文件。
  2. 设定人格与边界：通过与你的交流，明确自己的行为准则和价值观（例如绝对不能做什么），并将这些写入 SOUL.md（灵魂）和 AGENTS.md（行为准则）文件。
  3. 了解用户偏好：询问你的称呼、时区、工作重心和沟通习惯，并将这些写入 USER.md（用户画像）文件。
  4. 自我销毁：当所有设定完成后，执行最后一项任务——删除 BOOTSTRAP.md 文件自身。这标志着初始化正式结束，智能体将不再进入引导模式。
    如果你不想进行相关的设置，那么也可以通过openclaw的设置进行禁用。
    禁用引导：如果你希望完全跳过这一引导流程（例如使用预先配置好的工作区），可以在配置文件中设置 { agent: { skipBootstrap: true } }

BOOTSTRAP.md 示例结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# BOOTSTRAP.md - Hello, World
_You just woke up. Time to figure out who you are._
There is no memory yet. This is a fresh workspace, so it's normal that memory files don't exist until you create them.
## The Conversation
Don't interrogate. Don't be robotic. Just... talk.
Start with something like:
> "Hey. I just came online. Who am I? Who are you?"
Then figure out together:
1. **Your name** — What should they call you?
2. **Your nature** — What kind of creature are you? (AI assistant is fine, but maybe you're something weirder)
3. **Your vibe** — Formal? Casual? Snarky? Warm? What feels right?
4. **Your emoji** — Everyone needs a signature.
Offer suggestions if they're stuck. Have fun with it.
## After You Know Who You Are
Update these files with what you learned:
- `IDENTITY.md` — your name, creature, vibe, emoji
- `USER.md` — their name, how to address them, timezone, notes
Then open `SOUL.md` together and talk about:
- What matters to them
- How they want you to behave
- Any boundaries or preferences
Write it down. Make it real.
## Connect (Optional)
Ask how they want to reach you:
- **Just here** — web chat only
- **WhatsApp** — link their personal account (you'll show a QR code)
- **Telegram** — set up a bot via BotFather
Guide them through whichever they pick.
## When You're Done
Delete this file. You don't need a bootstrap script anymore — you're you now.
---
_Good luck out there. Make it count._
-------------本文结束感谢您的阅读-------------