第 32 章 — 实现 Memory 与 Skills 加载

// 从 .openclaw/ 目录读取 bootstrap files
const soulPath = path.join(config.workspaceDir, '.openclaw', 'SOUL.md');
const soulContent = tryReadFile(soulPath);
if (soulContent) {
  sections.push('## Identity & Personality', '', soulContent.trim(), '');
}

你是一个专注于 TypeScript 开发的编程助手。
 
## 偏好
- 使用 ESM 模块，不用 CommonJS
- 优先使用标准库，减少外部依赖
- 变量和函数名用英文，注释用中文
 
## 限制
- 不要修改 node_modules 目录
- 不要在没有确认的情况下删除文件

// src/memory/manager.ts
 
export class MemoryManager {
  private memoryDir: string;
  private workspaceDir: string;
 
  constructor(memoryDir: string, workspaceDir: string) {
    this.memoryDir = memoryDir;
    this.workspaceDir = workspaceDir;
    fs.mkdirSync(memoryDir, { recursive: true });
    fs.mkdirSync(path.join(memoryDir, 'daily-logs'), { recursive: true });
  }
  // ...
}

readRootMemory(): string | null {
  // 优先读取工作目录下的 MEMORY.md
  const workspacePath = path.join(this.workspaceDir, 'MEMORY.md');
  const memoryPath = path.join(this.memoryDir, 'MEMORY.md');
 
  for (const p of [workspacePath, memoryPath]) {
    try {
      return fs.readFileSync(p, 'utf-8').trim();
    } catch {
      continue;
    }
  }
  return null;
}

appendDailyLog(entry: string): void {
  const dateStr = this.todayDateString();
  const logPath = this.dailyLogPath(dateStr);
  const timestamp = new Date().toISOString().slice(11, 19); // HH:MM:SS
  const line = `- [${timestamp}] ${entry}\n`;
  fs.appendFileSync(logPath, line, 'utf-8');
}

getContextForPrompt(): string | null {
  const parts: string[] = [];
 
  const rootMemory = this.readRootMemory();
  if (rootMemory) {
    parts.push('### Long-term Memory (MEMORY.md)', '', rootMemory);
  }
 
  const todayLog = this.readDailyLog(this.todayDateString());
  if (todayLog) {
    parts.push("### Today's Log", '', todayLog);
  }
 
  return parts.length > 0 ? parts.join('\n') : null;
}

.openclaw/skills/
├── git-workflow/
│   └── SKILL.md
├── code-review/
│   └── SKILL.md
└── testing/
    └── SKILL.md

---
name: git-workflow
description: Git 工作流操作指南，包括分支管理、commit 规范、PR 流程
---
 
# Git 工作流
 
## 分支命名
- feature/xxx: 新功能
- fix/xxx: 修复
- refactor/xxx: 重构
 
## Commit 规范
使用 conventional commits 格式...

function parseFrontmatter(content: string): Record<string, string> {
  const result: Record<string, string> = {};
 
  if (!content.startsWith('---')) return result;
 
  const endIndex = content.indexOf('---', 3);
  if (endIndex === -1) return result;
 
  const frontmatterText = content.slice(3, endIndex).trim();
  for (const line of frontmatterText.split('\n')) {
    const colonIndex = line.indexOf(':');
    if (colonIndex === -1) continue;
    const key = line.slice(0, colonIndex).trim();
    const value = line.slice(colonIndex + 1).trim();
    if (key && value) result[key] = value;
  }
 
  return result;
}

getSkillsIndexForPrompt(): string | null {
  if (this.skills.length === 0) return null;
 
  const lines = [
    'The following skills provide specialized instructions for specific tasks.',
    'Use the read_file tool to load a skill\'s file when the task matches its description.',
    '',
    '<available_skills>',
  ];
 
  for (const skill of this.skills) {
    lines.push('  <skill>');
    lines.push(`    <name>${escapeXml(skill.name)}</name>`);
    lines.push(`    <description>${escapeXml(skill.description)}</description>`);
    lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);
    lines.push('  </skill>');
  }
 
  lines.push('</available_skills>');
  return lines.join('\n');
}

[身份声明]
You are an AI assistant powered by Mini OpenClaw.

[SOUL.md - 如果存在]
## Identity & Personality
（用户自定义的 Agent 人设）

[TOOLS.md - 如果存在]
## Tool Usage Guidelines
（工具使用偏好和限制）

[Memory]
## Memory
### Long-term Memory (MEMORY.md)
（长期记忆内容）
### Today's Log
（今日工作日志）

[Skills 索引]
<available_skills>
  <skill>
    <name>git-workflow</name>
    <description>Git 工作流操作指南</description>
    <location>/path/to/SKILL.md</location>
  </skill>
  ...
</available_skills>

[运行时信息]
## Runtime Information
- Current time: 2026-04-29T14:30:00.000Z
- Working directory: /home/ubuntu/projects
- Platform: linux

[可用工具]
## Available Tools
- bash: Execute a bash command
- read_file: Read file contents
- write_file: Write content to a file