📦 Mnemo Cortex

配置 Mnemo Cortex ——本地优先持久记忆——让 agent 跨会话保存、召回、搜索。

何时使用

• agent 需要重启后仍保留的记忆（决策、修复、已排除方案）
• 同一机器上多 agent 需共享或互查记忆
• 用户希望本地运行、零持续费用
• 用户已有 Mnemo Cortex 运行，只需接入

何时不用

• 仅需会话内上下文（模型上下文窗口足够）
• 用户已使用托管记忆服务（Mem0、supermemory），不想本地跑服务
• 仅需向量嵌入——Mnemo 的价值是 FTS5+嵌入+brain 文件组合；纯嵌入工作流用 Mem0/supermemory 更轻

工作流

• 询问用户 Mnemo Cortex 是否已运行；不确定就执行

curl http://localhost:50001/health

• 询问 agent 所在宿主（Claude Code、Claude Desktop、OpenClaw、LM Studio、AnythingLLM、Agent Zero、Ollama Desktop），不同宿主集成方式不同。
• 选对应路径，完成“保存+召回”验证。
• （推荐）用 mnemo-plan 模板建立 brain repo，让 agent 会话启动即可读取项目状态。
• 告知用户阅读 THE-LANE-PROTOCOL.md——六步会话仪式，把 Mnemo 从“有”变“用”。

路径 1：尚未启动服务器 git clone https://github.com/GuyMannDude/mnemo-cortex.git cd mnemo-cortex python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -e . mnemo-cortex init # 交互向导选模型提供商 mnemo-cortex start # 监听 http://localhost:50001 mnemo-cortex health # 验证 然后转路径 2。

路径 2：服务器已运行，接入 agent 按宿主选集成指南：

• Claude Code → integrations/claude-code/
• Claude Desktop → integrations/claude-desktop/
• OpenClaw → integrations/openclaw-mcp/
• LM Studio → integrations/lmstudio/
• AnythingLLM → integrations/anythingllm/
• Agent Zero → integrations/agent-zero/
• Ollama Desktop → integrations/ollama-desktop/

各集成注册相同 MCP 工具：mnemo_save、mnemo_recall、mnemo_search、mnemo_share，外加 5 个 Developer’s Passport 工具。

验证 新会话中：

• mnemo_save 记录“今天测试安装”。
• 另开会话 mnemo_recall 查找该记录。

若能召回，链路通；若模型只口述无工具调用，换支持工具的模型（Qwen3 任意尺寸、GPT-4/4o、Claude 3.5+、Mistral 7B v0.3）。

常见故障

• “Mnemo Cortex unreachable”——服务器未启或 MNEMO_URL 错，用 curl 检查。
• 模型虚构 save ID 未调用工具——模型不支持工具，换模型。
• 保存后无法召回——MNEMO_AGENT_ID 不一致；跨 agent 搜索需开启 mnemo_share。

完成后 阅读 THE-LANE-PROTOCOL.md（约 5 分钟）。安装简单，协议才是长期收益所在。

参考 项目：https://github.com/GuyMannDude/mnemo-cortex Brain 模板：https://github.com/GuyMannDude/mnemo-plan 实践协议：THE-LANE-PROTOCOL.md 会话指南：SESSION-GUIDE.md 监控：MONITORING.md