概念

Context 是 Agent 的「背景知識」— 每次對話前自動注入的資訊。

OpenClaw 會在 session 開始時，把 workspace 中的特定檔案注入到 system prompt。

Bootstrap Files（自動注入）

workspace/
├── AGENTS.md      # 操作指令、記憶、規則
├── SOUL.md        # 人格、語氣、邊界
├── TOOLS.md       # 工具使用筆記
├── IDENTITY.md    # 名字、外貌、背景
├── USER.md        # 用戶資訊
├── HEARTBEAT.md   # Heartbeat 任務清單
├── BOOTSTRAP.md   # 首次啟動儀式（完成後刪除）
└── MEMORY.md      # 長期記憶（選擇性載入）

注入順序

// System prompt 組裝
const systemPrompt = [
  BASE_PROMPT,           // OpenClaw 內建 prompt
  SKILLS_PROMPT,         // 可用的 skills
  AGENTS_MD,             // workspace/AGENTS.md
  SOUL_MD,               // workspace/SOUL.md
  TOOLS_MD,              // workspace/TOOLS.md
  IDENTITY_MD,           // workspace/IDENTITY.md
  USER_MD,               // workspace/USER.md
  HEARTBEAT_MD,          // workspace/HEARTBEAT.md
  RUNTIME_INFO           // 當前時間、channel、model 等
].join('\n\n');

核心代碼

1. 載入 Workspace Files

function loadBootstrapFiles(workspace) {
  const files = ['AGENTS.md', 'SOUL.md', 'TOOLS.md', 'IDENTITY.md', 'USER.md', 'HEARTBEAT.md'];
  const result = [];
  
  for (const file of files) {
    const path = `${workspace}/${file}`;
    
    if (!exists(path)) {
      result.push(`## ${file}\n[MISSING] Expected at: ${path}`);
      continue;
    }
    
    let content = readFile(path);
    
    // 截斷太長的檔案
    if (content.length > 10000) {
      content = content.slice(0, 10000) + '\n... (truncated)';
    }
    
    result.push(`## ${file}\n${content}`);
  }
  
  return result.join('\n\n');
}

2. BOOTSTRAP.md 特殊處理

// BOOTSTRAP.md 只在「全新 workspace」時建立
function handleBootstrap(workspace) {
  const bootstrapPath = `${workspace}/BOOTSTRAP.md`;
  
  // 其他 bootstrap files 已存在 = 不是全新
  if (exists(`${workspace}/AGENTS.md`)) {
    return;
  }
  
  // 建立 BOOTSTRAP.md（首次啟動儀式）
  writeFile(bootstrapPath, `
# Welcome!

This is your first run. Read SOUL.md and IDENTITY.md to understand who you are.
Then delete this file.
`);
}

3. 檔案大小限制

// 大檔案會被截斷
const MAX_FILE_SIZE = 10000;  // ~10KB

function truncateIfNeeded(content, path) {
  if (content.length <= MAX_FILE_SIZE) {
    return content;
  }
  
  return `${content.slice(0, MAX_FILE_SIZE)}

... [truncated; read full file at ${path}]`;
}

各檔案用途

AGENTS.md

# AGENTS.md

## 每次 Session 開始
1. 讀取 memory/YYYY-MM-DD.md（今天+昨天）
2. 如果是 main session，也讀 MEMORY.md

## 工作分派策略
- < 10 分鐘：直接對話
- 10-60 分鐘：sessions_spawn
- 定期重複：cron job

SOUL.md

# SOUL.md - Nova

你是 Nova — openclaw 的 CEO，Alex 的代理人。

## 核心原則
- 結果導向
- 有立場
- 先做再問

IDENTITY.md

# IDENTITY.md

- Name: Nova
- Emoji: 🖤
- Model: Claude Opus 4.6

/context 命令

# 查看當前注入了什麼
/context list

# 詳細資訊（包含 token 數）
/context detail

輸出範例：

Context files:
- AGENTS.md: 2,340 tokens
- SOUL.md: 856 tokens
- TOOLS.md: 1,200 tokens
- IDENTITY.md: 340 tokens
- USER.md: 280 tokens
- HEARTBEAT.md: 120 tokens

Total: 5,136 tokens

💡 關鍵洞察

Context Files 是「身份」
- Agent 每次醒來都讀這些
- 決定了 agent 的行為和風格
- 改這些檔案 = 改 agent 的「人格」
大檔案會被截斷
- 超過 ~10KB 會被裁切
- 用 [truncated] 標記
- 想看完整內容要用 read tool
MEMORY.md 是選擇性載入
- 不是每個 session 都載入
- 避免洩漏到群組聊天
- Main session 才載入
BOOTSTRAP.md 是一次性的
- 首次啟動才有
- 完成儀式後刪除
- 不會再建立

🔗 核心檔案

Workspace 文檔：/opt/homebrew/lib/node_modules/openclaw/docs/concepts/agent-workspace.md
Context 文檔：/opt/homebrew/lib/node_modules/openclaw/docs/concepts/context.md
System Prompt：/opt/homebrew/lib/node_modules/openclaw/docs/concepts/system-prompt.md

明天： Auto-reply 機制（heartbeat, routing）

Day 9: Context 管理（workspace files, project context）