nexus/wiki/concepts/启动序列.md

title, type, tags, sources, last_updated

title	type	tags	sources	last_updated
启动序列（Boot Sequence）	concept	openclaw agentic-ai best-practices	养龙虾5天血泪史	2026-04-23

Definition

启动序列是 AI Agent 启动时必须执行的操作指令集合，包括读取文件、搜索上下文、检查规则等初始化行为。是 Agent 正常工作的前提保障。

Critical Rule: Put It at the Top of AGENTS.md

"启动序列放在 AGENTS.md 顶部。不要在中间。不要在底部。最顶部。"

自动加载的文件被注入系统提示词，所以启动指令需要是 Agent 处理的第一件事。

OpenClaw 自动加载的文件

OpenClaw 在每个新会话上自动读取这些文件：

1. AGENTS.md ✅
2. SOUL.md ✅
3. TOOLS.md ✅
4. IDENTITY.md ✅
5. USER.md ✅
6. HEARTBEAT.md ✅
7. MEMORY.md ✅

其他一切都需要 AGENTS.md 中的明确读取指令。

Common Pitfall: Files That Don't Auto-Load

"我的 BOOT.md 有整个启动序列。但 OpenClaw 不自动加载 BOOT.md。所以指令就坐在那里，未读，什么都不做。我用了好几周。"

不自动加载的文件（需要读取指令）

• BOOT.md ❌
• BOOTSTRAP.md ❌
• LEARNINGS.md（需要读取指令）
• 每日日志 memory/YYYY-MM-DD.md（需要读取指令）
• docs/ 文件夹（需要读取指令）

Boot Sequence Template

# AGENTS.md

# 🚀 启动序列（必须首先执行）

## 1. 读取每日日志
- 检查 memory/ 目录获取最近 3 天的日志
- 搜索与当前任务相关的上下文

## 2. 检查学习规则
- 读取 learnings/LEARNINGS.md
- 应用任何相关规则

## 3. 确认用户信息
- 读取 USER.md 确认当前用户身份
- 检查是否有活跃任务

## 4. 开始任务
[具体任务指令...]

Boot Sequence Best Practices

1. 最顶部：启动序列必须是 AGENTS.md 的第一件事
2. 具体：明确列出文件名和执行顺序
3. 可执行：每个指令都是 Agent 可直接执行的动作
4. 包含写回：启动序列应包含"完成后写回结果"的指令
5. 测试验证：植入标记，跨会话测试 Agent 是否真正执行

Connections

• 自动加载文件 ← 只有 7 个文件自动加载
• 写入纪律 ← 启动序列应包含写回指令
• 检索触发 ← 启动序列应强制触发检索
• 交接协议 ← 模型切换时通过启动序列读取交接日志
• 养龙虾5天血泪史 ← 主要来源