核心用法
Memos Skill 是一个面向自托管 Memos 笔记服务的 MCP 工具集,通过 openclaw-memos-mcp 服务器实现与 Memos 实例的通信。该技能提供 5 个核心操作:memos_create 创建笔记、memos_list 检索笔记(支持 CEL 过滤表达式)、memos_get 读取单条、memos_update 更新内容与元数据、memos_delete 删除笔记。笔记内容支持 Markdown 格式,自动识别 #hashtags 作为标签,可见性分为 PRIVATE(默认)、PROTECTED(登录用户可见)、PUBLIC 三级。
显著优点
- 隐私优先:完全基于自托管架构,数据不经过第三方云服务,配合默认 PRIVATE 可见性设计
- 标准化协议:采用 MCP(Model Context Protocol)规范,与支持 MCP 的 Agent 无缝集成
- 灵活检索:CEL 过滤表达式支持标签、可见性、创建者等多维度筛选,满足复杂查询需求
- 零配置负担:通过
npx直接运行,无需本地安装,环境变量配置简洁
潜在缺点与局限性
- 部署门槛:用户需自行部署 Memos 实例并获取 Access Token,对非技术用户存在学习成本
- 网络依赖:依赖本地或远程 Memos 服务的可用性,连接中断时功能完全不可用
- 单实例限制:当前配置仅支持单一 Memos 端点,无法同时管理多个实例
- 无离线支持:所有操作实时同步,无本地缓存或离线编辑能力
适合人群
- 已部署 Memos 实例的技术用户或隐私敏感者
- 需要通过 AI Agent 快速记录、检索个人笔记的效率追求者
- 希望将笔记工作流集成到 MCP 生态系统的开发者
常规风险
- Token 泄露风险:
MEMOS_TOKEN以明文形式存储于环境变量,共享配置时可能导致未授权访问 - 误删除不可逆:
memos_delete操作永久删除数据,技能文档已要求二次确认,但仍需用户谨慎 - 实例可用性:自托管服务的稳定性完全依赖用户维护,无 SLA 保障
- 过滤注入风险:CEL 表达式若未来支持用户输入拼接,需防范注入攻击(当前版本仅支持预定义过滤)