voicenotes

使用 Voicenotes 技能创建、搜索并检索用户的笔记。

配置

1. 在 https://voicenotes.com/app?open-claw=true#settings 创建一个集成
2. 复制 API 密钥
3. 进行如下配置：

Webchat：技能 → Voicenotes → 侧边栏中的 API Key

终端：添加到 OpenClaw 配置文件（~/.openclaw/config.yaml）中：

skills:
  voicenotes:
    env:
      VOICENOTES_API_KEY: "your_key_here"

或直接导出环境变量：

export VOICENOTES_API_KEY="your_key_here"

此后该密钥将作为环境变量 $VOICENOTES_API_KEY 可用。

API 基础

所有请求均需携带 Authorization 请求头：

curl -X GET "https://api.voicenotes.com/api/integrations/open-claw/..." 
  -H "Authorization: $VOICENOTES_API_KEY"

常用操作

在用户笔记中执行搜索查询：

查询参数：

• query（必填）：搜索关键词字符串

curl -X GET "https://api.voicenotes.com/api/integrations/open-claw/search/semantic?query={search_query}" 
  -H "Authorization: $VOICENOTES_API_KEY"

按筛选条件（标签和日期范围）获取多个 Voicenotes：

查询参数：

• tags（可选）：合法标签组成的数组
• date_range（可选）：包含起始与结束时间（UTC 时间戳格式）的数组

curl -X POST "https://api.voicenotes.com/api/integrations/open-claw/recordings" 
  -H "Authorization: $VOICENOTES_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "tags": ["tag1", "tag2"],
    "date_range": ["2026-01-01T00:00:00.000000Z", "2026-02-01T00:00:00.000000Z"]
  }'

如需更多上下文，请获取完整转录文本：

curl "https://api.voicenotes.com/api/integrations/open-claw/recordings/{recording_uuid}" 
  -H "Authorization: $VOICENOTES_API_KEY" 

在 Voicenotes 中创建一条文本笔记：

curl -X POST "https://api.voicenotes.com/api/integrations/open-claw/recordings/new" 
  -H "Authorization: $VOICENOTES_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "recording_type": 3,
    "transcript": "note content here",
    "device_info": "open-claw"
  }'

响应结构

语义搜索响应：

返回按相关性排序的笔记及笔记片段数组：

[
  {
    "type": "note",
    "uuid": "NTHiJljf",
    "title": "Quick idea about project",
    "transcript": "Full transcript text with 
 for line breaks...",
    "tags": ["idea", "project"],
    "created_at": "2025-01-15T10:30:00.000000Z"
  },
  {
    "type": "note_split",
    "uuid": "8JzkhEGh",
    "title": "Long meeting notes",
    "transcript": "Relevant chunk from a larger note...",
    "tags": ["meeting"],
    "created_at": "2025-01-14T09:00:00.000000Z"
  },
  {
    "type": "import_split",
    "uuid": "xYz12345",
    "title": "filename.extension",
    "transcript": "Chunk from an imported note...",
    "tags": ["imported"],
    "created_at": "2025-01-10T14:00:00.000000Z"
  }
]

• type: "note" —— 完整匹配搜索结果的笔记
• type: "note_split" —— 来自较大笔记的片段；如需完整转录文本，可使用 uuid 调用对应接口获取
• type: "import_split" —— 来自导入笔记的片段；其 title 字段为原始文件名；不可通过 /recordings/{uuid} 接口获取
• transcript 字段可能包含 HTML 标签（如
、）用于格式化

{
  "data": [
    {
      "id": "bTZI5t12",
      "title": null,
      "transcript": "this is a sample note",
      "duration": 0,
      "recorded_at": "2026-02-06T10:07:45.000000Z",
      "created_at": "2026-02-06T10:07:45.000000Z",
      "recording_type": 3,
      "tags": []
    }
  ],
  "links": {
    "first": "https://api.voicenotes.com/api/integrations/open-claw/recordings?page=1",
    "last": null,
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "path": "https://api.voicenotes.com/api/integrations/open-claw/recordings",
    "per_page": 10,
    "to": 1
  }
}

{
  "data": {
    "id": "NTHiJljf",
    "title": "Meeting Connectivity Check",
    "transcript": "Full transcript text...",
    "duration": 12101,
    "recorded_at": "2025-08-07T09:50:14.000000Z",
    "created_at": "2025-08-07T09:50:14.000000Z",
    "recording_type": 2,
    "tags": ["meeting"],
    "subnotes": [],
    "attachments": []
  }
}

{
  "message": "Recording audio uploaded successfully!",
  "recording": {
    "id": "bPI3RcUP",
    "recording_id": "bPI3RcUP",
    "title": null,
    "transcript": "Sample note",
    "recording_type": 3,
    "created_at": "2026-02-04T08:51:29.000000Z",
    "tags": []
  }
}

curl -G "https://api.voicenotes.com/api/integrations/open-claw/search/semantic" 
  --data-urlencode "query=user search term here" 
  -H "Authorization: $VOICENOTES_API_KEY"