话袋笔记 Skill

对接话袋笔记开放 API，提供新建、更新和全文搜索个人笔记的能力，并包含配置说明与 OAuth 设备码授权流程。所有笔记内容取自 API 响应，写操作需在返回成功后确认；未配置 Key 或未授权时停止调用并引导本地配置。附带授权轮询脚本与接口参考文档。

热度 54.99

最近更新 2026-07-13 12:23:22

分类：知识依赖：第三方 API / 代码执行 / 读写文件应用场景：笔记整理 / API 集成 / 工作流

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add hd-notes-skills

Metadata

name: 话袋笔记
description: 话袋笔记 - 新建、更新和搜索个人笔记。 **当以下情况时使用此 Skill**： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」「收藏」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「怎么填 Key」
metadata: {"openclaw":{"requires":{},"optionalEnv":["HUADAI_BASE_URL","HUADAI_API_KEY","HUADAI_CLIENT_ID"],"baseUrl":"https://openapi.ihuadai.cn/open/api/v1","homepage":"https://ihuadai.cn"}}

唯一 Base URL：https://openapi.ihuadai.cn/open/api/v1（禁止使用其他域名或自行拼接根域）
开放 API 文档：以话袋官方发布为准（此仓库以 references/ 内文档为最终对接依据）
鉴权与必需请求头：HUADAI_API_KEY（对应请求头 Authorization）
OAuth（设备码）：按 OAuth 授权配置执行；默认使用服务端预注册的固定 client_id，一般只需要配置 HUADAI_BASE_URL 即可走授权。仅在需要覆盖时才配置 HUADAI_CLIENT_ID。
调用前检查配置：若未配置 HUADAI_API_KEY（业务请求）或未配置 HUADAI_BASE_URL（走 OAuth 时），必须停止调用并引导用户在本地配置；禁止假装成功
数据真实性：所有笔记内容、列表、详情都必须来自 API 响应；禁止编造笔记、ID、space_id 等
空结果处理：API 返回为空/未找到时，必须明确告知“未找到”，并给出下一步（换关键词/缩小范围）
写操作确认：保存/更新等写操作，必须在 API 明确返回成功后再回复“已保存/已更新”

匹配指令或 API 后，用 read 工具读取下表对应 references/*.md 获取完整字段、示例与边界说明。错误码与统一响应见话袋笔记 API 详细参考。

说明：以下为 MVP 参考路径。Base URL 为 https://openapi.ihuadai.cn/open/api/v1（与配置中 HUADAI_BASE_URL 一致）。

统一鉴权、响应包体与错误码分段说明见 api-details.md、错误码表。