思必驰办公产品skill

重要说明（授权方式）

1. authToken（对应 env 为 AIWORK_AUTH_TOKEN）是访问业务接口的必需授权凭证。
2. 首次安装时，必须持久化存储 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是否与所给的一致，避免后续无法调用接口

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