配置参考
配置¶
所有活动记忆配置均位于 plugins.entries.active-memory 下。
| Key | Type | Meaning |
|---|---|---|
enabled |
boolean |
启用插件本身 |
config.mode |
"escalate" \| "always" \| "off" |
控制阻塞式深度召回子代理何时运行；默认值为 "escalate" |
config.agents |
string[] |
可以使用活动记忆的代理 ID |
config.model |
string |
可选的阻塞式子代理模型引用；未设置时，继承当前会话模型 |
config.allowedChatTypes |
("direct" \| "group" \| "channel" \| "explicit")[] |
允许运行活动记忆的会话类型；默认为 ["direct"] |
config.allowedChatIds |
string[] |
可选的按会话白名单，在 allowedChatTypes 之后应用；非空列表实行默认拒绝策略 |
config.deniedChatIds |
string[] |
可选的按会话黑名单，覆盖允许的会话类型和允许的 ID |
config.queryMode |
"message" \| "recent" \| "full" |
控制阻塞式子代理可以看到多少会话内容 |
config.promptStyle |
"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only" |
控制阻塞式子代理在决定是否返回记忆时的积极程度或严格程度 |
config.toolsAllow |
string[] |
阻塞式子代理可以调用的具体记忆工具名称；默认为 ["memory_search", "memory_get"]；当 plugins.slots.memory 为 memory-lancedb 时，默认为 ["memory_recall"]；通配符、group:* 条目以及核心代理工具会被忽略 |
config.thinking |
"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive" \| "max" |
阻塞式子代理的高级思考覆盖设置；为了速度默认值为 off |
config.fastMode |
boolean \| "auto" |
阻塞式子代理的可选快速模式覆盖；未设置时继承常规代理、会话和模型的默认值 |
config.promptOverride |
string |
高级完整提示词替换；不建议在常规使用中启用 |
config.promptAppend |
string |
追加到默认或被覆盖提示词之后的高级额外指令 |
config.timeoutMs |
number |
阻塞性子代理的硬超时时间（范围 250-120000 毫秒；默认 15000） |
config.setupGraceTimeoutMs |
number |
在召回超时到期前的额外高级设置预算；范围 0-30000 毫秒，默认 0。有关 v2026.4.x 升级指南，请参阅冷启动宽限期 |
config.maxSummaryChars |
number |
活动记忆摘要中的最大字符数（范围 40-1000；默认 220） |
config.logging |
boolean |
调优时输出活动记忆日志 |
config.persistTranscripts |
boolean |
在删除阻塞性子代理的临时 SQLite 会话行之前，将转录内容导出为 JSONL 工件 |
config.transcriptDir |
string |
插件拥有的每个代理转录目录下的相对工件目录（默认 "active-memory"） |
config.modelFallback |
string |
仅用作模型回退链中最后一步的可选模型 |
有用的调优字段：
| 键 | 类型 | 含义 |
|---|---|---|
config.recentUserTurns |
number |
当 queryMode 为 recent 时要包含的先前用户轮次（范围 0-4；默认 2） |
config.recentAssistantTurns |
number |
当 queryMode 为 recent 时要包含的先前助手轮次（范围 0-3；默认 1） |
config.recentUserChars |
number |
每个最近用户轮次的最大字符数（范围 40-1000；默认 220） |
config.recentAssistantChars |
number |
每个最近助手轮次的最大字符数（范围 40-1000；默认 180） |
config.cacheTtlMs |
number |
重复相同查询时的缓存复用（范围 1000-120000 毫秒；默认 15000） |
config.circuitBreakerMaxTimeouts |
number |
同一代理/模型连续超时达到此次数后跳过召回；在召回成功或冷却期结束后重置（范围 1-20；默认 3）。 |
config.circuitBreakerCooldownMs |
number |
熔断器触发后跳过召回的时间长度，以毫秒为单位（范围 5000-600000；默认 60000）。 |
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw