基于 Memos API 的轻量级备忘录管理工具,支持创建、读取、删除和列表操作,适合个人笔记工作流集成。
基本信息
- 技能名称?Memos
- 中文名称?你的 Memos 笔记,一键触达
- 作者?fty4
- 分类?专业技能
- 版本?0.1.1
- 标签?note-taking, memos, api-integration, self-hosted, productivity, cli-tool
使用方法
使用说明
核心用法
Memos Skill 为 OpenClaw 提供了与 Memos 开源笔记平台的无缝集成能力。用户可通过简单的命令行接口完成备忘录的全生命周期管理,包括创建(支持 PUBLIC/PRIVATE/PROTECTED 三种可见性)、按 ID 检索、删除(支持强制删除关联数据)以及分页列表查询。所有操作均通过 RESTful API 与 Memos 实例通信,返回标准 JSON 格式便于后续处理。
显著优点
- 零配置复杂度 :仅需两个环境变量( MEMOS_URL 和 MEMOS_TOKEN )即可运行,无需复杂的 OAuth 流程
- 自动标签注入 :创建时自动附加 #openclaw 标签,便于在 Memos 中追溯来源
- 灵活的 ID 格式 :支持 memos/123 或纯数字 123 两种 ID 格式,提升用户体验
- 完善的错误反馈 :API 错误、网络超时、参数校验失败均返回结构化 JSON 错误信息,包含 HTTP 状态码便于调试
- 双模式执行 :既可通过 openclaw skill-run 调用,也可直接以 Python 脚本形式独立运行
潜在缺点与局限性
功能范围有限 :当前仅覆盖核心 CRUD 操作,不支持 Markdown 图片上传、标签管理、评论等高级功能
分页硬限制 :单次最大查询 1000 条,大数据量场景需客户端自行实现分页逻辑
无本地缓存 :每次操作均实时调用 API,网络波动时体验受限
可见性认知门槛 :PUBLIC/PROTECTED/PRIVATE 的区分需用户理解 Memos 的权限模型
Token 安全依赖 :完全依赖用户自行保管 MEMOS_TOKEN ,无自动轮换机制
适合人群
已部署 Memos 实例的个人用户,寻求 CLI 或自动化工具集成
需要将笔记操作嵌入工作流(如配合其他 OpenClaw skill 串联执行)的开发者
偏好命令行交互、追求极简配置的技术型用户
常规风险
| 风险类型 | 说明 | 缓解建议 | |---------|------|---------| | Token 泄露 |MEMOS_TOKEN若被窃取可导致账户数据暴露 | 使用环境变量或密钥管理服务存储,避免硬编码 | | 误删数据 |delete命令的force参数可绕过保护机制 | 生产环境操作前建议先get确认内容 | | 网络暴露 | 若MEMOS_URL使用 HTTP 而非 HTTPS,存在中间人攻击风险 | 务必配置 TLS 加密连接 | | 可见性误配 | PUBLIC 内容可被实例内所有用户查看 | 敏感信息务必使用 PRIVATE 选项 | 扩展性提示
Skill 采用模块化 Python 实现,新增 API 端点支持仅需遵循现有函数模式,具备良好的可维护性。
💬 评论 (0)
📭 还没有评论,快来抢沙发吧!