思必驰办公产品skill#

重要说明（授权方式）#

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

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

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

json

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

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

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

json

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

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

json

// ~/.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 是否与所给的一致，避免后续无法调用接口

1. 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