用途：Voicenotes 是 Voicenotes 团队提供的官方 OpenClaw 技能，让智能体访问其新 API，用于创建、搜索和检索用户的语音/文本笔记，支持语义搜索、完整转录获取以及按标签和日期范围过滤。
配置方式：先在 https://voicenotes.com/app?open-claw=true#settings 创建集成并复制 API Key。Webchat 中在 Skills → Voicenotes → API Key 填写；终端可写入 OpenClaw 配置（~/.openclaw/config.yaml）的 skills.voicenotes.env.VOICENOTES_API_KEY，或直接 export VOICENOTES_API_KEY="your_key_here"，之后通过环境变量 $VOICENOTES_API_KEY 使用。
主要能力：语义搜索笔记（GET .../search/semantic?query=）；按标签和日期范围获取多条录音（POST .../recordings）；获取单条录音完整转录（GET .../recordings/{recording_uuid}）；创建文本笔记（POST .../recordings/new，recording_type 为 3）。所有请求需 Authorization 头。
返回结构与字段：语义搜索返回按相关度排序的数组，type 可为 note、note_split、import_split；其中 note_split 可用 uuid 拉取完整转录，import_split 的 title 是文件名且无法通过 /recordings/{uuid} 获取。录音列表返回分页数据，含 links.next、meta.per_page（默认 10）。单条详情含 id、transcript（会议含 [HH:MM:SS] Speaker N 时间戳）、duration（毫秒）、recording_type（1 语音笔记、2 语音会议、3 文本笔记）和 tags。
限制与安全：笔记 ID 为 UUID；速率限制约每秒 3 次请求。仅访问 api.voicenotes.com；无凭据外泄、无外部数据存储、无遥测分析、无自动代码执行或文件覆写；读写仅限用户自己的 Voicenotes 数据。构造请求时须净化输入：搜索查询用 --data-urlencode、UUID 需校验（^[a-zA-Z0-9]{8}$）、JSON 字段正确编码，避免拼接原始输入。
暂未提供：定价、可用平台范围等资料未说明。