思必驰办公产品skill

重要说明（授权方式）

1. authToken（对应 env 为 AIWORK_AUTH_TOKEN）是访问业务接口的必需授权凭证。
2. 为避免网关或主机重启后丢失 authToken，首次安装时，必须把 authToken 持久化到 OpenClaw 全局运行时 dotenv 文件（路径~/.openclaw/.env，不存在则新建）：

# ~/.openclaw/.env
AIWORK_AUTH_TOKEN=你的授权凭证
AIWORK_BASE_URL=https://aiworks.cn

3. OpenClaw 运行时按“已有进程环境变量优先、dotenv 兜底”的方式加载环境变量，不要只把 authToken 写到工作区 .env、临时 shell或其他业务私有文件中；这些位置不是本技能的权威凭证来源，容易在重启、服务化运行或工作目录变化后失效。
4. 如需在 ~/.openclaw/openclaw.json 中显式声明本技能，可只声明技能启用与主凭证来源，authToken 仍放在 ~/.openclaw/.env：

{
  "skills": {
    "entries": {
      "aispeech_ainote": {
        "enabled": true,
        "apiKey": {
          "source": "env",
          "provider": "default",
          "id": "AIWORK_AUTH_TOKEN"
        }
      }
    }
  }
}

5. 添加或更新完成后，核对 AIWORK_AUTH_TOKEN 是否与开放平台下发的 authToken 一致，避免后续接口调用返回授权错误。
6. Skill 运行时只消费 OpenClaw 已注入的环境变量，使用已有 authToken 调用业务接口：
   • Authorization: Bearer ${AIWORK_AUTH_TOKEN}

快速决策

Base URL: ${AIWORK_BASE_URL:-https://aiworks.cn}
Prefix: /aitablet/api/skill/v2

用户意图	接口	必需 Scope
查笔记（会议、记录）列表	GET /note/list	NOTE_READ
查笔记（会议、记录）元信息	GET /note/{noteUid}?includeContent=false	NOTE_READ
查纪要/摘要	GET /note/{noteUid}/content?type=summary	NOTE_READ
按需查原文/OCR/洞察	`GET /note/{noteUid}/content?type=asr	ocr
查待办列表	GET /todo/list	TODO_READ
新建待办	POST /todo	TODO_WRITE
更新待办	PUT /todo/{todoUid}	TODO_WRITE
删除待办	DELETE /todo/{todoUid}	TODO_WRITE
查用户标签知识库	GET /label/knowledge/user	LABEL_READ
同步用户标签知识库	POST /label/knowledge/user/sync	LABEL_WRITE
查笔记标签	GET /label/knowledge/note	LABEL_READ
查待办标签	GET /label/knowledge/todo	LABEL_READ
搜索笔记个人数据库	POST /database/note/search	KNOWLEDGE_READ
搜索待办个人数据库	POST /database/todo/search	KNOWLEDGE_READ
查询热词词库	GET /hotword/content	HOTWORD_READ
新增热词	POST /hotword/add	HOTWORD_WRITE
删除热词	DELETE /hotword/delete	HOTWORD_WRITE
修改热词	PUT /hotword/update	HOTWORD_WRITE
标签关联查询	GET /label/knowledge/relations	LABEL_READ
绑定笔记到标签知识库	POST /label/knowledge/note/bind	LABEL_WRITE
绑定待办到标签知识库	POST /label/knowledge/todo/bind	LABEL_WRITE
删除笔记（入回收站）	DELETE /note/{noteUid}	NOTE_WRITE
新建笔记分组	POST /note/group/create	NOTE_WRITE
移动笔记分组	PUT /note/group/move	NOTE_WRITE
删除笔记分组（入回收站）	DELETE /note/group/{groupUid}	NOTE_WRITE

参数与返回约定

• 统一响应：{ code, message, data }
• 成功 code 为字符串 "0"
• 查询笔记详情时必须优先使用 includeContent=false 获取标题、时间、标签、分组等元信息。
• 不要调用不带 includeContent=false 的 /note/{noteUid} 作为默认详情接口；该接口默认会返回 ASR、摘要、AI 洞察和 OCR，容易造成大段上下文进入模型。
• 内容接口一次只取一个 type，按用户问题逐步补充，不要为了“备用”预取多种正文。

笔记内容按需获取策略

1. 用户只问标题、时间、分组、标签、置顶、版本、是否加密等基础信息：只调用 /note/{noteUid}?includeContent=false。
2. 用户问笔记正文、会议结论、会议内容、摘要、总结、讨论事项时：先调用 /note/{noteUid}/content?type=summary。
3. summary 能回答问题时，直接基于摘要作答，不再获取 asr、ocr 或 insight。
4. 只有在摘要为空、过短、与问题不匹配，或回答必须引用更细粒度证据时，才追加调用一个最相关的内容类型：
   • type=asr：用户明确要原文、逐字稿、录音转写、发言细节、完整会议过程。
   • type=ocr：用户问手写内容、图片/页面识别内容、白板或页面上的文字。
   • type=insight：用户问 AI 洞察、行动项、风险、待办建议或扩展分析。
5. 除非用户明确要求“完整原文”“全部内容”“把 OCR/原文/摘要都给我”，否则禁止一次性拉取 asr、ocr、insight 多种内容。

易错点

todo 写接口

• beginTime/endTime/repeatEndTime：毫秒时间戳
• V2 标准字段使用 description 表示待办描述

label 写接口

• 笔记标签查询：labelList[].labels[] 会返回 uid
• 用户标签全量同步时，服务端会按 labelName 复用历史 uid，避免同名标签重同步后身份漂移
• 校验：labels 每个元素长度 <= 20

错误处理建议

• 202401/202402/202403：先检查运行时 AIWORK_AUTH_TOKEN 是否为空或与 ~/.openclaw/.env 不一致，检查后使用正确 token 重试；如果还是失败，则提示用户去开放平台刷新/重装授权（Skill 内不自行创建 token）
• 202404：提示用户在开放平台补齐所需 scope
• 202405：表示触发 userId 维度限流，提示稍后重试

参考

• API 文档：api_reference.md
• 细节补充：references/api-details.md