Setup / Config / Scripts

Setup（必须执行一次）

自动发现 ~/.openclaw/workspace* 下所有工作区，逐个注入 BOOTSTRAP.md。

Storage / Config

• - 依赖：node
• 默认存储：~/.openclaw/workspace/memory/
• 单 agent：直接使用本地 workspace 记忆
• 共享 workspace / 多 agent：多个 agent 可共享同一记忆目录
• 多 workspace 场景：setup 会自动扫描并注入

Session Init / Finish

Common Scripts

安装技能后运行一次：
bash
node ~/.openclaw/skills/smart-agent-memory/scripts/memory-cli.js setup

自动发现 ~/.openclaw/workspace* 下所有工作区，逐个注入 BOOTSTRAP.md 记忆启动指令。
幂等，新增工作区后再跑一次即可。

Agent 行为规范

🔄 记忆召回（已自动）

所有 agent 通过 memory_search（OpenClaw 内置 mandatory recall）自动搜索 memory/*.md。
双层存储确保每次写入都同步生成 Markdown，所以 memory_search / qmd 天然能搜到所有结构化数据。
无需额外操作，无需 workspace 配置，跨 agent 通用。

需要深入某方向时，用 CLI 钻取：
bash
node $CLI context --tag # 按标签
node $CLI context --skill # 按 Skill 经验
node $CLI context --days 7 # 按时间

📝 记忆写入（有内容就写）

bash
node $CLI remember 关键信息 --tags tag1,tag2 # 事实
node $CLI learn --action ... --context ... --outcome positive --insight ... # 教训
node $CLI session-end 本次讨论了XX，决定了YY # 会话摘要

⚠️ 不要攒到最后！ 有内容就写，中途断了也不丢。
每晚 cron 兜底检查，确保不遗漏。

✅ MUST DO

• - 每次需要历史信息时：先 index，看概览，再决定加载哪部分
• 工具调用踩坑后：remember 经验 --skill 沉淀经验
• 调用不熟悉的工具前：skill-mem 检查有没有历史经验
• 记录新信息时：打好 tags，方便后续按需检索
• 搜索记忆时：search 命令优先走 qmd（语义搜索），qmd 不可用时自动降级为内置 TF 搜索

❌ NEVER DO

• - 不要一次性 facts --limit 999 全量加载
• 不要在每轮对话都加载全部记忆
• 不要忽略 index 直接 recall（除非你确切知道要搜什么）
• 不要把记忆操作全堆到对话结束时

🔗 多 Agent 调度经验记忆

关键经验已沉淀：

• - runtime=subagent 模式禁止带 streamTo 参数（会直接报错）
• runtime=acp 模式可带 streamTo=parent（仅限 openclaw.json 中配置了 runtime.type: acp 的 agent）
• 子 agent 结果通过 auto-announce 自动推送，不需要轮询

Storage Layout

~/.openclaw/workspace/memory/
├── YYYY-MM-DD.md ← 每日日志
├── skills/ ← ★ Skill 经验记忆（新增）
│ ├── api-tool.md
│ └── deploy.md
├── lessons/ ← 教训 Markdown
├── decisions/ ← 决策 Markdown
├── people/ ← 人物档案
├── reflections/ ← 反思记录
├── .data/ ← JSON 结构化数据
├── .archive/ ← 归档冷数据
└── .index.json ← 温度索引 + 统计

Recommended Cron Jobs

安装后建议通过 OpenClaw cron 工具添加以下定时任务：

每晚反思（推荐）

json
{
name: memory-reflect,
schedule: { kind: cron, expr: 45 23 *, tz: Asia/Shanghai },
payload: {
kind: agentTurn,
message: 运行记忆反思：node ~/.openclaw/skills/smart-agent-memory/scripts/memory-cli.js reflect，然后总结今天的记忆变化。
},
sessionTarget: isolated,
delivery: { mode: none }
}

每周日 GC 归档（推荐）

json
{
name: memory-gc,
schedule: { kind: cron, expr: 0 2 0, tz: Asia/Shanghai },
payload: {
kind: agentTurn,
message: 运行记忆GC：node ~/.openclaw/skills/smart-agent-memory/scripts/m