360 Secure SkillHub
360 安全技能中心

思必驰办公本助手(beta)

核心功能涵盖查看/管理笔记、待办事项,同步/查询标签,搜索知识库内容。典型场景为用户需访问或编辑AI办公本内的办公资料。输入为对应操作意图的指令,输出为结构化业务数据。需配置AIWORK_AUTH_TOKEN授权,根据操作调用对应接口,适配不同权限Scope。

fairylong
fairylong
热度 22.64
最近更新 2026-03-24 09:11:53
分类:效率依赖:第三方 API应用场景:任务管理 / 笔记整理

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add aitablet-skill-beta
Metadata
name
AI办公本
slug
aitablet-skill-beta
description
AI办公本 Skill:用于在 OpenClaw 中访问 AI 办公本的笔记、待办、标签与知识库检索能力。 当用户表达以下意图时使用本技能: - 查笔记/看笔记详情 - 查待办/新建待办/更新待办/删除待办 - 同步标签/查标签 - 搜索知识库(笔记、待办)
metadata
{"openclaw":{"baseUrl":"${AIWORK_BASE_URL:-https://beta.aiworks.cn}","requires":{"env":["AIWORK_AUTH_TOKEN"]},"optionalEnv":["AIWORK_BASE_URL"]}}

AI办公本 Skill

重要说明(授权方式)

  1. authToken(对应env为AIWORK_AUTH_TOKEN),是访问业务接口的必需授权凭证
  2. 首次安装时,在 ~/.openclaw/openclaw.json 中添加:
{
  "skills": {
    "entries": {
      "aitablet-skill-beta": {
        "env": {
          "AIWORK_AUTH_TOKEN": "你的授权凭证",
          "AIWORK_BASE_URL": "https://beta.aiworks.cn"
        }
      }
    }
  }
}
  1. 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 最大长度 10
  • repeat 最大长度 40
  • groupUid 最大长度 45

label 写接口

  • 用户标签同步:{ "labels": ["..."] }
  • 笔记标签同步:{ "noteUid": "...", "labels": ["..."] }
  • 校验:labels 每个元素长度 <= 20

错误处理建议

  • 202401/202402/202403:提示用户去开放平台刷新/重装授权(Skill 内不自行创建 token)
  • 202404:提示用户在开放平台补齐所需 scope

参考

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