OpenClaw 连接灏天文库

一、ht-skills 是什么？

ht-skills 是专为 OpenClaw 设计的灏天文库管理技能，配置个人 Token 后即可实现：

• 新建与维护文集：创建、查询、更新个人花园文集
• 新建与维护文档：写入正文、调整目录层级、移动文档归属
• 图片管理：创建图片分组、上传图片、查看用量
• 文档片段检索（RAG）：从公开精品文集中检索相关片段及出处（不调用大模型）
• 花园文集晋升：将个人花园文集申请为平台精品文集，由管理员审核
• 适用于 AI 自主写文章并入库、知识检索增强、花园晋升等场景

使用前需在技能配置中填写你的个人 Token（见下方「个人 Token 怎么获取」）。服务地址一般按技能包默认即可，无需改动。

二、怎么安装？

1. 获取 ht-skills 技能包
   从 OpenClaw 技能市场或官方渠道获取安装包，也可以从 GitHub 仓库下载。
2. 安装到 OpenClaw
   将技能包按仓库说明放到 OpenClaw 的技能目录，并在 OpenClaw 中刷新技能列表。
3. 填写个人 Token
   在技能配置中填入你的个人 Token（见下方获取方式）。配置文件写法以技能包内说明为准。
4. 验证是否可用
   在 OpenClaw 中发起一次「列出我的文集」或类似指令；若能返回你的文集列表，说明已配置成功。

三、文档片段检索（RAG）

从灏天文库公开精品文集中检索与问题相关的文档片段及出处，不调用大模型，适合给 AI 提供参考资料。

文集 ID 从哪里获取？

检索针对的是平台公开精品文集。请到官方目录查看「ID | 文集名称」，再把需要的 ID 交给技能使用：

四、花园文集晋升申请

把已经写好的个人花园文集，申请晋升为平台精品文集。管理员审核通过后，文集会进入精品展示。

推荐流程

1. 先确认还能不能申请
   每用户 24 小时最多申请 1 次。可先让技能查询当前额度。
2. 确认目标文集
   用「列出我的文集」找到要晋升的文集，并确认其中已有文档。
3. 提交申请
   告诉技能要晋升哪本文集，可附带简短申请说明。
4. 查看进度
   可查询申请列表，状态为：待审 / 通过 / 驳回。

五、使用须知

• 查文档前先确定文集：不知道文集时，先让技能列出你的文集
• 数据范围：普通用户只能看到和操作自己账号下的文集与文档
• 可改内容：文档可改标题、正文、排序与目录层级
• 内容审核：新建或修改文集、文档时可能触发敏感词等审核；失败时按提示调整后重试
• RAG 与个人花园无关：检索用的文集 ID 来自公开目录，不是你个人花园列表里的 ID

六、个人花园额度说明

个人花园相关能力会根据用户等级和会员状态限制用量。

限制一览

等级与基础文集数

七、个人 Token 怎么获取？

使用 ht-skills 前，必须先获取个人 Token。Token 用于证明是你本人操作，请勿泄露给他人。

1. 登录灏天文库
   访问 aiknowledge.cn 并登录你的账号。
2. 进入个人中心
   点击右上角头像，选择「个人中心」。
3. 查看个人 Token
   在个人中心的Token 信息区域查看；若尚未生成，系统会自动创建。
4. 复制并配置
   点击「复制」，粘贴到 ht-skills 的配置中（写法见技能包说明）。