ClawHub

灵犀Note录音文件查询

Data & APIs

灵犀Note录音文件查询 Skill - 查询销售录音和会议录音列表及详情。 **当以下情况时使用此 Skill**： (1) 用户要查询录音列表：「录音列表」「查录音」「销售录音」「会议录音」 (2) 用户要查看录音详情：「录音详情」「查看录音」 (3) 用户要配置灵犀 API：「配置灵犀」「连接灵犀」 (4) 用户要查询会议录音：「会议录音」「会议列表」「查会议」

Install

openclaw skills install lingxiai-note-recording

灵犀Note录音文件查询 Skill

指令路由表

指令角色说明详细文档
/lyk list 或「录音列表」📋 列表官查询录音文件列表（默认销售录音）references/list.md
/lyk meeting 或「会议录音」📋 会议官查询会议录音列表references/list.md
/lyk detail <id>🎙️ 详情官查看指定ID录音的完整详情references/list.md
/lyk config 或「配置灵犀」⚙️ 配置配置 API Keyreferences/config.md

自然语言路由

「录音列表」「查录音」「销售录音」        → /lyk list
「会议录音」「会议列表」「查会议」         → /lyk meeting
「录音详情」「查看录音」                  → /lyk detail（需提供ID）
「配置」「连接灵犀」                       → /lyk config

决策原则：优先区分销售录音和会议录音。有"会议"关键字就是 /lyk meeting，其他默认 /lyk list。

API 路由表

录音文件

方法路径说明详细文档
GET/api/api/apiKeyConfig/innerApi/userRecordingQuery销售录音列表查询references/list.md
GET/api/api/apiKeyConfig/innerApi/userRecordingMeetingQuery会议录音列表查询references/list.md

完整 URL 格式：LYK_API_URL（默认 https://aiapi.szyldata.com/api）+ 路径

⚠️ 路径为 /api/api/apiKeyConfig/innerApi/...（双 /api），最终拼接：https://aiapi.szyldata.com/api/api/apiKeyConfig/innerApi/...

⚠️ Agent 必读约束

🔑 认证

  • 请求头：AuthorizationLyk: lyk-xxx（格式：lyk- 开头）
  • 每次调用 API 前检查环境变量 LYK_API_KEY 是否存在；若不存在，提示用户先完成配置

🔢 请求参数规范（严格按文档）

  • 文档中未说明的参数，一律不传
  • 销售录音列表接口 userRecordingQuery 为无参 GET 请求
  • 会议录音列表接口 userRecordingMeetingQuery 为无参 GET 请求
  • URL 拼接：LYK_API_URL + /api/api/apiKeyConfig/innerApi/...（双 /api）

🚫 反幻觉边界

  • 禁止编造录音 ID：所有 id 必须来自 API 响应，不得凭空构造
  • 禁止伪造 API 响应：不得在未实际调用 API 的情况下告诉用户查询结果
  • 禁止忽略错误码：API 返回非 200 时必须处理，不得静默吞掉

🔄 失败重试策略

  • 网络/服务错误（HTTP 5xx 或超时）：等待 5 秒后重试一次，仍失败则报告错误
  • 鉴权失败（401）：检查 API Key 是否正确或已失效
  • 服务错误（500）：稍后重试

🔒 安全规则

  • 录音数据属于用户隐私，不在群聊中主动展示完整内容
  • 调用前验证 API Key 有效性

通用错误处理

录音文件接口返回格式：

{
  "code": 200,
  "message": "操作成功",
  "msg": "操作成功",
  "data": [],
  "succeed": true
}
code说明处理方式
200成功返回 data 数据
401鉴权失败检查 API Key
500服务错误稍后重试

常见错误码（500系列）

错误消息说明处理方式
AuthorizationLyk不能为空请求头中缺少 AuthorizationLyk 字段检查请求是否正确携带了 AuthorizationLyk: lyk-xxx 请求头
AuthorizationLyk不存在提供的 API Key 无效或已失效确认 API Key 是否正确，或重新配置新的 Key

实现说明

API 请求规范（严格遵循文档）

  1. 请求头：必须携带 AuthorizationLyk 字段，格式为 lyk-xxx
  2. 请求参数：文档中未明确说明的参数，一律不传。两个列表接口均为无参请求
  3. URL 拼接：完整 URL = LYK_API_URL + /api/apiKeyConfig/innerApi/...（注意：只有一个 /api）

请求示例

销售录音（无参）：

curl -X GET "https://aiapi.szyldata.com/api/api/apiKeyConfig/innerApi/userRecordingQuery" \
  -H "AuthorizationLyk: lyk-xxx" \
  -H "Accept: */*"

会议录音（无参）：

curl -X GET "https://aiapi.szyldata.com/api/api/apiKeyConfig/innerApi/userRecordingMeetingQuery" \
  -H "AuthorizationLyk: lyk-xxx" \
  -H "Accept: */*"

Python 实现参考

import requests

def list_recordings(api_key: str, api_url: str = "https://aiapi.szyldata.com"):
    """查询销售录音列表（无参）"""
    url = f"{api_url}/api/api/apiKeyConfig/innerApi/userRecordingQuery"
    headers = {"AuthorizationLyk": api_key, "Accept": "*/*"}
    resp = requests.get(url, headers=headers)
    return resp.json()

def list_meetings(api_key: str, api_url: str = "https://aiapi.szyldata.com"):
    """查询会议录音列表（无参）"""
    url = f"{api_url}/api/api/apiKeyConfig/innerApi/userRecordingMeetingQuery"
    headers = {"AuthorizationLyk": api_key, "Accept": "*/*"}
    resp = requests.get(url, headers=headers)
    return resp.json()

响应字段

字段类型说明
codeint状态码，200 为成功
messagestring消息
msgstring消息
dataarray录音数据数组
succeedboolean是否成功

data 数组元素（实际API返回字段）

⚠️ 以下字段名称严格来自真实 API 响应，不得删除或修改。

字段类型说明
idstring录音文件ID
publicUrlstring公网URL（音频文件地址）
transcriptionSegmentsJsonstring带时间戳的录音分析分段（JSON字符串）
summaryJsonstring全文摘要（JSON字符串），解析后含 title 和 summary
keyPointsJsonstring重点内容（JSON字符串）
insightAnalysisJsonstring洞察分析（JSON字符串）
mindMapJsonstring思维导图（JSON字符串）
translationJsonstring翻译（可能为null）
speakerSummaryJsonstring按说话人总结（JSON字符串）
briefSummaryJsonstring极简总结（JSON字符串）
meetingMinutesJsonstring会议纪要（可能为null）
bantRawstringBANT销售分析（可能为null）
competitorSwotRawstringSWOT分析（可能为null）
actionItemsRawstring待办事项（JSON字符串）
speakerNamesJsonstring说话人名称映射（可能为null）
dialogExcerptsJsonstring对话节选（JSON字符串）
highlightDialogueJsonstring高光对话（JSON字符串）
speechDurationJsonstring说话人时长占比（JSON字符串）
emotionCurveJsonstring客户情绪曲线（JSON字符串）
detailsSupplementJsonstring详情补充（JSON字符串）
analysisDimensionJsonstring结构化评分数据（JSON字符串）
communicationBackgroundJsonstring沟通背景（JSON字符串）
smartBoardJsonstring智能白板统计数据（JSON字符串）
goalAndTopicTextstring会议目标与主题（纯文本）
scenarioAndRequirementsTextstring场景与需求描述（纯文本）
  • 标题从 summaryJson.title 取值，描述从 summaryJson.summary 取值
More in Data & APIs