OMEGA Memory

OMEGA

AI Agent 的跨模型记忆。本地优先。适用于 Claude、GPT、Gemini、Cursor、Claw Code 以及任何 MCP 客户端。 Agent 的大脑不应存放在别人的服务上，也不应被锁定到某个提供商。

问题

AI 编码 Agent 没有状态。每个新会话都从零开始。这些“解决方案”要么让你被锁定到某个模型提供商，要么把代码库上下文发送到他们的云端。

• 上下文丢失。 Agent 会忘记会话之间的每个决定、偏好和架构选择。开发者每次会话都要花 10-30 分钟重新解释已经确立的上下文。
• 重复犯错。 如果不从过去的会话中学习，Agent 就会一遍又一遍地犯同样的错误。它们不记得哪些方法有效、哪些失败，或为什么选择某种特定方法。
• 云端记忆 = 别人的数据库。 Mem0 之类的服务需要 API 密钥，并会将你的数据发送到他们的服务器。当他们更改定价、被收购或服务中断时，Agent 积累的智能就会消失。
• 供应商锁定。 Anthropic 的 Memory Tool 只能与 Claude 配合使用。OpenAI 的记忆只能与 GPT 配合使用。更换模型，记忆就会丢失。

OMEGA 可以解决这些问题。记忆、协作和学习完全在你的机器上运行。适用于所有主流 LLM 和编码 Agent。无需云端。无需 API 密钥。没有供应商锁定。

快速安装

OMEGA 需要 Python 3.11 或更高版本。运行 python3 --version 检查：macOS 自带 Python 3.9，版本太旧。如果 pip 返回 No matching distribution found for omega-memory，原因就在这里；请先安装较新版本的 Python（例如 brew install [email protected]，或从 python.org 获取）。

请将 OMEGA 安装到独立环境中。Homebrew 的 Python 不允许直接运行 pip install（PEP 668），隔离安装也能让 OMEGA 的依赖与项目分开。任选一种：

# pipx
pipx install "omega-memory[server]"

# or uv
uv tool install "omega-memory[server]"

# or a virtual environment
python3.12 -m venv ~/.venvs/omega     # any Python 3.11 or newer
~/.venvs/omega/bin/pip install "omega-memory[server]"
export PATH="$HOME/.venvs/omega/bin:$PATH"

请保留 "omega-memory[server]" 两侧的引号：zsh（macOS 的默认 shell）会将不带引号的方括号视为模式并报错。[server] 扩展会安装 MCP 服务，该服务也会运行钩子守护进程；如果没有它，Claude Code 将无法获取 OMEGA 工具和钩子。

然后：

omega setup     # downloads the embedding model, registers the MCP server, installs hooks
omega doctor    # checks every step, and names the fix for anything that failed

omega setup --dry-run 会显示设置将进行哪些更改，但不会写入或下载任何内容。

Claude Desktop

omega setup --client claude-desktop

这会在 Claude Desktop 的配置中将 OMEGA 注册为 MCP 服务。重启 Claude Desktop 即可启用。

Cursor、Windsurf、Cline、Codex、Antigravity

omega setup --client cursor      # or: windsurf, cline, codex, antigravity

Codex 和 Antigravity 会写入各自的配置文件；对于其他客户端，设置程序会输出可供粘贴的 JSON 配置块。对于其他任何 MCP 客户端，运行 omega setup --client venv 会输出要使用的命令和参数。钩子（自动捕获和呈现）仅适用于 Claude Code。

pip install omega-memory    # Core only, no MCP server

from omega import store, query, remember

store("Always use TypeScript strict mode", "user_preference")
results = query("TypeScript preferences")

从源代码安装

git clone https://github.com/omega-memory/omega-memory.git
cd omega-memory
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[server,dev]"
omega setup

omega setup 将会：

1. 创建 ~/.omega/（如果设置了 $OMEGA_HOME，则创建该目录）
2. 将 ONNX 嵌入模型 bge-small-en-v1.5（约 130 MB）和重排器（约 90 MB）下载到 ~/.cache/omega/models/
3. 将 omega-memory 注册为 MCP 服务（自动检测 Claude Code，或指定 --client）
4. 将会话钩子安装到 ~/.claude/settings.json
5. 在 ~/.claude/CLAUDE.md 中添加 OMEGA 区块

如果某个步骤失败，摘要会以 [FAIL] 标记并说明原因，设置程序也会以错误状态退出。

60 秒快速入门

OMEGA 通过自然语言运行——无需 API 调用或配置，只需与 Claude 对话。

1. 告诉 Claude 记住一件事：

“记住，身份验证系统使用 JWT 令牌，而不是会话 Cookie”

Claude 会将其存储为永久记忆，并生成语义嵌入。

2. 结束会话，然后开启新会话。

3. 询问相关内容：

“我对身份验证做了什么决定？”

OMEGA 会自动呈现相关记忆：

Found 1 relevant memory:
  [decision] "The auth system uses JWT tokens, not session cookies"
  Stored 2 days ago | accessed 3 times

就是这么简单。记忆会跨会话持久保存、不断积累，并在相关时自动呈现——即使你没有明确询问。

主要功能

• 记忆与学习 — 通过语义搜索存储决策、经验教训、错误模式和偏好。Claude 无需你在每次会话中重新解释一切，就能回忆重要内容。工具涵盖压缩、整合、时间线、图遍历以及检查点／恢复。

• 多 Agent 协作 (omega-pro) — 文件和分支锁定、会话管理、带依赖关系的任务队列、意图广播，以及 Agent 间消息传递，避免 Agent 覆盖彼此的工作。

• 智能大模型路由 (omega-pro) — 对任务分类并将其路由到最佳模型。编码 → Claude Sonnet。快速编辑 → Llama 8b，成本仅为 1/60。100 万令牌上下文 → Gemini Flash。5 个提供商、4 种优先模式，意图分类耗时不到 2 毫秒。

• 知识库 (omega-pro) — 将 PDF、Markdown、网页和文本文件导入可搜索的知识库，并进行语义分块。

• 实体注册表 (omega-pro) — 多实体企业记忆，支持关系、层级结构，以及按实体划分的记忆／资料／文档。

• 安全资料 (omega-pro) — AES-256 加密的个人数据存储，并集成 macOS Keychain。

OMEGA 的对比优势

Anthropic Memory Tool 在客户端存储数据，但所有记忆操作都需要调用 Claude API。OMEGA 完全在设备上运行，包括嵌入生成（ONNX）。

Anthropic Memory 服务于 Anthropic。OMEGA 服务于所有人。

架构

     Claude Code  ·  Cursor  ·  Claw Code  ·  Any MCP Client
               │         │         │              │
               └─────────┴─────┬───┴──────────────┘
                               │ stdio/MCP
               ┌───────────────▼─────────────┐
               │   OMEGA MCP Server   │
               │   core memory tools  │
               └──┬──────────────────┘
                  │
         ┌────────▼──────────────┐
         │ Core Memory Engine    │
         │ (semantic search,     │
         │  embeddings, graphs)  │
         └─────┬─────────────────┘
               │
               ▼
         ┌──────────────────────────────────────┐
         │         omega.db (SQLite)             │
         │  memories | edges | embeddings        │
         └──────────────────────────────────────┘

单一数据库、模块化处理器。可选模块（协作、路由、实体、知识、资料）可通过 OMEGA Pro 使用，并注册到同一服务器进程中。无需独立守护进程，也无需微服务。

MCP 工具参考

OMEGA 作为 MCP 服务运行在 Claude Code 中。默认情况下，它向客户端展示五个工具（omega_store、omega_welcome、omega_protocol、omega_tools、omega_call）以节省上下文：omega_tools 会列出所有可用工具，omega_call 则可运行其中任意工具。在服务的环境中设置 OMEGA_CONDENSED=0，即可直接显示所有工具。

核心工具

OMEGA Pro 增加了协调、路由、实体、知识库和个人资料工具。

命令行

免费版和 Pro 版

核心功能免费且开源。在免费版中，存储达到 2,000 条记忆后，搜索会从语义搜索切换为纯文本匹配；达到 5,000 条后则停止存储新记忆。运行 omega status 可查看当前状态。OMEGA Pro 不受这两项限制。

故障排除

omega doctor 在导入检查中显示 FAIL：

• 确保在仓库根目录运行 pip install -e ".[server]"
• 检查 python3 -c "import omega" 是否可运行

MCP 服务无法启动：

• 在与 OMEGA 相同的环境中安装服务扩展：pip install "omega-memory[server]"（或 pipx install --force "omega-memory[server]"）

MCP 服务未注册：

• 再次运行 omega setup，或运行 omega doctor 打印的 claude mcp add -s user omega-memory -- ... 命令：该命令会指定 OMEGA 自身环境中的 Python

Hooks 未触发：

• 运行 omega hooks doctor；omega hooks setup 可修复缺失或过时的条目
• 检查 ~/.omega/hooks.log 中的错误

开发

pip install -e ".[server,dev]"
pytest tests/                # Test suite
ruff check src/              # Lint

卸载

claude mcp remove -s user omega-memory
omega serve uninstall        # only if you installed the HTTP daemon
rm -rf ~/.omega ~/.cache/omega
pipx uninstall omega-memory  # or: uv tool uninstall omega-memory, or delete the venv

手动从 ~/.claude/settings.json 中移除 OMEGA 条目，并从 ~/.claude/CLAUDE.md 中移除 `` 块。

贡献

• 贡献指南
• 安全政策
• 更新日志
• 报告 Bug

许可证

Apache-2.0。参见 LICENSE。