What makes 话袋笔记 Skill notable?

1K downloads. Trust evidence available

How should 话袋笔记 Skill be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

话袋笔记 Skill

话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Skill: 话袋笔记 Skill Owner: monkeydb Summary: 话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-07-13T04:23:22.704Z | user **v1.1.0 update summary:** Skill name, documentation, and structure h

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

1.0.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/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 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.1release · observed Jul 13, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17bzjcpm1anady2ttcx59s195858va5:hd-notes-skills

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
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-monkeydb-hd-notes-skills/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

39,856 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: hd-notes-skills
description: |
  话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。

  当以下情况时使用此 Skill：
  (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」
  (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」
  (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」
  (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」
  (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」
version: 1.1.0
homepage: https://clawhub.ai/monkeydb/hd-notes-skills
user-invocable: true
metadata:
  openclaw:
    emoji: "📝"
    primaryEnv: HUADAI_API_KEY
    requires:
      env:
        - HUADAI_API_KEY
    envVars:
      - name: HUADAI_API_KEY
        required: true
        description: 话袋开放平台 API Key（请求头 Authorization）
    baseUrl: "https://openapi.ihuadai.cn/open/api/v1"
    homepage: "https://clawhub.ai/monkeydb/hd-notes-skills"
    repository: "https://github.com/monkeyDB/hd-notes-skills"
---

# 话袋笔记 Skill

## Agent 必读约束

- **唯一 Base URL**：`https://openapi.ihuadai.cn/open/api/v1`。禁止使用其他域名，禁止重复拼接 `/open/api/v1`。
- **鉴权方式**：业务 API 仅使用请求头 `Authorization: <HUADAI_API_KEY>`。
- **API Key 来源**：用户需先在 [话袋开放平台](https://ihuadai.cn/desktop/openai) 创建 API Key。如果用户未配置，引导用户创建并配置 `HUADAI_API_KEY`。
- **数据真实性**：所有笔记内容、搜索结果、笔记 ID 都必须来自 API 响应。禁止编造「已保存」「已找到」「已更新」。
- **写操作确认**：只有 API 返回 `code=200` 后，才能回复用户已保存或已更新。
- **更新笔记约束**：`unique_id` 必须来自搜索结果或用户明确提供，禁止猜测或生成已有笔记 ID。
- **密钥安全**：不要在对话中要求用户粘贴 API Key，不要回显、记录、总结或展示 `HUADAI_API_KEY`。

## 快速开始：配置 API Key

如果还没有配置 `HUADAI_API_KEY`，引导用户：

- 打开 https://ihuadai.cn/desktop/openai 创建 API Key
- 设置环境变量：`export HUADAI_API_KEY=<你的Key>`

## 文档索引

| 文档 | 内容 | 何时读取 |
|------|------|----------|
| [API 参考](references/api.md) | 完整请求体、curl 示例、响应判断、错误码 | 需要构造 API 调用或处理错误时 |

## 指令路由表

| 指令 | 角色 | 说明 | 详细文档 |
|------|------|------|----------|
| `/huadai config` 或「配置话袋」 | 配置 | 引导用户到开放平台创建并配置 API Key | [API 参考](references/api.md) |
| `/huadai upload` 或「记一下/保存」 | 新建 | 新建 Block 笔记 | [API 参考](references/api.md#新建笔记) |
| `/huadai update` 或「更新笔记」 | 更新 | 搜索确认目标后更新 Block 内容 | [API 参考](references/api.md#更新笔记) |
| `/huadai search` 或「搜一下」 | 搜索 | 关键词检索笔记 | [API 参考](references/api.md#搜索笔记) |

## 自然语言路由

| 用户说法（示例） | 路由 | 执行方式 |
|------------------|------|----------|
| 「授权话袋」「连接话袋笔记」「配置话袋」「怎么填 Key」 | Config | 不调用业务 API，引导配置 `HUADAI_API_KEY` |
| 「新建/上传/保存/写入到笔记」「记一下」 | Upload | `POST /block/upload-block` |
| 「更新/修改笔记」「补充到这条」 | Update | 先确认 `unique_id`，再 `POST /block/update-block` |
| 「搜/找/检索/有哪些相关笔记」 | Search | `GET /search` |

## API 路由表

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/search` | 关键词搜索笔记 |
| GET | `/block/:unique_id` | 获取单条笔记详情 |
| POST | `/block/upload-block` | 新建笔记 |
| POST | `/block/update-block` | 更新笔记 |

完整 URL 等于 Base URL + 路径。例如：`https://openapi.ihuadai.cn/open/api/v1/search`。

## 执行规则

### 搜索笔记

- 调用 `GET /search?query=<关键词>&page=1&size=10`。
- 无结果时明确回复「未找到」，不要编造类似笔记。
- 从响应中提取关键信息展示给用户：
  - `unique_id` — 笔记唯一标识（更新/查详情时需要）
  - `content` — Quill Delta 数组，提取 `insert` 字段拼接为纯文本摘要
  - `create_time` / `update_time` — Unix 时间戳，可转为可读时间
  - `type` — 笔记类型
- 展示结果时优先给标题/摘要/`unique_id`，方便用户选择要更新哪条。
- 如果结果超过一页（`total > size`），提示用户缩小搜索范围或翻页。

### 获取笔记

README.md

# 话袋笔记 Skill

话袋笔记 Skill 是话袋面向通用 Agent 的笔记能力扩展，支持通过自然语言新建、更新和搜索个人笔记。它采用 `SKILL.md` + `references/` + `scripts/` 的标准 Skill 结构，可发布到 ClawHub、SkillHub 等 Skill 市场，也可被支持 Skill 目录的 Agent 环境安装使用。

## 核心能力

| 能力 | 说明 |
|------|------|
| 新建笔记 | 用一句话快速记录想法、会议结论、灵感和待整理内容 |
| 搜索笔记 | 用关键词找回之前记录的内容 |
| 更新笔记 | 基于搜索结果确认 `unique_id` 后，补充或修改已有笔记 |

## 安装

### 让 AI 助手安装（推荐）

在 AI 助手中输入以下指令即可安装：

**直接安装ClawHub地址：**
```text
请安装话袋笔记 Skill，地址：https://clawhub.ai/monkeydb/hd-notes-skills
```

**Claude Code / Cursor / Codex / OpenClaw / 其他通用 Agent：**
```text
请安装话袋笔记 Skill，地址：https://github.com/monkeyDB/hd-notes-skills
```

如果 ClawHub 不可用，也可以直接从 GitHub 安装：
```text
请安装话袋笔记 Skill，地址：https://raw.githubusercontent.com/monkeyDB/hd-notes-skills/main/SKILL.md
```

### 手动安装

将本仓库作为一个 Skill 目录放到你的 Agent 支持的 Skill 目录中。常见形式如下，实际路径以对应 Agent 文档为准：

```bash
git clone https://github.com/monkeyDB/hd-notes-skills.git
```

安装后，确保 Agent 能读取仓库根目录的 `SKILL.md`、`references/api.md` 和 `scripts/` 目录。

## 配置

1. 打开 [话袋开放平台](https://ihuadai.cn/desktop/openai)
2. 创建 API Key
3. 在 Agent 运行环境中配置环境变量：

```bash
export HUADAI_API_KEY=<你的API Key>
```

**Claude Code 用户** 也可以在 `~/.bashrc` 或 `~/.zshrc` 中设置：

```bash
echo 'export HUADAI_API_KEY=<你的API Key>' >> ~/.zshrc
source ~/.zshrc
```

调用 OpenAPI 时，Skill 会通过请求头传递：

```http
Authorization: <HUADAI_API_KEY>
```

> ⚠️ 不要在聊天中粘贴、展示或保存 API Key。

## 使用示例

### 记录想法

```text
记一下：以后可以试试每天早起 30 分钟看书，提高专注力。
```

### 记录会议结论

```text
帮我记一下今天的结论：
1. 本周先完成首页改版的基础功能
2. 登录问题优先修复，明天前给出方案
3. 下周一安排前后端联调
```

### 查找历史笔记

```text
帮我找一下之前记的「早起看书」相关内容。
```

### 更新笔记

```text
把刚才找到的早起看书那条补充一句：先从每周三天开始，不追求每天都做。
```

## API

Base URL：

```text
https://openapi.ihuadai.cn/open/api/v1
```

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/search` | 搜索笔记 |
| GET | `/block/:unique_id` | 获取笔记详情 |
| POST | `/block/upload-block` | 新建笔记 |
| POST | `/block/update-block` | 更新笔记 |

请求体、curl 示例和错误码见 [references/api.md](references/api.md)。

## 兼容平台

| 平台 | 状态 | 说明 |
|------|------|------|
| Claude Code | ✅ | 支持 SKILL.md 目录格式 |
| Cursor | ✅ | 支持 Skill 安装 |
| Codex (OpenAI) | ✅ | 通过 OpenClaw 兼容 |
| OpenClaw | ✅ | 原生支持，含 metadata.openclaw 配置 |
| 任意 Skill 目录 Agent | ✅ | 标准 SKILL.md + references/ + scripts/ 格式 |

## 安全边界

- API Key 只用于请求头 `Authorization`。
- 未配置 API Key 时，Skill 只引导用户到话袋开放平台创建并配置 API Key。
- 写操作必须以 API 返回 `code=200` 为准。
- 搜索为空时必须明确说明未找到，禁止编造结果。
- 更新笔记时，`unique_id` 必须来自搜索结果或用户明确提供。

## 相关链接

- [GitHub地址](https://github.com/monkeyDB/hd-notes-skills)
- [ClawHub商店地址](https://clawhub.ai/monkeydb/hd-notes-skills)
- [话袋开放平台](https://ihuadai.cn/desktop/openai)
- [话袋官网](https://ihuadai.cn)

## License

MIT-0

_meta.json

{
  "ownerId": "kn7emwh7zk4apdw4p85qfe6xy9859xvm",
  "slug": "hd-notes-skills",
  "version": "1.0.1",
  "publishedAt": 1783916602704
}

references/api.md

# API 参考

**Base URL**：`https://openapi.ihuadai.cn/open/api/v1`
**鉴权**：请求头 `Authorization: <HUADAI_API_KEY>`

所有业务 API 都返回统一 JSON。成功以 `code=200` 为准。

## 搜索笔记

```http
GET https://openapi.ihuadai.cn/open/api/v1/search?query={关键词}&page=1&size=10
Authorization: <HUADAI_API_KEY>
```

curl 示例：

```bash
curl -sS -G "https://openapi.ihuadai.cn/open/api/v1/search" \
  --data-urlencode "query=早起看书" \
  --data-urlencode "page=1" \
  --data-urlencode "size=10" \
  -H "Authorization: $HUADAI_API_KEY"
```

### 搜索响应结构

成功时返回 `code=200`，核心数据在 `data` 字段中：

```json
{
  "code": 200,
  "data": {
    "total": 5,
    "page": 1,
    "size": 10,
    "data": [
      {
        "unique_id": "b_1730000000_a1b2c3d4",
        "type": 1,
        "content": [{ "insert": "笔记正文内容..." }],
        "create_time": 1720000000,
        "update_time": 1720086400,
        "is_collect": 0,
        "is_todo": 0,
        "status": 1
      }
    ]
  }
}
```

**关键字段说明**：

| 字段 | 类型 | 说明 |
|------|------|------|
| `total` | int | 匹配总数 |
| `data[].unique_id` | string | 笔记唯一标识，用于更新和查详情 |
| `data[].type` | int | 笔记类型：1=文本、2=图片、3=语音、4=视频 |
| `data[].content` | array | Quill Delta ops 数组，从中提取 `insert` 拼接为文本摘要 |
| `data[].create_time` | int | Unix 秒时间戳 |
| `data[].update_time` | int | 最后更新时间（Unix 秒） |
| `data[].status` | int | 状态：1=正常 |

**提取内容摘要**：`content` 是 Quill Delta 数组，遍历每个 op，取 `insert` 字段拼接即可得到纯文本。

执行要求：

- 无结果时明确回复「未找到」。
- 更新笔记前，优先通过搜索结果确认目标 `unique_id`。
- 不要猜测或生成已有笔记的 `unique_id`。

## 获取笔记详情

```http
GET https://openapi.ihuadai.cn/open/api/v1/block/{unique_id}
Authorization: <HUADAI_API_KEY>
```

curl 示例：

```bash
curl -sS "https://openapi.ihuadai.cn/open/api/v1/block/b_1730000000_a1b2c3d4" \
  -H "Authorization: $HUADAI_API_KEY"
```

返回单条笔记的完整信息，包括 `content`、`attachment`、`children`（追记/子笔记）等字段。

执行要求：

- 在用户明确要求查看某条笔记详情，或更新前需要确认完整内容时调用。
- `unique_id` 必须来自搜索结果或用户明确提供。

## 新建笔记

```http
POST https://openapi.ihuadai.cn/open/api/v1/block/upload-block
Authorization: <HUADAI_API_KEY>
Content-Type: application/json
```

推荐请求体。`content` 可以直接传 Markdown 字符串：

```json
{
  "unique_id": "b_1730000000_a1b2c3d4",
  "type": 1,
  "content": "正文\n",
  "create_time": 1717142400,
  "status": 1,
  "is_collect": 0,
  "is_todo": 0
}
```

兼容请求体。`content` 也可以传 Quill Delta ops：

```json
{
  "unique_id": "b_1730000000_a1b2c3d4",
  "type": 1,
  "content": [
    {
      "insert": "正文\n"
    }
  ],
  "create_time": 1717142400,
  "status": 1
}
```

curl 示例：

```bash
curl -sS -X POST "https://openapi.ihuadai.cn/open/api/v1/block/upload-block" \
  -H "Authorization: $HUADAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"unique_id":"b_1730000000_a1b2c3d4","type":1,"content":"正文\n","create_time":1717142400,"status":1,"is_collect":0,"is_todo":0}'
```

执行要求：

- `unique_id` 必须是新生成的笔记 ID。
- 普通文本笔记使用 `type=1`。
- `create_time` 使用当前 Unix 秒。
- 只有响应 `code=200` 后，才能回复「已保存」。

## 更新笔记

```http
POST https://openapi.ihuadai.cn/open/api/v1/block/update-block
Authorization: <HUADAI_API_KEY>
Content-Type: application/json
```

skill-card.md

## Description:

话袋笔记 Skill helps agents create, update, and search personal notes through the Huadai OpenAPI.

This skill is ready for commercial/non-commercial use.

## Publisher:

[monkeydb](https://clawhub.ai/user/monkeydb)

### License/Terms of Use:

MIT-0

## Use Case:

External users and agent developers use this skill to connect a compatible agent to Huadai Notes so it can save new notes, search existing notes, and update confirmed notes through the Huadai OpenAPI.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Helper scripts may execute unintended local code when handling note identifiers.

Mitigation: Review before installing and avoid arbitrary or externally supplied note IDs until upload.sh and update.sh serialize unique_id safely.

Risk: The Huadai API key can be sent to an overridden endpoint if HUADAI_BASE_URL points away from Huadai.

Mitigation: Use only a Huadai API key you are comfortable exposing to this skill and do not set HUADAI_BASE_URL to a non-Huadai host.

## Reference(s):

- [API Reference](references/api.md)
- [ClawHub Skill Page](https://clawhub.ai/monkeydb/skills/hd-notes-skills)
- [ClawHub Marketplace Page](https://clawhub.ai/monkeydb/hd-notes-skills)
- [Huadai Open Platform](https://ihuadai.cn/desktop/openai)
- [Huadai OpenAPI Base URL](https://openapi.ihuadai.cn/open/api/v1)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown and plain text guidance with shell commands and API response summaries]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires HUADAI_API_KEY for authenticated Huadai OpenAPI calls.]

## Skill Version(s):

1.0.1 (source: server release metadata; artifact frontmatter and package metadata report 1.1.0)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 2d 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.