技能介绍

要解决什么问题

会议录音、手写页和日常记录往往落在思必驰 AI Works（aiworks.cn） 里：笔记有分组和标签，正文可能是 ASR 转写、OCR 识别或 AI 摘要/洞察，待办还有独立列表与个人知识库检索。若让大模型直接「拉全量详情」，默认的 GET /note/{noteUid} 会把 ASR、摘要、洞察和 OCR 一并塞进上下文，既慢又容易撑爆 token。

本技能把 Agent 约束在 OpenClaw 已注入的环境变量 与 v2 Skill API 上，用 Authorization: Bearer ${AIWORK_AUTH_TOKEN} 访问业务接口，并按用户意图选接口与 scope。

核心能力与调用方式

笔记：GET /note/list 列会议/记录；元信息用 GET /note/{noteUid}?includeContent=false（标题、时间、标签、分组等）；正文走 GET /note/{noteUid}/content，type 一次只取 summary、asr、ocr 或 insight 之一。
待办：GET /todo/list；新建/更新/删除对应 POST/PUT/DELETE /todo；写接口时间字段为毫秒时间戳，描述字段为 V2 的 description。
标签与知识库：用户标签 GET/POST .../label/knowledge/user（同步时服务端按 labelName 复用 uid）；笔记/待办标签查询与 bind；POST /database/note/search 与 POST /database/todo/search 搜个人库。
热词：GET /hotword/content 与增删改接口；需对应 HOTWORD_READ / HOTWORD_WRITE scope。

按需取正文是设计重点：只问元数据就只打 includeContent=false；问结论/纪要先 type=summary；摘要够用就不再拉 asr/ocr/insight；只有用户要逐字稿、手写识别或 AI 行动项等证据时，再追加一种最相关的 type。

边界与注意点

凭证：authToken 对应环境变量 AIWORK_AUTH_TOKEN，应持久化在 ~/.openclaw/.env（进程环境优先、dotenv 兜底），不要只写在工作区 .env 或临时 shell。
授权错误：202401/202402/202403 先核对 token 是否与开放平台一致并重试；仍失败则提示用户刷新授权（技能内不自行造 token）。202404 表示缺 scope，需在开放平台补齐。202405 为 userId 维度限流，稍后重试。
用户未明确要求「完整原文/全部内容」时，禁止一次性预取多种正文类型。