实战：OpenClaw连接灏天文库，打造AI内容创作自动化工作流

实战：OpenClaw 连接灏天文库，打造 AI 内容创作自动化工作流

引言：为什么需要自动化内容创作工作流？

在 AI 时代,内容创作者面临着前所未有的机遇与挑战。一方面,AI 工具可以大大提升写作效率;另一方面,如何管理、存储、检索海量 AI 生成的内容,成为创作者必须解决的问题。

灏天文库是一个专为 AI 内容管理设计的知识库平台,支持文集分类、文档管理、RAG(Retrieval-Augmented Generation)检索增强生成等功能。OpenClaw 则是一个强大的 AI 智能体框架,能够自主完成复杂任务。

将 OpenClaw 与灏天文库结合,可以打造一个完整的 AI 内容创作自动化工作流:

• 自主写作:OpenClaw 根据你的要求自动撰写文章
• 自动发布:文章完成后自动上传到灏天文库指定文集
• 智能检索:通过 RAG 技术,让 AI 基于已有内容生成新文章
• 批量管理:支持批量内容创作、更新、同步

本文将带你从零开始,搭建这个自动化工作流。

第一部分:环境准备

1.1 系统要求

在开始之前,请确保你的系统满足以下要求:

• 操作系统: Linux/macOS/Windows(推荐使用 WSL2)
• Python 版本: Python 3.8+
• OpenClaw: 已安装并配置 OpenClaw 框架
• 数据库访问权限: 需要灏天文库 MySQL 数据库的访问权限

1.2 安装 ht-skills 技能

ht-skills 是 OpenClaw 连接灏天文库的核心技能包。以下是安装步骤:

步骤 1:获取技能包

ht-skills 已集成在 OpenClaw 技能商店中。如果你的 OpenClaw 已配置技能商店,可以直接通过以下命令安装:

# 进入OpenClaw工作空间
cd ~/.openclaw/workspace/skills/

# 克隆或复制ht-skills技能包
# 方式1: 如果技能已在商店
openclaw skill install ht-skills

# 方式2: 手动安装
git clone <ht-skills仓库地址> ht-skills

步骤 2:安装 Python 依赖

进入 ht-skills 目录,安装所需的 Python 依赖:

cd ~/.openclaw/workspace/skills/ht-skills
pip install -r requirements.txt

1.3 配置文件设置

ht-skills 的核心配置文件是 config.json。你需要创建这个文件并填入正确的配置信息。

创建配置文件

在 ht-skills 目录下,复制配置模板:

cd ~/.openclaw/workspace/skills/ht-skills
cp config.example.json config.json

编辑配置文件

使用你喜欢的编辑器打开 config.json:

vim config.json
# 或
nano config.json
```**安全性提示:**

1. 不要将包含真实密码的`config.json`提交到Git仓库
2. 确保`config.json`文件权限设置为只有当前用户可读:
   ```bash
   chmod 600 config.json

3. 如果使用 Git,.gitignore 已配置忽略 config.json,确保不要手动添加

1.4 验证安装

安装完成后,运行以下命令验证配置是否正确:

cd ~/.openclaw/workspace/skills/ht-skills
python scripts/list_collections.py

如果配置正确,你将看到灏天文库中的文集列表。

第二部分:连接配置与基础操作

2.1 ht-skills 核心脚本介绍

ht-skills 提供了核心脚本,每个脚本对应一个特定功能:

所有脚本位于 scripts/ 目录下,可以从任意目录执行(脚本会自动定位项目根目录)。

2.2 基础操作示例

示例 1:查询文集列表

# 查询所有文集
python scripts/list_collections.py

# 按名称搜索文集
python scripts/list_collections.py --name "OpenClaw"

# 限制返回数量
python scripts/list_collections.py --limit 10

返回结果示例:

[
    {
        "id": 879,
        "name": "OpenClaw",
        "description": "OpenClaw相关教程与案例",
        "brief": "详细介绍OpenClaw的使用方法、最佳实践和实战案例...",
        "created_at": "2026-03-10 10:00:00"
    }
]

示例 2:创建新文集

# 创建文集
python scripts/create_collection.py --name "技术教程" --description "技术类教程合集"

# 如果文集已存在则直接返回ID,不存在则创建
python scripts/create_collection.py --name "技术教程" --get-if-exists

重要: 根据 ht-skills 的智能体执行规范,在创建文集前必须让用户确认文集名称。

示例 3:查询文档

# 查询所有文档
python scripts/list_documents.py

# 按名称搜索文档
python scripts/list_documents.py --name "OpenClaw"

# 查询特定文集下的文档
python scripts/list_documents.py --collection-id 879

第三部分:实战案例 1 - 自动写作并发布文章

3.1 场景描述

假设你需要 OpenClaw 自主完成以下任务:

1. 撰写一篇关于"OpenClaw 实战教程"的文章
2. 将文章上传到灏天文库的"OpenClaw"文集(ID: 879)
3. 同步到 RAG,使文章可被后续检索

3.2 完整工作流

步骤 1:确认目标文集

首先,查询"OpenClaw"文集是否存在:

python scripts/list_collections.py --name "OpenClaw"

如果返回结果包含文集 ID 879,说明文集已存在。如果没有返回结果,则需要创建文集:

python scripts/create_collection.py --name "OpenClaw" --description "OpenClaw相关教程与案例"

OpenClaw 智能体执行时的规范:

根据 ht-skills 的智能体执行规范,在添加文档前:

1. 必须确认文集 ID: 用户未提供文集时,必须询问"请告知要将文档添加到的文集名称"
2. 查询文集 ID: 使用 list_collections.py --name "文集名称" 获取文集 ID
3. 文集不存在时: 询问是否新建文集

步骤 2:AI 撰写文章

在 OpenClaw 中,你可以通过对话方式让 AI 撰写文章。例如:

用户: 请为灏天文库的文集"OpenClaw"(ID:879)撰写一篇实战教程文章,
主题是"OpenClaw连接灏天文库的自动化工作流",字数3000字左右,
包含环境准备、配置步骤、实战案例等内容。

OpenClaw 会自主撰写文章。撰写完成后,文章内容会保存在临时文件或内存中。

步骤 3:上传文档到灏天文库

文章撰写完成后,使用 add_document.py 上传:

# 方式1:直接使用命令行参数
python scripts/add_document.py --collection-id 879 --name "实战:OpenClaw连接灏天文库,打造AI内容创作自动化工作流" --content "这里是文章的正文内容..."

# 方式2:使用文件(推荐用于长文章)
python scripts/add_document.py --collection-id 879 --name "实战:OpenClaw连接灏天文库,打造AI内容创作自动化工作流" --content-file /path/to/article.md

参数说明:

• --collection-id: 目标文集 ID(必填)
• --name: 文档标题(必填)
• --content: 文档正文内容(与 --content-file 二选一)
• --content-file: 文档文件路径(与 --content 二选一)
• --parent: 父文档 ID(可选,用于创建文档层级结构)

返回结果示例:

{
    "success": true,
    "document_id": 12345,
    "message": "文档创建成功"
}

记住返回的 document_id。

3.3 OpenClaw 智能体完整执行流程

当 OpenClaw 智能体接到"写文章并发布"的任务时,它会按照以下流程自主执行:

1. 用户输入任务要求
   ↓
2. 智能体解析任务,确认目标文集
   - 如果用户未提供文集 → 询问文集名称
   - 查询文集ID: list_collections.py --name "文集名"
   - 如果文集不存在 → 询问是否创建
   ↓
3. 智能体撰写文章内容
   - 根据主题、字数要求、风格要求生成文章
   - 保存到临时文件
   ↓
4. 上传文档到灏天文库
   - 执行: add_document.py --collection-id <ID> --name "标题" --content-file <文件>
   - 获取返回的document_id
   ↓
5. 向用户报告完成情况
   - 文章标题
   - 文集名称和ID
   - 文档ID

总结

通过本文的学习,你已经掌握了:

1. 环境搭建: ht-skills 安装、配置文件设置、数据库连接
2. 基础操作: 文集/文档的查询、创建、更新、删除
3. 实战案例:
   • 案例 1: 自动写作并发布文章的完整流程
   • 案例 2: 批量内容创作工作流的设计与实现
4. 问题解决: 常见错误的原因分析和解决方案
5. 最佳实践: 智能体执行规范、工作流设计、性能优化

OpenClaw 与灏天文库的结合,为 AI 内容创作提供了完整的解决方案:

• 自动化写作: AI 根据要求自主撰写文章
• 智能管理: 自动分类、存储、检索海量内容
• 知识复用: 通过 RAG 技术,让新内容基于已有知识生成
• 批量生产: 支持批量内容创作和发布

下一步,你可以:

1. 根据自己的需求定制工作流
2. 集成到现有的内容管理系统
3. 结合其他 OpenClaw 技能(如 web_search、tavily)增强信息获取能力
4. 构建更复杂的 AI 内容生产系统

AI 内容创作的未来已来,让我们一起用 OpenClaw 和灏天文库,开启智能创作的新时代!