MemOS CLI上线：命令行Agent接入长期记忆教程

作者：php是最好的2026.11.03 12:21浏览量：0

简介：本教程详细讲解如何通过命令行工具（CLI）为支持终端执行的智能Agent快速接入长期记忆能力。读者将学会本地安装配置、完成记忆写入检索与删除、让Agent自动调用记忆Skill，以及多框架统一接入的方法，适合开发者、技术负责人与运维人员参考。

agent-">MemOS CLI 上线：命令行 Agent 接入长期记忆完整教程

一、教程目标

本教程旨在帮助读者完成以下核心任务：

  1. 在本地终端环境中快速安装并配置 MemOS CLI 工具；
  2. 通过命令行完成长期记忆的写入、检索、读取、删除、对话、抽取、重排和反馈等基础操作；
  3. 将记忆能力封装为可被智能 Agent 自动调用的通用 Skill；
  4. 理解如何让不同框架下的 Agent 统一通过同一套 CLI 接入长期记忆层。

适合读者：具备基础命令行操作能力的开发者、Agent 系统架构师、技术负责人以及希望快速验证记忆链路效果的运维人员。

二、适用场景

  • 本地快速验证：在搭建完整应用之前，先在终端里跑通记忆写入与检索链路；
  • Agent 自动化集成：让 Agent 在对话前自动检索上下文、在任务完成后自动归档记忆；
  • 多框架统一记忆：无论使用哪种主流终端型 Agent 框架，都通过同一套 CLI 管理长期记忆；
  • 调试与排查：在接入 Agent 前，先确认记忆是否正常写入、召回是否准确、反馈是否生效。

三、前置准备

在开始操作前，请确认以下条件：

项目 说明
运行环境 支持主流包管理器（如 npm）的操作系统，具备终端/Shell 访问权限
网络连通 能够访问 MemOS 对应的云端服务接口
账号与密钥 已在云端服务平台注册账号，并获取 API Key
基础知识 了解什么是长期记忆（Long-term Memory）、了解 Agent 与记忆系统的基本交互模式

注意：本文不涉及具体云厂商控制台操作，读者需自行在对应云服务平台完成账号注册与密钥获取。

四、实施步骤

步骤一：安装 MemOS CLI

做什么：通过包管理器全局安装 MemOS CLI 工具。

为什么做：CLI 是最轻量的接入方式，安装后即可在任意终端使用，无需额外搭建应用或插件。

操作示例：

  1. npm install -g @memtensor/memos-cloud-cli

注意事项：

  • 确保当前用户对全局安装路径有写权限；
  • 如遇权限问题，可在命令前添加适当的权限提升前缀（视系统而定）；
  • 安装完成后可通过 memos --version 确认版本。

步骤二：初始化与配置 API Key

做什么：将云端服务的 API Key 配置到本地 CLI 环境。

为什么做：CLI 需要鉴权才能访问远程记忆存储，API Key 是身份凭证。

操作示例：

  1. # 初始化配置（首次使用）
  2. memos config init
  4. # 设置 API Key
  5. memos config set platform.api_key YOUR_API_KEY

配置说明：

  • platform.api_key：对应云端记忆服务的访问密钥，从云服务平台获取；
  • 建议将密钥存储在环境变量或安全的配置文件中，避免明文硬编码；
  • 可通过 memos config list 查看当前所有配置项。

步骤三：执行基础记忆操作

CLI 支持一组核心命令，覆盖记忆全生命周期：

3.1 写入记忆（add）

  1. memos add "用户偏好使用 Python 编写自动化脚本"

说明：将一段文本作为记忆条目存入系统。可附加标签、时间戳等元数据（视具体实现而定）。

3.2 检索记忆（search）

  1. memos search "编程语言偏好"

说明：根据关键词或语义查询相关记忆。返回结果通常包含匹配条目与相似度分数。

3.3 读取记忆（get）

  1. memos get --id <记忆条目ID>

说明：通过唯一标识符获取某条记忆的完整内容。

3.4 删除记忆（delete）

  1. memos delete --id <记忆条目ID>

说明：永久移除指定记忆条目，操作不可逆，需谨慎使用。

3.5 对话验证（chat）

  1. memos chat "你知道我的编程偏好吗？"

说明：以对话形式验证记忆是否被正确召回并用于回答，是调试记忆链路最直观的方式。

3.6 抽取、重排与反馈（extract / rerank / feedback）

  1. memos extract --source <来源>   # 从对话或文本中抽取关键记忆
  2. memos rerank --query <查询>    # 对检索结果重新排序
  3. memos feedback --id <ID> --score 5  # 对记忆质量打分

说明：抽取用于从原始对话中提炼结构化记忆；重排用于优化检索精度；反馈用于持续改进记忆质量。

步骤四：为 Agent 安装记忆 Skill

做什么：将 CLI 提供的记忆能力封装为 Agent 可调用的 Skill 模块。

为什么做：Agent 通常通过工具调用（Tool Call）机制与外部能力交互，将记忆操作封装为 Skill 后，Agent 可以在对话前自动检索、对话后自动写入，无需开发者手动编排。

通用思路：

  1. Agent 对话开始
  2.     ↓
  3. 调用 memory_search Skill → 检索相关历史记忆
  4.     ↓
  5. 将检索结果注入上下文
  6.     ↓
  7. Agent 生成回答
  8.     ↓
  9. 调用 memory_add Skill → 将本次关键信息归档
  10.     ↓
  11. Agent 对话结束

注意事项：

  • Skill 的安装方式取决于所使用的 Agent 框架，通常为配置文件声明或命令注册；
  • 需要确保 Agent 运行环境能访问到已安装的 CLI 工具；
  • 建议先在本地用 CLI 手动验证 Skill 效果，再接入 Agent。

步骤五：多框架统一接入

做什么：让不同终端型 Agent 框架共享同一套 MemOS CLI 记忆层。

为什么做：避免记忆能力被绑定在单一框架中，降低迁移成本，提升可维护性。

实施要点：

  1. 在各框架的工具/插件配置中，统一指向 MemOS CLI 提供的命令接口；
  2. 保持各框架对记忆的调用方式一致（如统一使用 add/search/chat 等语义）；
  3. 通过 CLI 的统一配置管理 API Key 与服务端点，避免各框架各自维护。

五、结果验证

完成上述步骤后，建议按以下流程验证：

  1. 写入验证：执行 memos add 后，用 memos search 确认能搜到；
  2. 检索验证：用不同关键词检索同一条记忆，确认召回率合理；
  3. 对话验证：执行 memos chat，确认回答中引用了正确的记忆内容；
  4. Agent 联调：让 Agent 完成一轮带记忆的对话，检查对话前是否自动检索、对话后是否自动归档；
  5. 跨框架测试：在至少两个不同 Agent 框架中重复上述验证，确认行为一致。

六、常见问题与排查

问题 可能原因 解决思路
安装失败 网络不通或包管理器版本过低 检查网络代理、升级包管理器
写入后搜不到 关键词不匹配或记忆未成功提交 检查返回状态码、尝试更宽泛的检索词
Agent 调用无响应 CLI 路径未加入 Agent 环境变量 在 Agent 启动配置中显式指定 CLI 路径
API Key 鉴权失败 密钥过期或配置错误 重新生成密钥并更新配置
记忆重复或冲突 同一内容多次写入未去重 使用抽取与重排功能清理冗余条目

七、优化建议

  • 性能层面：对高频检索场景，可考虑在本地建立记忆索引缓存，减少远程调用延迟；
  • 安全层面：API Key 不要提交到版本控制系统，建议使用环境变量或密钥管理服务；
  • 稳定性层面：在生产环境中为 CLI 调用增加超时与重试机制，避免 Agent 因记忆服务波动而中断；
  • 成本控制：定期清理过期或低质量记忆，避免存储与检索费用持续增长；
  • 可维护性：为记忆条目统一添加标签与分类，便于后续管理与审计。

八、总结

本教程围绕 MemOS CLI 的安装、配置、基础操作、Agent Skill 接入与多框架统一管理五个核心环节展开。通过命令行这一最轻量的入口，开发者可以跳过繁琐的应用搭建，直接在终端完成长期记忆链路的验证与调试；Agent 可以通过标准化 Skill 自动获得记忆能力；多框架用户则获得了统一的记忆层。后续可持续关注记忆抽取质量优化、Agent 调用策略调优以及与更多云端服务的集成方向。

最热文章