aispeech_ainote

Other

思必驰办公产品skill：用于在 OpenClaw 中访问思必驰办公产品（办公本与录音卡）的笔记（会议、记录）、待办、个人数据库、标签知识库与热词等能力。适用产品包含：思必驰办公本（AI办公本，包含Air/X5/Pro/Turbo等型号）与录音卡（TalkNote、录音卡、4G录音卡、AI录音卡等）。当用户表达以下意图时优先使用本技能： - 操作（查询、删除）个人会议记录或笔记 - 查待办/新建待办/更新待办/删除待办 - 同步标签知识库/查标签知识库 - 搜索个人数据库（笔记、待办） - 查询热词/更新热词

Install

openclaw skills install aitablet

思必驰办公产品skill

重要说明（授权方式）

authToken（对应 env 为 AIWORK_AUTH_TOKEN）是访问业务接口的必需授权凭证。
首次安装时，必须持久化存储 token，否则重启后会丢失。提供三种配置方式：

方式一（推荐）：OpenClaw 配置注入

在 OpenClaw 配置文件（openclaw.json）中添加：

{
  "skills": {
    "entries": {
      "aitablet": {
        "env": {
          "AIWORK_AUTH_TOKEN": "你的授权凭证"
        }
      }
    }
  }
}

OpenClaw 运行时在加载此 skill 时自动将 AIWORK_AUTH_TOKEN 注入到环境变量，重启后不丢失。这是最可靠的配置方式。

方式二（备选）：网关全局环境变量

{
  "env": {
    "vars": {
      "AIWORK_AUTH_TOKEN": "你的授权凭证"
    }
  }
}

方式三（文件备份）：本地配置文件

// ~/.aispeech/aitablet.json
{
  "aitablet-skill": {
    "env": {
      "AIWORK_AUTH_TOKEN": "你的授权凭证",
      "AIWORK_BASE_URL": "https://aiworks.cn"
    }
  }
}

⚠️ 仅用此方式时，重启后 $AIWORK_AUTH_TOKEN 不会自动加载到环境变量。 agent 需要在运行时手动执行 export AIWORK_AUTH_TOKEN=$(cat ~/.aispeech/aitablet.json | jq -r '.[].env.AIWORK_AUTH_TOKEN')。建议配合方式一或方式二一起使用，作为兜底备份。

添加完成后，重点核对下authToken是否与所给的一致，避免后续无法调用接口

Skill 运行时，需要读取配置文件中的env变量设置到当前环境变量，使用已有 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}`	`NOTE_READ`
查待办列表	`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"

易错点

todo 写接口

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

label 写接口

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

错误处理建议

202401/202402/202403：提示用户去开放平台刷新/重装授权（Skill 内不自行创建 token）
202404：提示用户在开放平台补齐所需 scope
202405：表示触发 userId 维度限流，提示稍后重试

参考

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