文档导航
文档/故障排查/Agent 问题

Agent 问题

修复启动上下文、召回 hooks、MCP 工具和过期 Agent 记忆。

Agent 问题通常是本地配置问题,而不是服务器记忆问题。

检查什么

检查:

运行时重要文件/设置
Claude Code~/.lore/config.json、MCP server、插件 hooks,以及残留的旧版 CLAUDE.md 导入
Codex~/.lore/config.json~/.codex/config.toml~/.codex/hooks.json、MCP server、插件启用状态
OpenClaw~/.lore/config.json~/.openclaw/openclaw.json 插件 entry,以及可选 baseUrl / apiToken 覆盖
Pi~/.lore/config.json${PI_CODING_AGENT_DIR:-~/.pi/agent}/extensions/lore 下的扩展 symlink,以及可选插件配置覆盖
Hermes~/.lore/config.json、插件 symlink,以及可选环境变量兜底
OpenCodeOpenCode 1.18.3 或更新版本、共享 ~/.lore/config.json,以及来自预发布 v1.3.15-pre.4 / lore-opencode.zip~/.config/opencode/plugins/lore-memory.js

修改这些内容后,重启运行时。Hooks 和 MCP 配置通常在进程启动时加载。

OpenCode 检查

  • 如果没有原生 Lore 工具,确认插件文件包含 @lore-managed-opencode-plugin,并确认 CLI 达到已验证的 OpenCode 1.18.3 基线。
  • 如果工具已出现,确认精确名称包含 lore_guidancelore_statuslore_move_nodelore_lore_search 这类名称说明配置的是 MCP,而不是标准原生插件。
  • 如果 Boot 缺失,但工具和 prompt Recall 正常,可能是 experimental.chat.system.transform 不可用。这是预期的 fail-open 模式:插件只警告一次,不修改用户消息,chat.message Recall 仍会继续。
  • 如果所有 Lore 调用失败,检查 ~/.lore/config.json、服务器健康、token 和网络。除了健康检查,插件 REST 请求都会标记 client_type=opencode
  • 如果 ~/.config/opencode/plugins/lore-memory.js 已有未标记文件,安装器会有意保留它。若要让 Lore 管理该路径,请自行移走旧文件后重试。
  • 如果 OpenCode 同时显示 lorelore:lore、其中一个报告 SSE 错误,或者 SaaS 面板对一次 prompt 记录了多个 client type,说明其他插件导入了 Claude Code 的 Lore 兼容数据。原生插件会在配置合并后删除重复 Lore MCP。安装器会单独阻止更早发生的 Claude Lore 生命周期 hook 导入:仅对已有且可安全解析的用户级 oh-my-openagent.json[c] 或旧版 oh-my-opencode.json[c] 设置 claude_code.plugins_override["lore@lore"] = false。该修改保留无关设置和 JSONC 注释,不会修改 Claude Code 文件;若兼容配置不安全或无法解析,安装器会警告并跳过。重新安装后重启 OpenCode。
  • 卸载 OpenCode 集成会恢复 Lore 记录的 lore@lore 原值。如果安装后你自行修改了这个值,卸载器会保留你的新值。
  • OpenCode 标准安装不得创建 MCP entry。只有原生插件无法加载时,才使用 /api/mcp?client_type=opencode 作为手动兜底。若明确需要让旧版 MCP 与原生插件并存,请在运行安装器和启动 OpenCode 时都设置 LORE_OPENCODE_ALLOW_MCP=1;使用逃生开关重新安装会恢复原兼容值。

重新安装预发布版:

*.bash
Shell
npx @loremem/cli install --lang zh --pre --channels opencode --force

其他运行时如果 MCP 可用但没有 recall,检查 hook 配置。OpenCode 则检查原生插件加载和 chat.message。如果 recall 出现但 Agent 不使用它,改善本地 guidance,并验证 Agent 会先打开召回节点再依赖内容。

设置问题检查服务器地址、设置状态、健康检查、迁移和认证问题。召回问题修复记忆缺失、结果噪声、召回缓慢和查询输出困惑。常见问题关于日常 Lore 使用决策的简短回答。记忆写作建议使用实用清单和示例写出合适的持久记忆。