Xpersona
agentCLAWHUBUnverified

aispeech_ainote

思必驰办公产品skill：用于在 OpenClaw 中访问思必驰办公产品（办公本与录音卡）的笔记（会议、记录）、待办、个人数据库、标签知识库与热词等能力。 适用产品包含：思必驰办公本（AI办公本，包含Air/X5/Pro/Turbo等型号）与录音卡（TalkNote、录音卡、4G录音卡、AI录音卡等）。 当用户表... Skill: aispeech_ainote Owner: fairylong Summary: 思必驰办公产品skill：用于在 OpenClaw 中访问思必驰办公产品（办公本与录音卡）的笔记（会议、记录）、待办、个人数据库、标签知识库与热词等能力。 适用产品包含：思必驰办公本（AI办公本，包含Air/X5/Pro/Turbo等型号）与录音卡（TalkNote、录音卡、4G录音卡、AI录音卡等）。 当用户表... Tags: latest:1.0.9 Version history: v1.0.9 | 2026-05-19T04:01:52.296Z | user - Improved and expanded documentation on token管理方式 and自动恢复方法, including recommended ways to persist AIWORK_AUTH_TOKEN. - Added clear

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

2.3k

Updated

Oct 9, 2026

Version

1.0.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.3K downloads reported by the source. Last updated 10/9/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
2.3K downloadsadoption · observed Oct 9, 2026
Latest release
1.0.9release · observed May 19, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17fvcax8kbxb0jaaqtze4fhsn83gxax:aitablet
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fairylong-aitablet/snapshot"

Documentation

CLAWHUB

90,608 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: aispeech_ainote
slug: aitablet
description:
  思必驰办公产品skill：用于在 OpenClaw 中访问思必驰办公产品（办公本与录音卡）的笔记（会议、记录）、待办、个人数据库、标签知识库与热词等能力。
  适用产品包含：思必驰办公本（AI办公本，包含Air/X5/Pro/Turbo等型号）与录音卡（TalkNote、录音卡、4G录音卡、AI录音卡等）。
  当用户表达以下意图时优先使用本技能：
  - 操作（查询、删除）个人会议记录或笔记
  - 查待办/新建待办/更新待办/删除待办
  - 同步标签知识库/查标签知识库
  - 搜索个人数据库（笔记、待办）
  - 查询热词/更新热词
metadata:
  openclaw:
    baseUrl: "${AIWORK_BASE_URL:-https://aiworks.cn}"
    requires:
      env: ["AIWORK_AUTH_TOKEN"]
    optionalEnv: ["AIWORK_BASE_URL"]
    tokenManagement:
      source: "思必驰开放平台应用管理"
      lifecycle: "长期有效，无过期时间。安装时配置，平台需持久化存储"
      problem: "安装后首次执行有效，但平台重启/环境重置后 AIWORK_AUTH_TOKEN 丢失（仅配置在 ~/.aispeech/aitablet.json 时），导致后续调用返回 202401"
      requirement: "平台必须通过 OpenClaw 配置 skills.entries.<slug>.env.AIWORK_AUTH_TOKEN 持久化 token，确保重启后环境变量不丢失"
      configLocations:
        - path: "skills.entries.<slug>.env.AIWORK_AUTH_TOKEN"
          description: "推荐方式。OpenClaw 运行时自动注入到 skill 环境变量，重启后不丢失"
        - path: "env.vars.AIWORK_AUTH_TOKEN"
          description: "备选方式。注入到网关进程全局环境变量，所有 skill 可见"
        - path: "~/.aispeech/aitablet.json"
          description: "文件存储。agent 需手动读取并导出为环境变量，重启后不会自动加载"
      failureDetection:
        - code: 202401
          description: "授权凭证无效（token 为空或错误）"
        - code: 202402
          description: "授权已过期"
        - code: 202403
          description: "授权被撤销"
      autoRecovery:
        description: "检测到授权失效时，优先检查 AIWORK_AUTH_TOKEN 环境变量是否为空（常见原因）"
        steps:
          - step: 1
            action: "检测到 202401/202402/202403 错误码"
          - step: 2
            action: "检查 $AIWORK_AUTH_TOKEN 环境变量是否为空"
          - step: 3
            action: "如果为空，尝试从 ~/.aispeech/aitablet.json 读取 token 并导出到环境变量"
          - step: 4
            action: "重试请求，确认 token 是否真的失效"
---

# 思必驰办公产品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`是否与所给的一致，避免后续无法调用接口

3. Skill 运行时，需要读取配置文件中的env变量设置到当前环境变量，使用已有 `authToken` 调用业务接口：
   - `Authorization: Bearer ${AIWORK_AUTH_TOKEN}`

## 快速决策

Base URL: `${A

README.md

# AI办公本 Skill

AI办公本 Skill 用于在 OpenClaw 中访问 思必驰AI办公本能力：

- 笔记：列表、详情、删除
- 待办：增删改查
- 标签知识库：同步、查询、绑定
- 个人数据库检索：笔记/待办语义搜索

## 安装

将本目录作为 skill 包导入 OpenClaw，核心文件为 `SKILL.md`。

## 运行前准备

建议配置环境变量：

```bash
export AIWORK_BASE_URL="https://aiworks.cn"
```

## 认证说明

- `authToken`（`AIWORK_AUTH_TOKEN`） 在开放平台安装 Skill 时下发给 OpenClaw。
- 受保护接口统一 Header：
  - `Authorization: Bearer {AIWORK_AUTH_TOKEN}`

## 文档索引

- 完整 API：`api_reference.md`
- 技能说明：`SKILL.md`
- 细节补充：`references/api-details.md`

_meta.json

{
  "ownerId": "kn7crhg8kw6h79qcbjck68kq4582vde1",
  "slug": "aitablet",
  "version": "1.0.9",
  "publishedAt": 1779163312296
}

references/api-details.md

# API Details

## 1) 通用响应

```json
{
  "code": "0",
  "message": "success",
  "data": {}
}
```

- 成功：`code == "0"`
- 失败：`code != "0"`

## 2) 授权说明（Skill 运行时）

- Skill 运行时只消费已有 `AIWORK_AUTH_TOKEN`。
- token 在安装 Skill 时由平台下发给 OpenClaw。

## 3) 关键错误码

| code | message | 说明 |
|---|---|---|
| 202400 | Authorization token is required | 未传 Authorization |
| 202401 | Authorization token is invalid | token 无效 |
| 202402 | Authorization token has expired | token 过期 |
| 202403 | Authorization token is disabled | token 失效 |
| 202404 | Authorization scope is insufficient | scope 不匹配 |
| 202405 | Too many requests, please retry later | 触发 userId 维度限流 |
| 201600 | 参数非法 | 请求参数不合法 |
| 201602 | 记录不存在 | todo 不存在或无权限 |
| 201613 | 内部服务异常 | 服务内部异常 |

## 4) Scope 速查

| Scope | 能力 |
|---|---|
| NOTE_READ | 读笔记 |
| NOTE_WRITE | 写笔记 |
| TODO_READ | 读待办 |
| TODO_WRITE | 写待办 |
| LABEL_READ | 读标签 |
| LABEL_WRITE | 写标签 |
| KNOWLEDGE_READ | 知识库检索 |

## 5) 时间字段规范

- Todo 相关时间统一为 Unix 毫秒时间戳（`Long`）。
- `beginTime/endTime/repeatEndTime/syncTime/finishTime/createTime/updateTime` 均为毫秒格式。
- Todo V2 接口统一使用 `description` 表示待办描述，可存储待办详情、会议链接等信息。
- Todo V2 请求仍兼容历史字段 `label`，但新接入方应优先使用 `description`。

## 6) 校验规则

- `SkillLabelForm.labels`：每个元素长度 <= 20
- `SkillTodoForm.notifyAhead`：长度 <= 10
- `SkillTodoForm.repeat`：长度 <= 40
- `SkillTodoForm.groupUid`：长度 <= 45

## 7) 标签同步兼容说明

- 用户标签 V2 查询返回 `uid`、`name`、`source`，便于调用方直接复用标签唯一标识。
- 用户标签 / 笔记标签 V2 同步同时兼容字符串数组与对象数组。
- 对象数组支持 `uid`、`name`、`source`；其中 `uid` 可用于显式传递标签唯一标识。
- 若不存在同名旧标签，则以 `labelName` 作为兜底标识生成逻辑。
- 笔记标签 V2 查询会返回标签 `uid`；若历史数据中缺失 `uid`，服务端会按同名用户标签尝试补全。

## 8) 产品适配与知识库口径

- 本技能名称：`思必驰办公产品skill`。
- 适用产品：
  - 思必驰办公本（思必驰AI办公本、AI办公本、办公本、办公本Air/X5/Pro/Turbo 等）
  - 录音卡（TalkNote、录音卡、4G录音卡、AI录音卡 等）
- 个人知识库：用户全量个人内容范围。
- 标签知识库：按标签 `uid` 圈定的内容子集，支持笔记与待办双维关联。

api_reference.md

# 思必驰办公产品skill OpenClaw Skill API 参考文档

## 1. 概述

### 1.1 接口基础信息

| 项目 | 说明                                                 |
|---|----------------------------------------------------|
| 协议 | HTTP/HTTPS                                         |
| 统一前缀 | `/aitablet/api/skill/v2`                           |
| 数据格式 | `application/json; charset=UTF-8`                  |
| 鉴权方式 | `Authorization: Bearer {AIWORK_AUTH_TOKEN}`（受保护接口） |

### 1.2 通用响应结构

```json
{
  "code": "0",
  "message": "success",
  "data": {}
}
```

- `code`：`"0"` 表示成功，其他为业务错误码。
- `message`：错误或成功消息。
- `data`：返回数据，可能是对象、数组或 `null`。

### 1.3 授权与 Scope

当前系统使用以下 Scope（大写）：

- `NOTE_READ`
- `TODO_READ`
- `TODO_WRITE`
- `LABEL_READ`
- `LABEL_WRITE`
- `KNOWLEDGE_READ`
- `HOTWORD_READ`
- `HOTWORD_WRITE`
- `NOTE_WRITE`

> 说明：本文件为 Skill 运行时接口文档，不包含开放平台侧的授权管理接口。
> `AIWORK_AUTH_TOKEN` 由开放平台在安装 Skill 时下发给 OpenClaw，用户可在安装时选择 scope，并支持永久授权。

---

## 2. 笔记接口

> 需要 Scope：`NOTE_READ`

### 2.1 查询笔记列表

- **GET** `/aitablet/api/skill/v2/note/list`
- Header：`Authorization: Bearer {AIWORK_AUTH_TOKEN}`

查询参数：

| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageNum | Integer | 否 | 默认 1 |
| pageSize | Integer | 否 | 默认 10，范围 1~100 |
| orderBy | String | 否 | `createTime` / `updateTime` |
| startTime | String | 否 | 格式 `yyyy-MM-dd HH:mm:ss` |
| endTime | String | 否 | 格式 `yyyy-MM-dd HH:mm:ss` |
| keyword | String | 否 | 标题关键字 |

### 2.2 查询笔记详情

- **GET** `/aitablet/api/skill/v2/note/{noteUid}`
- Header：`Authorization: Bearer {AIWORK_AUTH_TOKEN}`

返回核心字段（`SkillNoteVO`）：

- `noteUid`, `title`, `createTime`, `updateTime`, `labels[{name,uid,type}]`
- `labelNames`, `type`, `groupName`, `group{name,uid}`, `version`, `top`, `encryptType`
- `asrContent`, `summaryContent`, `insightContent`, `ocrContent`

### 2.3 删除笔记（入回收站）

- **DELETE** `/aitablet/api/skill/v2/note/{noteUid}`
- Scope：`NOTE_WRITE`
- Header：`Authorization: Bearer {AIWORK_AUTH_TOKEN}`

---

## 3. 待办接口

### 3.1 查询待办列表

- **GET** `/aitablet/api/skill/v2/todo/list`
- Scope：`TODO_READ`
- Header：`Authorization: Bearer {AIWORK_AUTH_TOKEN}`

查询参数：

| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | Integer | 否 | `null`全部，`0`未完成，`1`已完成 |
| beginTime | Long | 否 | 开始时间（毫秒时间戳） |
| endTime | Long | 否 | 结束时间（毫秒时间戳） |
| pageNum | Integer | 否 | 页码 |
| pageSize | Integer | 否 | 每页大小 |


### 3.2 创建待办

- **POST** `/aitablet/api/skill/v2/todo`
- Scope：`TODO_WRITE`
- Header：`Authorization: Bearer {AIWORK_AUTH_TOKEN}`

请求体（`SkillTodoV2Form`）：

```json
{
  "todo": "完成周报",
  "beginTime": 1761922800000,
  "endTime": 1761926400000,
  "description": "可存放待办描述、会议链接等具体信息",
  "important": true,
  "done": false,
  "notifyAhead": "30m",
  "repeat": "weekly",
  "repeatEndTime": 1764601200000,
  "repeatCount": 10,
  "groupUid": "1000002643-DEFAULT"
}
```

字段说明：

- V2 标准字段为 `description`，语义是“待办描述”
- 请求体仍兼容历史字段 `label`，若同时传入则优先使用 `description`

字段校验：

- `notifyAhead` 最

Related agents

Same protocol, similar job.

Github ReposUpdated 6h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/fairylong/skills/aitablet",
      "sourceUrl": "https://clawhub.ai/fairylong/skills/aitablet",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T16:45:55.153Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fairylong-aitablet/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fairylong-aitablet/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T16:45:55.153Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "2.3K downloads",
      "href": "https://clawhub.ai/fairylong/aitablet",
      "sourceUrl": "https://clawhub.ai/fairylong/aitablet",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T16:45:55.153Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.9",
      "href": "https://clawhub.ai/fairylong/aitablet",
      "sourceUrl": "https://clawhub.ai/fairylong/aitablet",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-19T04:01:52.296Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fairylong-aitablet/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fairylong-aitablet/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.9",
      "description": "- Improved and expanded documentation on token管理方式 and自动恢复方法, including recommended ways to persist AIWORK_AUTH_TOKEN. - Added clear configuration examples for persistent token storage via OpenClaw, environment variables, and local files. - Detailed failure detection, token lifecycle, and troubleshooting steps to avoid lost authorization after platform restart. - No changes to skill code or APIs—documentation update only.",
      "href": "https://clawhub.ai/fairylong/aitablet",
      "sourceUrl": "https://clawhub.ai/fairylong/aitablet",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-19T04:01:52.296Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to aispeech_ainote and adjacent AI workflows.