80 lines
2.5 KiB
Markdown
80 lines
2.5 KiB
Markdown
---
|
||
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天血泪史]] ← 主要来源
|