Mnemo Cortex

这个 Agent 能做什么，适合哪些场景？

Mnemo Cortex 是一个自托管的“认知协处理器”，为 AI 代理提供持久、本地、跨代理的记忆。它从外部监听代理的会话文件（如 OpenClaw / Claude Code 的 JSONL），将每条消息写入本地 SQLite 数据库，并用本地 Ollama 模型（默认 qwen2.5:32b-instruct）做滚动压缩，生成约 80% 的 token 节省。系统以 API 服务器（默认 http://localhost:50001）形式运行，通过 MCP 桥接供 Claude Desktop、LM Studio、AnythingLLM、OpenClaw、Agent Zero、Hermes 等客户端使用；ChatGPT 则通过一个加固的两路由 REST 网关接入，而非 MCP。核心组件包括：智能分层的智能笔记/会话日志记忆、带置信度阶梯与权威分级的结构化事实库、夜间跨代理“做梦”合成、全工作区文档索引 The Librarian（SQLite FTS5）、USB 快递同步 Cortex Stick、代理间消息总线 Disco-Bus，以及防篡改的 Memory Ledger。作者称其自 2026 年 3 月起作为五代理车队的生产记忆运行，累计约 1 万条记忆与约 7 千条已验证事实，84 个已发布版本。

运行 mnemo-cortex start 后，API 服务器监听 50001 端口；mnemo-cortex watch --backfill 启动会话文件监听器，每 2 秒读取代理的 JSONL 会话文件并自动摄取消息（无需钩子或修改代理）。保存时按两层分类：Tier 1 智能笔记由推理模型归入八个类别（topology、current_state、doctrine、incident、identity、relationship、decision 等），Tier 2 存放原始会话日志，默认召回只返回 Tier 1。召回同时运行语义向量搜索与 BM25 关键词搜索（SQLite FTS5），v4.22 起还支持按辅音骨架键匹配拼写错误的专有名词。结构化事实以 (entity, attribute, value) 三元组存储，经 verified→high_probability→false 置信度阶梯自动升降级，并提供 mnemo_fact_save / mnemo_fact_get / mnemo_fact_query / mnemo_fact_demote 四个 MCP 工具。夜间做梦流程对每个代理的近期记忆做 map-reduce 主题压缩，再跨代理合并为共享简报。mnemo-cortex health 验证服务器、数据库、压缩模型与各代理召回；mnemo-cortex stick sync 通过可选 AES-256 加密的 U 盘在两台机器间同步增量。

1. 同时使用多个 AI 代理（如 Claude Code、Claude Desktop、Codex CLI、Hermes）的个人开发者，希望代理 A 能查到代理 B 学到的内容
2. 在两台机器间切换工作的用户，希望用 Cortex Stick 通过加密 U 盘同步代理记忆，不依赖云或 VPN
3. 使用 LM Studio、Open WebUI、Ollama、AnythingLLM 等本地 LLM 的用户，想给模型加上持久语义记忆且零 API 费用
4. 拥有 ChatGPT Plus 的用户想给 Custom GPT 一个自己掌控的记忆，通过两路由网关而非暴露公网服务器
5. 需要代理记住精确事实（姓名、配置、标识符）而非模糊语义的用户，可使用结构化事实库与 BM25 精确匹配
6. 运行多代理工作流的团队，希望夜间做梦自动产生跨代理共享简报，并经 Lane Protocol 流程激活记忆

如何安装或部署这个 Agent？

前置要求：Python 3.11+、可选的 Ollama（推荐，本地推理与嵌入）、MCP 桥接集成时需要 Node.js 18+。从源码安装：

bash

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（别名 mnemo）两个 CLI 命令。非交互式安装（供 LLM 代理或 CI 使用）：

bash

./robot-install.sh

该脚本在 stdout 输出一个 JSON 对象（ok、steps 等），进度写入 stderr；可用 MNEMO_INSTALL_DRY_RUN=1 等环境变量做沙盒演练。macOS 有专门的安装指南（docs/install-macos.md），Windows 自 v4.4.1 起原生支持。

如何使用这个 Agent？

五步流程：

bash
mnemo-cortex init # 交互式向导：选择推理/嵌入模型、绑定地址与端口，写入 ~/.agentb/agentb.yaml
mnemo-cortex start # 后台启动服务器，默认监听 http://localhost:50001
mnemo-cortex health # 14 项健康检查；也可用 mnemo-cortex doctor 做深度诊断

启动自动捕获：

bash

mnemo-cortex watch --backfill

或在 shell 配置中 export MNEMO_AUTO_CAPTURE=true 使其随服务器自启。然后按平台接入：Claude Code 使用 integrations/claude-code/；Claude Desktop 用一键 .mcpb 包；LM Studio / AnythingLLM / OpenClaw / Agent Zero 等通过一行 MCP 配置；ChatGPT 通过 Custom GPT Actions 调用两路由网关（需 Plus 或更高级别）。直接 API 调用示例：

bash

curl -s -X POST http://localhost:50001/context \
-H "Content-Type: application/" \
-d '{"prompt": "what happened today", "agent_id": "YOUR-AGENT-ID", "max_results": 5}'

推荐搭配 mnemo-plan 脑仓（fork 模板仓库并把 BRAIN_DIR 指向它）与 THE-LANE-PROTOCOL.md 会话操作规程。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题