MemOS Cloud 是一个帮助用户把 MemOS Cloud 长期记忆能力集成进真实项目的技能。它强调以有来源的代码和最小化、任务导向的文档为主,而非泛泛的 API 摘要。
用途:面向需要为 AI 应用或 Agent 增加长期记忆、知识库检索、消息写入与记忆搜索能力的开发场景,例如「接入 MemOS」「添加长期记忆」「让我的 Agent 记住」等需求。
主要能力:在集成前提供一条必需工作流——先运行 scripts/upgrade.py,若网络受限则报告资源同步失败并继续使用已捆绑资源;确认 resources/cn/index.md 或 resources/en/index.md 存在且可读;读取 resources/index.md 并按用户语言选择中文或英文资源;对宽泛请求先读 starter-pack.md;用 index.md 选择最小必要资源集,不默认加载全部资源。随后检查环境变量 MEMOS_API_KEY:若存在且以 mpg- 开头,执行一次快速 add + search 验证连通性,并向用户展示写入与检索内容;若缺失或为占位符,则告知用户需配置 Key,给出从 https://memos-dashboard.openmem.net/cn/quickstart 获取 Key 并运行 export MEMOS_API_KEY="mpg-..." 的步骤,等待用户确认后再验证。验证通过后报告结果并停止,除非用户明确要求,否则不检查项目、不选择集成路径、不生成代码。
使用方式:仅在用户明确请求集成代码时,才检查项目(后端/前端边界、包管理器、框架、运行时、现有 LLM 调用路径、认证模型、测试命令),选择集成路径(产品/Vibe Coding 集成优先服务端 API/SDK 的 addMessage + searchMemory,除非用户明确要求用 Chat API 生成回复;知识库检索结合 features-knowledge-base.md 与 api-search-memory.md),生成契合技术栈的代码(仅 Python 后端用 Python SDK,Node/TypeScript、Java/Spring、浏览器扩展后端等用 HTTP),并在项目支持时做最终验证(测试、类型检查、lint 或实时 add+search)。
限制与守则:不要向最终用户暴露内部技能文件名;API Key 必须保留在服务端,禁止放入浏览器包、移动客户端、内容脚本、公共配置或提交文件;默认使用 https://memos.memtensor.cn/api/openmem/v1;核心 HTTP 调用优先 POST /add/message 与 POST /search/memory;不要混用 Cloud、开源本地部署、MCP、Dashboard 与 CLI 设置;user_id 视为稳定终端用户标识,conversation_id 视为稳定会话标识;文档不完整或不一致时说明缺口并选择最窄的已验证路径,不臆造行为;删除、反馈、项目配置及 Cloud/开源边界问题需先读相关参考。集成代码输出需包含变更文件、所需环境变量、请求/响应结构、记忆搜索注入 LLM 提示的位置、完整轮次写回位置、验证步骤(含无 Key 本地检查和可选带 MEMOS_API_KEY 的实时检查)及未解决的产品或文档缺口。