实践openclaw-concepts
Configuration reference · OpenClaw — 一份把「主动记忆」拆成可调参数的配置清单,适合想给 agent 加记忆层的人对照
一份把「主动记忆」拆成可调参数的配置清单,适合想给 agent 加记忆层的人对照抄作业。
2026-09-14原文
本文为要点摘要,完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支,查看这一点的一句话解读
OpenClaw 主动记忆配置
控制插件开关、可用 agent 与会话类型
- enabled 布尔开关插件本身
- config.agents 指定可用 agent id
- allowedChatTypes 默认仅 direct
⚙️ 流程拆解
STEP 1会话触发召回
STEP 2按 mode 决定是否运行
STEP 3子代理查询记忆
STEP 4返回摘要或跳过
STEP 5超时则熔断
🔗 涉及的概念与玩家
- OpenClaw产品
- active-memory产品
- memory_search方法
- memory_get方法
- memory_recall方法
- memory-lancedb产品
- JSONL概念
- SQLite产品
- OpenClaw—包含插件→active-memory
- active-memory—默认调用→memory_search
- active-memory—默认调用→memory_get
- active-memory—可选调用→memory_recall
- active-memory—可搭配→memory-lancedb
- active-memory—导出格式→JSONL
config.mode控制阻塞式深度回忆子 agent 何时运行,取值escalate/always/off,默认escalate;含义:记忆检索默认应是按需升级的旁路,而非每轮必跑的主路径。config.queryMode决定子 agent 看到多少对话(message/recent/full),配合recentUserTurns、recentAssistantTurns等字段限制轮数与字符数;含义:喂给检索模型的上下文要显式设上限,别默认全量塞入。config.timeoutMs默认 15000ms,并有circuitBreakerMaxTimeouts(默认 3)与circuitBreakerCooldownMs(默认 60000)在连续超时后跳过回忆;含义:记忆调用必须带硬超时和熔断,否则会拖垮主循环。
🕸 顺着图谱继续读
- Memory tools · OpenClaw — Active Memory 的工具白名单怎么配,才既安全又不丢召回能力2026-09-14 · 共同涉及 OpenClaw、active-memory、memory_search
- Session search · OpenClaw — 精确检索历史会话原文,与语义记忆互补,提升Agent记忆利用效率。2026-08-17 · 共同涉及 OpenClaw、SQLite、memory_search
- Session controls · OpenClaw — 会话级开关加 verbose/trace,让隐藏的记忆注入第一次变得可观测2026-09-21 · 共同涉及 OpenClaw、active-memory
- Advanced overrides and transcripts · Ope — OpenClaw 记忆子代理的隐藏开关与转录导出,调错会拖慢回复或泄露上下文2026-09-14 · 共同涉及 OpenClaw、active-memory