核心功能
Memos skill 提供了一个简洁的命令行接口,用于与 Memos 开源笔记平台的 REST API 交互。该技能实现了备忘录的完整生命周期管理:创建(支持 PUBLIC/PRIVATE/PROTECTED 三种可见性)、按 ID 检索、分页列表查询以及安全删除(含强制删除选项)。所有操作自动附加 #openclaw 标签便于追踪来源。
显著优点
- 自托管友好:完全支持私有部署的 Memos 实例,数据主权可控
- 标准化输出:统一返回 JSON 格式,便于脚本化集成和自动化工作流
- 健壮的错误处理:涵盖 API 错误、网络超时(30秒)、参数校验等场景,错误信息结构化输出到 stderr
- 灵活的 ID 格式:支持
memos/123或纯数字123两种 ID 形式 - 直接 Python 调用:无需 OpenClaw 环境即可独立运行,调试方便
潜在局限
- 功能边界有限:仅覆盖基础 CRUD,不支持 Markdown 渲染预览、附件上传、标签管理等高级功能
- 无状态设计:每次调用独立认证,无连接池或会话复用
- 依赖环境变量:
MEMOS_URL和MEMOS_TOKEN必须预配置,动态切换实例不便 - 可见性默认值固定:
PUBLIC为默认,敏感内容存在误发风险
适用人群
- 使用 Memos 作为个人知识库的技术用户
- 需要搭建自动化笔记工作流的开发者
- 追求数据自主、拒绝 SaaS 绑定的隐私敏感型用户
常规风险提示
- 令牌泄露风险:
MEMOS_TOKEN具备完全 API 权限,需严格保密;技能明确警示禁止公开分享 - 误删风险:
delete命令的force参数可绕过关联数据检查,不可逆操作需谨慎 - 实例可访问性:依赖网络连接至自托管服务,无本地缓存或离线回退机制
- 数据合规:PUBLIC 可见性内容可被搜索引擎索引,需确认内容敏感性