面向 OpenClaw/Moltbot/ClawDBot 的官方生命周期插件，通过 MemOS Cloud 为 Agent 提供跨会话长期记忆能力。
MemOS Cloud OpenClaw Plugin 是由 MemTensor（OpenMem）组织维护的官方插件，专为 OpenClaw、Moltbot、ClawDBot 三种 Agent 框架设计，核心目标是为 Agent 系统注入长期记忆能力。
插件基于生命周期钩子机制工作：在 before_agent_start 阶段自动调用 MemOS Cloud 的记忆检索 API，根据用户 prompt 进行语义搜索，将相关记忆以 <memories> 块形式注入 Agent 上下文；在 agent_end 阶段自动将本轮对话异步写入 MemOS Cloud，实现记忆的持续积累。
核心特性#
记忆召回：支持全局记忆搜索（跨会话召回，不传 conversation_id）、可配置召回数量（memoryLimitNumber）与相关性阈值（relativity）。
记忆写入：支持异步写入（默认开启，不阻塞 Agent 运行）、两种捕获策略（last_turn 仅末轮 / full_session 完整会话）、写入时附加自定义标签。
模型级召回过滤：可选启用，将召回候选发送至用户自托管的 OpenAI 兼容模型（如 Ollama qwen2.5:7b）进行二次相关性判断，仅保留通过过滤的记忆注入上下文。
多 Agent 支持：通过 multiAgentMode + agent_id 实现 Agent 间数据隔离，支持 allowedAgents 白名单控制和 agentOverrides 逐 Agent 覆盖配置（知识库 ID、召回数量、相关性阈值等）。
知识库增强：可绑定全局知识库 ID（逗号分隔），使 Agent 检索时同时覆盖领域知识。
运维体验：内置 Config UI，网关启动时自动开启本地配置页面（默认 http://127.0.0.1:38463），可直接编辑插件配置并写入宿主配置文件。
据官方描述，智能记忆检索相比加载完整聊天历史可降低约 72% 的 token 用量。
安装部署#
前置条件：Node.js 运行环境；OpenClaw / Moltbot / ClawDBot 网关；MemOS Cloud API Key。
NPM 安装（推荐）：
openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest
openclaw gateway restart
手动安装（Windows 用户）：从 NPM 下载 .tgz 解压至本地扩展目录，在 openclaw.json 中配置 load.paths。
获取 API Key：前往 MemOS Dashboard 注册并复制。
最简配置（~/.openclaw/.env）：
MEMOS_API_KEY="mpg-..."
关键配置项#
| 配置 | 说明 | 默认值 |
|---|---|---|
MEMOS_API_KEY | 必需，MemOS Cloud Token | — |
MEMOS_BASE_URL | API 基础地址 | https://memos.memtensor.cn/api/openmem/v1 |
MEMOS_USER_ID | 用户标识 | openclaw-user |
MEMOS_KNOWLEDGEBASE_IDS | 全局知识库 ID（逗号分隔） | 空 |
MEMOS_RECALL_GLOBAL | 全局搜索 | true |
MEMOS_MULTI_AGENT_MODE | 多 Agent 隔离模式 | false |
MEMOS_ALLOWED_AGENTS | Agent 白名单 | 空（全部启用） |
MEMOS_RECALL_FILTER_ENABLED | 模型级召回过滤 | false |
MEMOS_RECALL_FILTER_BASE_URL | 过滤模型端点 | http://127.0.0.1:11434/v1 |
MEMOS_ASYNC_MODE | 异步写入 | true |
MEMOS_CAPTURE_STRATEGY | 捕获策略 | last_turn |
MEMOS_TAGS | 写入时附加标签 | openclaw |
配置优先级：插件 config → 环境文件（~/.openclaw/.env → ~/.moltbot/.env → ~/.clawdbot/.env）。
架构要点#
- 入口文件
index.js，核心逻辑在lib/目录 - 三套框架适配描述文件：
openclaw.plugin.json/moltbot.plugin.json/clawdbot.plugin.json - 召回结果通过
appendSystemContext注入稳定协议，<memories>块保留在prependContext中 - 认证方式：Token Auth（
Authorization: Token <MEMOS_API_KEY>） - 依赖的外部 API：
POST /search/memory（记忆检索）、POST /add/message（记忆写入）
生态关联#
- 父项目：MemOS — AI Memory OS，提供统一记忆 API、多模态记忆、知识库管理
- 组织：MemTensor (OpenMem)
- 宿主框架：OpenClaw、Moltbot、ClawDBot
- Recall Filter 依赖：用户自托管的 OpenAI 兼容模型
待确认信息#
- MemOS Cloud 服务定价与 SLA 未在 README 中说明，Dashboard 页面无法直接访问验证
- Recall Filter 所需模型性能要求未明确，仅示例使用
qwen2.5:7b - Cloud Plugin 与 Local Plugin 是否可同时启用未明确说明
memos.memtensor.cn域名暗示中国大陆节点，是否有其他区域端点未确认appendSystemContext与prependContext的具体区别与选用逻辑未详细说明agentOverrides配置的完整 schema 未给出