跳转至

配置参考

配置

所有主动记忆配置均位于 plugins.entries.active-memory 之下。

键 类型 含义
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[] 具体的深度召回工具名称。显式配置优先于提供方声明和内置默认值。通配符、group:* 和核心代理工具将被忽略。参见 Memory tools。
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 ms,默认 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 ms;默认 15000)
config.circuitBreakerMaxTimeouts number 同一代理/模型连续超时达到该次数后跳过召回。在成功召回或冷却期结束后重置(范围 1-20;默认 3)。
config.circuitBreakerCooldownMs number 熔断器触发后跳过召回的时长,单位为 ms(范围 5000-600000;默认 60000)。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw