核心用法
Voicenotes 技能为 OpenClaw 提供了与 Voicenotes 笔记平台深度集成的能力，主要支持四类核心操作：
语义搜索：通过自然语言查询用户历史笔记，返回按相关性排序的笔记片段或完整笔记，支持理解上下文语义而非仅关键词匹配。
过滤检索：可按标签数组或 UTC 时间范围筛选笔记，适合批量回顾特定主题或时间段的内容，结果支持分页加载。
全文获取：通过笔记 UUID 获取完整转录文本，包括会议记录的时间戳和发言人标记，满足深度内容回顾需求。
文本笔记创建：支持直接在 Voicenotes 中新建文字笔记（recording_type=3），实现从对话到知识库的无缝沉淀。
显著优点
- 官方出品：由 Voicenotes 团队直接开发维护，API 对接稳定，功能迭代有保障
- 语义理解：突破传统关键词搜索，能理解查询意图， recall 率更高
- 多格式兼容：同时处理语音笔记、会议记录和文本笔记三种类型
- 安全设计：输入严格校验（UUID 格式验证、URL 编码、Shell 元字符过滤），降低注入风险
- 无数据外泄：仅访问官方 API 端点，不存储、不分析、不外传用户凭证或笔记内容
潜在局限
- 速率限制：约 3 请求/秒的平均限流，高频场景需配合缓存或批处理策略
- 依赖外部服务：Voicenotes 平台可用性直接影响技能功能
- 导入笔记受限：
import_split类型片段无法通过 UUID 接口获取完整内容 - 配置门槛：需用户主动在 Voicenotes 后台创建集成并获取 API Key，对非技术用户有一定学习成本
适合人群
- 重度 Voicenotes 用户，需通过对话快速检索历史语音记录
- 知识工作者，希望将日常对话内容沉淀为结构化笔记
- 会议频繁者，需要回顾带时间戳的会议转录文本
- OpenClaw 终端用户，偏好命令行交互的极客群体
常规风险
- API Key 泄露：环境变量配置不当可能导致密钥暴露，建议配合密钥管理工具使用
- 隐私边界：语义搜索可能意外召回敏感内容，建议在共享环境中谨慎使用
- 数据一致性：网络异常可能导致创建或检索失败，关键操作建议二次确认