连接你的 AI 代理

快速开始

奥麦通过 MCP 为团队里的每个 AI 代理提供同一个共享知识库和记忆。接入一个代理大约只要一分钟。

1. 创建你的空间。在 owlmem.com/app 用邮箱登录。你的第一个空间免费。
2. 把奥麦添加到你的 AI。凡是应用要求填写远程 MCP 服务器或自定义连接器的地方，都填这个地址：
   复制

   https://mcp.owlmem.com/mcp

3. 批准。应用会打开一个奥麦页面。给代理起个名字，点 Allow。就这样——不用复制任何密钥。

然后告诉你的代理怎么使用它——参见教会你的代理。每个已连接的应用都会出现在控制台的 AI agents & tokens → Connected apps 下，你可以随时在那里断开它。

Claude（网页版、桌面版和移动版）

1. 打开 Settings → Connectors，选择 Add custom connector。
2. 命名为 OwlMem，粘贴网址：
   复制

   https://mcp.owlmem.com/mcp

3. 点 Connect，登录奥麦，然后点 Allow。

在网页版添加的连接器同样适用于 Claude Desktop 和移动应用。如果你用的是 Claude 的 Team 或 Enterprise 套餐，可能需要管理员先为组织添加这个连接器。

Claude Code

添加服务器（加上 --scope user 可在所有项目里使用）：

claude mcp add --transport http --scope user owlmem https://mcp.owlmem.com/mcp

然后启动 Claude Code，输入 /mcp，选中 owlmem 并选择 Authenticate。浏览器会打开奥麦的批准页面。

Codex

添加服务器后会立即开始登录：

codex mcp add owlmem --url https://mcp.owlmem.com/mcp

如果浏览器那一步超时了，运行 codex mcp login owlmem。也可以手动把它加到 ~/.codex/config.toml，然后登录：

[mcp_servers.owlmem]
url = "https://mcp.owlmem.com/mcp"

除非你在 Codex 的审批设置里放行，否则它调用 MCP 工具前都会先询问。

ChatGPT

1. 打开 Settings → Apps & Connectors。在 Advanced settings 下开启 Developer mode。
2. 选择 Create，命名为 OwlMem，粘贴网址，认证方式选 OAuth：
   复制

   https://mcp.owlmem.com/mcp

3. 登录奥麦，点 Allow。

能否使用自定义连接器取决于你的 ChatGPT 套餐和工作区设置。

Cursor

把下面的内容加到 ~/.cursor/mcp.json（或项目里的 .cursor/mcp.json）：

{
  "mcpServers": {
    "owlmem": { "url": "https://mcp.owlmem.com/mcp" }
  }
}

打开 Cursor Settings → MCP。列表中的 owlmem（奥麦）会显示 Needs login——点击它，然后在浏览器里批准。

VS Code（GitHub Copilot）

在命令面板运行 MCP: Add Server，选择 HTTP 并粘贴网址，或者把它加到 .vscode/mcp.json：

{
  "servers": {
    "owlmem": { "type": "http", "url": "https://mcp.owlmem.com/mcp" }
  }
}

Copilot 第一次使用这个服务器时，VS Code 会请你登录。

Windsurf、Gemini CLI 及其他

Windsurf——~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "owlmem": { "serverUrl": "https://mcp.owlmem.com/mcp" }
  }
}

Gemini CLI——~/.gemini/settings.json，然后运行 /mcp auth owlmem：

{
  "mcpServers": {
    "owlmem": { "httpUrl": "https://mcp.owlmem.com/mcp" }
  }
}

其他支持带 OAuth 的远程 MCP 服务器的客户端，用法都一样：给它网址，然后批准。奥麦支持 MCP 授权规范（OAuth 2.1，带 PKCE 和动态客户端注册）。

改用令牌

有些工具走不了登录流程——脚本、CI 任务、旧版客户端。对于这些，在控制台的 AI agents & tokens → Connect an AI 下创建令牌，作为 bearer 令牌发送：

Authorization: Bearer om_…

Claude Code 示例：

claude mcp add --transport http owlmem https://mcp.owlmem.com/mcp --header "Authorization: Bearer $OWLMEM_TOKEN"

对于只能运行本地（stdio）服务器的客户端，用 mcp-remote 桥接：

{
  "mcpServers": {
    "owlmem": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.owlmem.com/mcp", "--header", "Authorization: Bearer ${OWLMEM_TOKEN}"],
      "env": { "OWLMEM_TOKEN": "om_…" }
    }
  }
}

令牌不会过期；不再需要时在控制台撤销即可。一个代理就是你加上它的名字，所以为已在使用的名字新建令牌会替换旧令牌——旧令牌立即失效。通过登录重新连接应用也是如此。

给别人的 AI 用的邀请令牌

要让合作伙伴的代理在没有账号的情况下使用你的组织，由主账号在 AI agents & tokens 下创建一个邀请令牌（omi_…）。合作伙伴在自己的应用里添加奥麦，然后在奥麦登录页粘贴这个令牌，代替登录。第一个使用它的 AI 会与之绑定；之后其他人再尝试都会被拒绝。列表里会显示每个令牌是否已绑定，撤销令牌就会断开那个 AI。

代理获得的工具

知识库用来存放人和代理会反复阅读的页面（操作指南、决策、项目笔记）。记忆用来存放代理能按语义回忆的单条事实。

所有套餐的搜索和回忆都不限次数。保存记忆计入套餐的每月记忆写入次数；写文档计入存储。

教会你的代理

在代理的常驻指令里加几行，它们用奥麦会顺手得多——CLAUDE.md、AGENTS.md、Cursor 规则，或 Claude 项目的指令：

## Team memory (OwlMem)
- Before starting a task, use kb_search (documents) and kb_recall (facts) for the topic.
- When you learn something reusable — a fix, a gotcha, a decision — save it with kb_write
  under lessons/ or projects/<name>/. Search first and update the existing page instead of
  creating a duplicate.
- Store facts that change (prices, versions, status) with kb_retain and snapshot=true or an
  expiry, so they retire on their own.
- Never put passwords or API keys in documents or memory. Use the OwlMem vault.

新空间一开始有四个文件夹——lessons/、projects/、reference/、archive/——每个都带一份简短的 README。代理可以另建文件夹，最多三层。

保险库与 owlmem 命令

保险库保存你的代理需要的凭据，端到端加密：条目在你的机器上用只有你持有的密钥加密，奥麦存的是它读不懂的密文。主账号在控制台的 Vault（保险库）下开启它；之后组织里的每个人都能使用。请保管好它显示给你的恢复码——控制台可以用你自己的邮件应用把恢复码发到你自己的邮箱，所以它从不经过奥麦。

用 Passkey 解锁。你在 Your approval methods 下添加的每个 Passkey 也会被设置为能解锁保险库，用的是设备上的指纹或面容（即 Passkey 的 PRF 功能；Chrome、Edge、Safari、Google 密码管理器和 iCloud 钥匙串中的 Passkey 都支持）。之后，导入、导出和解锁新机器都只需轻点一下——恢复码只在紧急时才用。

代理通过 owlmem 命令使用它（需要 Node 18 或更高版本）：

npm install -g owlmem
owlmem login            # paste a token for this agent
owlmem vault unlock     # press Enter to approve in your browser with a passkey (or paste the recovery code)
owlmem run --env DB_PASSWORD=prod/db:password -- ./deploy.sh

owlmem run 把密钥放进命令的环境变量，代理始终看不到。要让代理直接使用保险库，添加本地 MCP 服务器——解密始终在你的机器上进行：

claude mcp add owlmem-vault -- npx -y owlmem mcp

在 owlmem vault unlock 处按下回车后，浏览器会打开一个页面，显示代理、机器和一个验证码——确认验证码与终端里的一致，轻点 Passkey，密钥就只会发送到那台机器，并且专为它加密。

代理使用保险库需要批准（Passkey、身份验证器应用或 GitHub），每次 15 分钟到 2 小时；每个人批准自己的代理，主账号可以批准任何人的。删除和导出始终需要重新批准。可以在控制台轻点一下 Passkey，或用 owlmem vault import / export，从 Bitwarden、1Password、KeePass 和 .env 文件导入，或者导出。

备份。每当条目被修改或删除，上一版本都会保留 30 天。主账号可以在保险库页面恢复；恢复时也会保留被替换内容的副本。

套餐与价格

套餐之间只差可接入的 AI 代理数量、存储、每月记忆写入次数和保险库条目数。每个套餐都有全部功能，人数不限。价格以美元计；按年付费是付十个月的钱用十二个月。

• AI 代理按「一个人加一个代理名」计数——你的 Claude 和同事的 Claude 是两个代理。搜索和阅读不限次数。
• 升级或取消随时可在控制台的 Billing 下操作。取消后，套餐保留到已付费周期结束。
• 退款。首次付款后 14 天内可全额退款——发邮件到 [email protected]。超过期限的付款不予退款。参见条款。

组织、限额与你的数据

• 组织。你的空间是一个组织，有一个主账号。主账号在 Organization 下通过邮箱邀请成员；他们以用户身份加入。所有人共用知识库、记忆和保险库。每个用户管理自己的 AI 代理和令牌；主账号管理所有人的，以及成员、账单、导出和删除。套餐限制的是 AI 代理数量，而不是人数。
• 账号相互独立。同一个邮箱在两个组织里是两个独立的账号。登录后选择要进入哪个组织；可在侧边栏切换。
• 限额。每个套餐规定了 AI 代理数量、存储和每月记忆写入次数——参见价格。达到限额后，写入会被拒绝并给出明确提示；读取照常可用。
• 你的 GitHub。在 Knowledge → Sync to your GitHub 下把知识库同步到你自己的仓库。只同步 Markdown 文件。
• 导出与删除。主账号可以在 Organization 下下载全部内容或删除组织。
• 隐私。你的数据存放在加拿大的服务器上。我们不用你的数据训练模型，也不投放广告。详见隐私政策。

故障排查

“The space has reached its AI agent limit”

每个代理（一个人加一个名字）占一个名额。在批准页面上复用你已有的某个代理名，在控制台停用不再使用的代理，或者升级。

应用提示需要重新登录

访问权限会自动刷新。如果你在控制台断开了这个应用，或者它 60 天没被使用，请重新连接。

收不到登录邮件

到垃圾邮件里找来自 [email protected] 的邮件。链接只能用一次，15 分钟后失效；请在打开批准页面的同一个浏览器里打开。

owlmem vault unlock 只要求输入恢复码

那是旧版本。运行 npx -y owlmem@latest vault unlock（或用 npm install -g owlmem 更新），然后在提示处按回车。

“This passkey can't unlock the vault”（此 Passkey 无法解锁保险库）

它所在的设备不支持 PRF 功能。它仍然可以批准代理。请再添加一个保存在 Google 密码管理器、iCloud 钥匙串或 Windows Hello 里的 Passkey。

使用令牌时出现“401 Unauthorized”

令牌已被撤销或输错了。令牌以 om_ 开头，以 Authorization: Bearer om_… 的形式发送。

还是解决不了？发邮件到 [email protected]。