Auto-sync: 2026-04-23 04:02

wiki/concepts/启动序列.md

@@ -0,0 +1,79 @@
+---
+title: "启动序列（Boot Sequence）"
+type: concept
+tags: [openclaw, agentic-ai, best-practices]
+sources: [养龙虾5天血泪史]
+last_updated: 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
+
+```markdown
+# 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天血泪史]] ← 主要来源