SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体Agent-Memory-OS

Agent-Memory-OS

Agent-Memory-OS 是一个面向 AI 智能体团队的本地优先记忆引擎，提供私有、团队、项目三级访问控制，联想回忆、联邦同步与撤销机制，并内置 MCP 服务器和 Web 控制台。核心存储为单个 SQLite 文件，无需 LLM，零依赖，采用 Apache-2.0 许可。

访问官网

工具介绍

Agent-Memory-OS 是一个本地优先的 AI 智能体团队记忆系统，目标不只是给单个智能体提供记忆，而是为多智能体协同工作构建共享记忆网络：在严格的 ACL（访问控制列表）下管理私有、团队和项目级记忆，支持联想回忆，并通过联邦同步让多个节点（及其组织结构）保持一致。整个系统基于单个 SQLite 文件，核心零依赖，采用 Apache-2.0 许可。

一、用途与定位 真实的智能体工作往往以团队形式进行——一个项目可能混合使用 Claude Code、Codex、OpenClaw 以及多个 Hermes 配置，跨多个团队和项目，分布在一台或多台机器上。这些智能体需要与正确的队友共享正确的知识，同时保证该私密的保持私密。Agent-Memory-OS 提供：

  • 每智能体记忆：持久化事实、偏好、流程和跨会话存活的教训。
  • 团队与项目记忆：团队看到 team:<id> 记忆，项目（团队的子集）看到 project:<id> 记忆，边界之间不会泄漏。成员关系是一等公民，可管理，并驱动 ACL。
  • 联邦同步：记忆和组织结构（团队/项目/成员关系）在节点间收敛，使 project:<id> 在所有节点含义一致。
  • 本地优先：避免云记忆平台的延迟、成本和隐私权衡——记忆存放在本地 SQLite 文件，每次提示只接收相关且经过预算的切片。

二、主要能力

  • 本地优先，零依赖核心：单个 SQLite 文件（FTS5），无需服务器，pip 安装即可使用。
  • 团队与项目一等公民：团队是节点成员的集合，项目成员是其团队的子集。team:<id> 记忆到达整个团队，project:<id> 记忆仅限该项目，这是硬 ACL，可通过控制台/CLI/API 管理。移除成员会立即重新限定回忆范围；删除作用域会撤销其记忆。
  • 联邦同步与信任模型：可移植捆绑包加对等同步，通过最后写入者胜出加墓碑机制，使记忆、链接、配置和组织结构收敛。每个对等策略（shared/full/team:/project:）是强制授权范围：对等方只能在其自身范围内断言成员关系，只能缩小记忆可见性，绝不能扩大——捆绑包无法跨范围提权。
  • 可传播的撤销：独立的 ACL 时钟将事后共享/撤销沿网格传播，已同步该记忆的对等方会实际收回访问权，且不干扰衰减时钟。
  • 请求者感知 ACL：每个智能体拥有私有、智能体、团队、项目和全局记忆；可见性是硬性门禁，在排名前强制执行，绝非软评分。候选索引只返回 ID；内容通过门禁重新读取。
  • 动态上下文包：每个提示进行令牌预算、可审计的记忆选择（context_pack_report() 解释每个包含/排除决定）。
  • 真值仲裁：重复抑制、矛盾检测（CONFLICT 标记）以及为核心记忆保留预算。
  • 联想回忆（共振）：权威的 memory_links 图让相关记忆即使没有共同查询词也能浮现；遍历是 ACL 安全的（不可见节点不可穿越）。
  • 赫布强化：一起被回忆的记忆会增强链接（record_recall，或上下文包上的 auto_reinforce=True）；无用的回忆削弱链接和置信度（helpful=False）。
  • 每智能体回忆配置：不同智能体角色对记忆类型有不同权重（工程师侧重 procedure，伴侣侧重 preference）；配置持久化在数据库中，仅重新加权排名，绝不绕过 ACL。
  • 记忆生命周期：指数/线性衰减、固定、硬过期，以及写入侧 consolidate() 过程，合并重复项并将强共现簇合成为概念记忆。
  • 可选侧车：语义向量候选（turbovec）、MCP 服务器和 FastAPI Web UI，都作为 extras 提供；每个候选都重新汇入 SQLite 并通过硬门禁后方可使用。

三、使用方式 安装：pip install agent-memory-os（核心零依赖），可选 extras 如 [api]（Web UI）、[mcp]（MCP 服务器）、[semantic]（turbovec 向量回忆）。 Docker：预构建多架构镜像包含完整的 AgentMemoryOS（Web 控制台 + MCP 服务器 + CLI）；第一个参数选择模式。docker compose up -d 后控制台在 http://localhost:8000，记忆持久化在卷中。 要求：Python 3.11+，SQLite FTS5（标准 CPython 构建中已包含）。 安装后运行两条命令即可启动；令牌存储在 <home>/web_token（权限 600），agent-memory-web 自动读取，控制台首次使用时提示输入。后续可用 agent-memory token show|rotate|disable 管理。存在两个更窄的层级：--readonly（仅 GET）和 --sync（仅联邦路由，可交给对等方而非管理员令牌）。 可运行脚本示例：examples/team_memory.py 展示三个智能体在硬 ACL 下共享一个存储，约 40 行，运行 python examples/team_memory.py。 智能体集成：Hermes Agent 有原生记忆提供者插件（pip install agent-memory-os && agent-memory hermes install），在 hermes 记忆设置中选择 agent-memory-os，每轮注入回忆，amos_* 工具携带团队/项目 ACL，无需 API 密钥或 LLM。任何支持 MCP 的智能体可运行 python -m agent_memory_os.mcp_server 作为 stdio MCP 服务器指向共享的 AGENT_MEMORY_HOME。Claude Code 一行接入（设置智能体身份以正确归属记忆）。 工具（12 个）：memory_add（带 share 参数用于团队/项目/全局）、memory_search、memory_context_pack、memory_orchestrate_context、memory_link、memory_update、memory_share、memory_recall_feedback、memory_consolidate、memory_offload_context、memory_reload_context、memory_snapshot_diff。设置 AGENT_MEMORY_AGENT_ID 使每个智能体以自身身份行动，两个指向同一 home 的智能体立即共享 team:/project: 记忆。 Web 控制台：支持英语、繁體中文、简体中文、日本語、한국어（从浏览器自动检测，可在页眉切换）。提供统计仪表盘、搜索与最近浏览、交互式关联图视图、上下文包预览及每个记忆的决定，以及添加/链接/合并工具，全部由全局“acting as”身份驱动。

四、适用场景

  • 多智能体协作项目：一个项目混合 Claude Code、Codex、OpenClaw、多个 Hermes 配置，共享记忆同时保持边界。
  • 多团队、多项目企业环境：需要严格的团队/项目记忆隔离与可管理的成员关系。
  • 离线或隐私敏感场景：本地优先，记忆存放在本地 SQLite，可离线工作并按自己的条件同步。
  • 多主机联邦：通过可移植捆绑包或对等同步在节点间收敛记忆和组织结构。

五、限制与已知约束

  • 性能经过验证：10k 记忆下添加 0.17 ms，搜索 <1 ms，上下文包 7.8 ms。
  • 数据库必须放在本地磁盘；网络文件系统（NFS/SMB）可能导致 SQLite FTS5 模式创建失败并报 database is locked。
  • 无请求者的请求以不受限管理员视图运行——仅绑定 localhost，或通过 --token <secret>（或 AGENT_MEMORY_WEB_TOKEN）要求每个 API 路由使用 bearer 令牌。
  • 同步作用域令牌仍通过 Authorization 头发送，非本地对等方建议使用 https://（证书验证）以保护令牌。
  • 语义向量后端（turbovec）为可选，未安装时静默降级为词汇 + 共振回忆。
  • 1.x 稳定版，300+ 测试覆盖 3 操作系统 CI 矩阵，数据库向前自迁移。
  • 官方未在资料中提供收费、价格信息，暂未提供。

同类工具

查看分类