核心用法
aispeech_ainote 是思必驰官方提供的 OpenClaw 技能，用于深度集成思必驰办公产品线（AI办公本 Air/X5/Pro/Turbo 及 TalkNote 系列录音卡）。通过标准化 REST API 暴露四大核心能力：
笔记管理：查询会议记录详情与列表、删除笔记、创建/移动/删除笔记分组，支持个人数据库搜索。
待办系统：完整的 CRUD 操作，时间字段采用毫秒时间戳，V2 版本使用 description 字段存储待办详情。
标签知识库：用户标签全量同步与查询、笔记/待办标签绑定、标签关联关系查询。服务端智能复用历史 UID 避免同名标签身份漂移。
热词管理：词库查询、新增、修改、删除热词，优化语音识别准确度。
所有接口需 Authorization: Bearer ${AIWORK_AUTH_TOKEN} 认证，支持 NOTE_READ/WRITE、TODO_READ/WRITE、LABEL_READ/WRITE、HOTWORD_READ/WRITE、KNOWLEDGE_READ 等细粒度 Scope 控制。
显著优点
- 官方原生：思必驰官方维护，API 稳定性与兼容性有保障
- 功能全面：覆盖笔记、待办、标签、热词四大办公场景，支持硬件设备全系列
- 权限精细：基于 Scope 的访问控制，可按需授权最小权限
- 标签智能：同名标签自动复用 UID，避免知识库混乱
- 持久化配置：支持 OpenClaw 配置注入，重启不丢 token
潜在缺点与局限性
- 授权复杂：必须手动配置
AIWORK_AUTH_TOKEN，且需持久化存储，配置不当易触发 202401 错误 - 无自动续期：token 长期有效但无过期机制，一旦泄露需人工撤销重装
- 限流约束：userId 维度存在 202405 限流，高频调用需容错处理
- 时间格式特殊：毫秒时间戳易与秒级时间混淆，待办写接口字段命名有版本差异
- 地域依赖：默认连接
aiworks.cn国内服务，海外网络需自定义AIWORK_BASE_URL
适合人群
已购买思必驰 AI 办公本或录音卡硬件的企业用户与个人效率追求者，特别是需要将会议记录、语音备忘与待办事项数字化管理的重度办公用户。适合具备基础运维能力、能完成 token 配置的技术使用者或团队管理员。
常规风险
- 凭证泄露：
AIWORK_AUTH_TOKEN泄露可导致全量办公数据被访问，需严格保管配置文件 - 配置丢失：仅使用文件备份方式（~/.aispeech/aitablet.json）时，重启后 token 未加载将导致服务中断
- 数据误删：笔记/待办/分组删除操作直接入回收站，无二次确认机制，需客户端层实现缓冲
- Scope 不足：调用前未申请对应权限将返回 202404，需在思必驰开放平台预配置
- 限流中断：突发高频查询可能触发 202405 限流，影响实时性体验