跳转至

活动记忆故障排除

调试

如果活动内存没有出现在预期位置：

  1. 确认插件已在 plugins.entries.active-memory.enabled 下启用。
  2. 对于“跨对话记忆”，确认智能体的有效 memory.search.rememberAcrossConversations 设置为启用，运行 openclaw doctor 验证当前内存提供程序支持受保护的成绩单回忆，并在显式配置时确认 config.toolsAllow 包含 memory_search。对于高级活动内存，确认代理 ID 已列在 config.agents 中。
  3. 确认你正在通过符合条件的交互式持久会话进行测试。
  4. 记住，群组和频道从不使用跨对话成绩单回忆。
  5. 打开 config.logging: true 并查看网关日志。
  6. 使用 openclaw status --deep 验证内存搜索本身是否正常。

如果内存命中噪声较大，请收紧 maxSummaryChars。如果活动内存太慢，请降低 queryMode、降低 timeoutMs，或减少最近轮次计数和每轮字符上限。

常见问题

高级活动内存依赖于所配置内存插件的回忆管道，因此大多数回忆异常是嵌入提供程序的问题，而不是活动内存的缺陷。默认的 memory-core 路径使用 memory_search 和 memory_get；memory-lancedb 槽位使用 memory_recall。如果你使用其他内存插件，请确认 config.toolsAllow 中列出了该插件实际注册的工具。跨对话记忆的范围更窄：当前内存提供程序必须支持 OpenClaw 受保护的同智能体/私有会话回忆路径。

已注册的回忆工具返回 status=policy-disabled

此状态表示在父智能体的已授权工具面中，已配置的回忆工具均已不在其中。活动内存会跳过阻塞子智能体，主回复会继续，但不包含回忆上下文。

  • 检查所选智能体的配置文件以及显式的 tools.alsoAllow 授权。在受限配置文件下，仅在 config.toolsAllow 中列出插件工具并不能授权它们。请使用作用域内的 无损 Claw 示例。
  • 检查显式拒绝以及提供程序、智能体和沙箱工具策略。alsoAllow 扩展配置文件，但不会覆盖这些限制。提供程序特定的配置文件有自己的 alsoAllow 配置。
  • 确认 config.toolsAllow 包含预期的具体回忆名称。活动内存只能使用此列表与父智能体有效工具的交集。使用跨对话记忆时请保留 memory_search。
  • 使用 openclaw plugins inspect lossless-claw --runtime --json 检查注册情况。列出的工具表示已注册，但该输出并不证明父智能体或活动内存有权调用它。
嵌入提供程序已切换或停止工作

如果 memory.search.provider 未设置，OpenClaw 将使用 OpenAI 嵌入。请为 Bedrock、DeepInfra、Gemini、GitHub Copilot、LM Studio、本地、Mistral、Ollama、Voyage 或 OpenAI 兼容嵌入显式设置 memory.search.provider。如果配置的提供程序无法运行，memory_search 可能会降级为仅词法检索；在已选定提供程序后发生的运行时故障不会自动回退。

仅当你希望有明确的单一回退时，才设置可选的 memory.search.fallback。请参阅 内存搜索 获取完整的提供程序列表和示例。

回忆感觉缓慢、为空或不一致
  • 打开 /trace on 以在会话中显示插件拥有的活动内存调试摘要。
  • 打开 /verbose on 以在每次回复后同时看到 🧩 Active Memory: ... 状态行。
  • 查看网关日志中的 active-memory: ... start|done、memory sync failed (search-bootstrap) 或提供程序嵌入错误。
  • 运行 openclaw status --deep 检查内存搜索后端和索引健康状况。
  • 如果你使用 ollama，请确认嵌入模型已安装（ollama list）。
网关重启后的首次回忆返回 status=timeout

在 v2026.5.2 及更高版本中，如果冷启动设置（模型预热 + 嵌入索引加载）在首次回忆触发前尚未完成，运行可能会消耗配置的 timeoutMs 预算并返回 status=timeout，输出为空。网关日志会在重启后的首次符合条件的回复附近显示 active-memory timeout after Nms。

有关推荐的 setupGraceTimeoutMs 值，请参阅推荐设置下的“冷启动宽限期”。

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