OpenClaw: memory optimizer

诊断 OpenClaw 记忆搜索配置，给出轻度、中度、深度三级参数调整建议（maxResults、minScore、MMR、时间衰减、session 同步阈值），通过命令行或直接编辑配置文件应用，并用状态与诊断命令验证效果。

nicshliu

热度 64.88

最近更新 2026-05-11 17:39:59

分类：知识依赖：读写文件 / 代码执行应用场景：工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openclaw-memory-optimizer

Metadata

name: openclaw-memory-optimizer
description: 自动优化 OpenClaw 4.2 记忆搜索参数。当用户提到记忆不准确、搜索结果太少、MMR 关闭、时间衰减未启用、session 同步阈值过高，或者要求优化 OpenClaw 记忆系统时触发。也用于定期检查和调整 memory-search 配置。

OpenClaw Memory Optimizer

优化 OpenClaw 4.2 内置记忆搜索系统的参数配置，提升记忆检索精度。

快速诊断

运行以下命令检查当前配置：

openclaw config get agents.defaults.memorySearch 2>/dev/null || echo "未设置"
cat ~/.openclaw/openclaw.json | python3 -c "import json,sys; c=json.load(sys.stdin); print(json.dumps(c.get('agents',{}).get('defaults',{}).get('memorySearch',{}), indent=2))"

核心参数（OpenClaw 当前保守默认值）

参数	默认值	问题	推荐值
`maxResults`	6	结果太少	10–15
`minScore`	0.35	过于宽松	0.25
`mmr.enabled`	false	MMR 可提升多样性	true
`mmr.lambda`	0.7	—	0.6
`temporalDecay.enabled`	false	旧记忆权重过高	true
`temporalDecay.halfLifeDays`	30	—	14
`sessionDeltaMessages`	50	同步太慢	15
`sessionDeltaBytes`	100KB	阈值过高	20KB

详见 references/defaults.md

优化流程

1. 扫描当前配置

读取 ~/.openclaw/openclaw.json，找到 agents.defaults.memorySearch 节。

2. 选择优化级别

轻度优化（保守，推荐首次使用）：

{
  "memorySearch": {
    "maxResults": 10,
    "minScore": 0.30,
    "sessionDeltaMessages": 25,
    "sessionDeltaBytes": 50000
  }
}

中度优化（平衡精度与召回）：

{
  "memorySearch": {
    "maxResults": 12,
    "minScore": 0.25,
    "mmr": { "enabled": true, "lambda": 0.65 },
    "temporalDecay": { "enabled": true, "halfLifeDays": 14 },
    "sessionDeltaMessages": 15,
    "sessionDeltaBytes": 30000
  }
}

深度优化（高精度）：

{
  "memorySearch": {
    "maxResults": 15,
    "minScore": 0.20,
    "mmr": { "enabled": true, "lambda": 0.60 },
    "temporalDecay": { "enabled": true, "halfLifeDays": 7 },
    "sessionDeltaMessages": 10,
    "sessionDeltaBytes": 20000,
    "experimental": { "sessionMemory": true }
  }
}

3. 应用配置

openclaw config set agents.defaults.memorySearch.maxResults 12
openclaw config set agents.defaults.memorySearch.mmr.enabled true
# ... 逐条设置

或直接编辑 ~/.openclaw/openclaw.json 的 agents.defaults.memorySearch 节。

4. 验证

openclaw memory status --deep
openclaw doctor --memory-search

Feature Flag 快速开关

通过环境变量快速切换（无需重启 Gateway）：

# 启用 MMR
OPENCLAW_MEMORY_MMR=true openclaw gateway restart

# 启用时间衰减
OPENCLAW_MEMORY_TEMPORAL_DECAY=true openclaw gateway restart

何时使用轻度 vs 深度

轻度：个人项目、短期任务、上下文简单
中度：多模块项目、有多位协作者
深度：大型代码库、长期维护、需要高精度记忆