AI办公本 Skill
重要说明(授权方式)
authToken(对应env为AIWORK_AUTH_TOKEN),是访问业务接口的必需授权凭证- 首次安装时,在
~/.openclaw/openclaw.json中添加:
{
"skills": {
"entries": {
"aitablet-skill-beta": {
"env": {
"AIWORK_AUTH_TOKEN": "你的授权凭证",
"AIWORK_BASE_URL": "https://beta.aiworks.cn"
}
}
}
}
}
- Skill 运行时仅使用已有
authToken调用业务接口:Authorization: Bearer ${AIWORK_AUTH_TOKEN}
快速决策
Base URL: ${AIWORK_BASE_URL:-https://beta.aiworks.cn}
Prefix: /aitablet/api/skill/v1
| 用户意图 | 接口 | 必需 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/user |
LABEL_READ |
| 同步用户标签 | POST /label/user/sync |
LABEL_WRITE |
| 查笔记标签 | GET /label/note |
LABEL_READ |
| 同步笔记标签 | POST /label/note/sync |
LABEL_WRITE |
| 搜索笔记知识库 | POST /knowledge/note/search |
KNOWLEDGE_READ |
| 搜索待办知识库 | POST /knowledge/todo/search |
KNOWLEDGE_READ |
参数与返回约定
- 统一响应:
{ code, message, data } - 成功
code为字符串"0"
易错点
todo 写接口
beginTime/endTime/repeatEndTime:毫秒时间戳notifyAhead最大长度 10repeat最大长度 40groupUid最大长度 45
label 写接口
- 用户标签同步:
{ "labels": ["..."] } - 笔记标签同步:
{ "noteUid": "...", "labels": ["..."] } - 校验:
labels每个元素长度 <= 20
错误处理建议
202401/202402/202403:提示用户去开放平台刷新/重装授权(Skill 内不自行创建 token)202404:提示用户在开放平台补齐所需 scope
参考
- API 文档:
api_reference.md - 细节补充:
references/api-details.md
