aispeech_ainote

核心功能

aispeech_ainote 是思必驰官方提供的 OpenClaw Skill，专为思必驰 AI 办公本（Air/X5/Pro/Turbo 等型号）及录音卡（TalkNote、4G 录音卡等）用户打造。该 Skill 打通硬件设备与 OpenClaw 智能体的连接，使用户能够在统一对话界面中完成以下核心操作：

笔记与会议管理

• 查询笔记列表与详情：支持按条件检索会议记录、语音转写笔记，查看完整内容
• 笔记分组管理：创建、移动、删除笔记分组，实现结构化归档
• 删除笔记：支持将笔记移入回收站

待办事项全生命周期

• 支持待办的增删改查，包含标题、描述、起止时间、重复规则等完整字段
• 毫秒级时间戳处理，适配移动端与 Web 端同步需求

标签知识库与语义检索

• 个人标签知识库：自定义标签体系，构建专属知识网络
• 智能绑定：将笔记、待办关联至标签知识库，实现内容聚类
• 语义搜索：基于个人数据库的笔记/待办全文检索，快速定位信息

热词定制

• 针对语音识别场景，支持添加、修改、删除个性化热词，提升专业术语识别准确率

显著优势

1. 官方原生集成：思必驰自主研发，API 稳定性与功能迭代有保障
2. 多设备统一：覆盖办公本全系列及录音卡产品线，跨设备数据互通
3. 细粒度权限控制：基于 OAuth2 Scope 机制（NOTE_READ/WRITE、TODO_READ/WRITE 等），最小权限原则
4. 知识库闭环：从记录→标签归类→语义检索形成完整知识管理链路

局限性与注意事项

• 授权依赖：必须配置 AIWORK_AUTH_TOKEN，首次使用需手动编辑配置文件
• 环境变量限制：Skill 运行时需读取本地配置文件注入环境变量，容器化部署需额外处理
• 限流机制：用户维度存在请求限流（错误码 202405），高并发场景可能触发
• Scope 缺失风险：若授权凭证缺少特定 Scope，对应功能将不可用（错误码 202404）

适用人群

• 思必驰 AI 办公本/录音卡深度用户
• 需要语音转写+智能任务管理+知识沉淀的商务人士、会议助理、律师、记者等
• 企业内已通过思必驰开放平台完成授权配置的组织

常规风险提示

• 授权凭证安全：AIWORK_AUTH_TOKEN 存储于本地明文 JSON 文件，需确保文件权限控制（建议 600）
• 令牌刷新：官方错误码 202401/202402/202403 均指向授权失效，需引导用户至开放平台重新授权，Skill 自身不处理 Token 刷新
• 数据边界：当前仅支持操作个人数据，暂无企业空间/团队协作能力
• 热词长度限制：标签及热词字段存在长度校验（≤20 字符），超长内容将被截断或拒绝

核心用法

aispeech_ainote 是思必驰专为 OpenClaw 平台打造的官方 Skill，旨在打通思必驰办公硬件（AI 办公本 Air/X5/Pro/Turbo 系列、TalkNote 录音卡等）与智能 Agent 的数据通道。用户可通过自然语言指令完成以下操作：

笔记管理：查询会议记录列表与详情、删除笔记至回收站、创建与移动笔记分组；待办管理：全生命周期操作（创建、更新、删除、查询），支持毫秒级时间戳设置与重复任务配置；标签知识库：同步个人标签体系、查询笔记/待办标签、建立标签与内容的关联绑定；智能搜索：基于个人数据库对笔记和待办进行语义检索；热词管理：自定义语音识别热词库，提升专业术语转写准确率。

所有接口通过 Authorization: Bearer ${AIWORK_AUTH_TOKEN} 鉴权，需在 ~/.aispeech/aitablet.json 配置文件中预设环境变量。

显著优点

1. 硬件生态深度整合：直接对接思必驰自研办公本与录音卡，实现语音转写、手写笔记、待办提醒等原生能力的 AI 增强
2. 企业级权限管控：细粒度 Scope 设计（NOTE_READ/WRITE、TODO_READ/WRITE、LABEL_READ/WRITE 等），支持最小权限原则
3. 数据安全合规：全链路 HTTPS 加密传输，Token 本地存储不上云，符合企业数据主权要求
4. 智能标签体系：支持标签知识库的增量同步与复用机制，避免同名标签身份漂移
5. 中文办公场景优化：热词库针对中文会议场景设计，专业术语识别准确率显著提升

潜在缺点与局限性

1. 硬件绑定门槛：需拥有思必驰办公本或录音卡硬件设备，且需完成开放平台授权流程，初期配置复杂度较高
2. 地域与网络依赖：API 服务托管于 aiworks.cn，海外访问可能存在延迟，需稳定网络环境
3. 功能边界明确：仅支持思必驰生态内数据管理，无法直接对接 Notion、飞书、钉钉等第三方办公平台
4. 实时性限制：个人数据库搜索为异步索引机制，极端情况下存在秒级延迟
5. Token 有效期管理：授权凭证需定期刷新，过期后需重新配置环境变量

适合的目标群体

• 思必驰硬件用户：已购买 AI 办公本、录音卡的企业高管、律师、记者、研究员等高频会议记录人群
• 知识管理重度用户：依赖语音转写+手写笔记双模记录，需要 AI 辅助整理归档的专业人士
• 企业 IT 管理员：希望统一管控办公数据权限、部署私有化知识库检索的企业数字化团队
• 效率工具极客：追求「语音输入→AI 整理→待办追踪」闭环工作流的效率提升追求者

使用风险

配置风险：AIWORK_AUTH_TOKEN 若配置错误将导致全接口 401 失效，需重点核对配置文件格式；限流风险：高频调用可能触发 202405 错误码，建议合理控制查询频次；数据误删风险：笔记删除为「入回收站」软删除，分组删除同理，但待办删除为硬删除，操作前需确认意图；Token 泄露风险：本地配置文件需设置适当权限（建议 600），避免多用户共享设备时泄露；API 域名劫持风险：若手动修改 AIWORK_BASE_URL，需确认域名真实性，防止中间人攻击。