← 返回文档中心

用户手册

OMemAI 用户手册

从零开始,把 OpenClaw、MCP 客户端或自研 AI 稳定接入 OMemAI 长期记忆系统。

1. 创建项目

登录后进入 /projects/new,创建一个项目记忆空间。项目是记忆隔离边界。

2. 创建 API Key

登录后进入 /api-keys,创建包含 agent:read 和 agent:write 的 Key。完整 Key 只显示一次。

3. 选择接入路线

普通用户推荐 Gateway;支持 MCP 的客户端可选 MCP;自研脚本可选 REST。

4. 复制提示词给你的 AI

进入 /docs/prompts,复制对应路线提示词。不要把完整 API Key 粘到公开聊天或仓库。

5. 运行安装和验证

Gateway 路线会下载到 ~/omemai-gateway,运行 doctor --full、start-gateway,并验证版本/闭环/健康。

6. 查看健康和会话

登录后进入 /agent-health 看接入是否健康;登录后进入 /sessions 查看保存的完整上下文和原始消息。

推荐判断标准

当 /agent-health 显示对应 API Key 为“健康”,且来源包含 Gateway 网关 / Gateway 自检,就说明强制记忆流程已经跑通。MCP 路线应显示 来源为 MCP 工具。