🎬 libtv-skills

AI Agent Skills for LibLib.tv — 让你的 AI Agent 轻松调用 LibTV 的生图、生视频等 AIGC 能力。

✨ 简介

libtv-skills 是一组面向 AI Agent 的技能包（Skills），通过 LibLib.tv 的 OpenAPI 提供 AI 生图、AI 生视频 等 AIGC 能力。Agent 可以通过这些技能创建会话、发送创作指令、查询生成进展，并获取最终的图片/视频结果。

本项目遵循 OpenClaw 技能规范，可被支持该规范的 AI Agent 平台直接识别和调用。

📦 技能列表

📥 快速安装

通过 npx skills 一键安装技能到你的项目中：

# 交互式选择要安装的技能
npx skills add libtv-labs/libtv-skills

# 直接安装指定技能
npx skills add libtv-labs/libtv-skills --skill libtv-skill

安装完成后，设置环境变量即可使用：

export LIBTV_ACCESS_KEY="your-access-key"

🎉 就这么简单！ 技能文件会被添加到你的项目中，AI Agent 将自动识别并调用，无需手动执行任何脚本。

可选配置（一般无需修改）：

🛠️ 手动使用 / 调试

📁 项目结构

libtv-skills/
├── README.md
├── LICENSE
└── skills/
    └── libtv-skill/                  # Agent-IM 会话技能
        ├── SKILL.md                # 技能描述文件（OpenClaw 规范）
        └── scripts/
            ├── _common.py          # 公共模块（鉴权、HTTP 请求、API 封装）
            ├── create_session.py   # 创建会话 / 发送消息
            ├── query_session.py    # 查询会话消息进展
            ├── change_project.py   # 切换绑定项目
            ├── upload_file.py      # 上传图片 / 视频文件到 OSS
            └── download_results.py # 批量下载生成结果到本地

🔧 API 参考

鉴权

所有 API 请求通过 HTTP Header 进行 Bearer Token 鉴权：

Authorization: Bearer 

接口列表

请求 & 响应

🤖 Agent 集成指南

本技能包设计为被 AI Agent 自动调用。典型的工作流如下：

用户指令 → Agent 解析意图 → 调用 create_session.py 发送指令
                                    ↓
                          获取 sessionId + projectUuid
                                    ↓
                          轮询 query_session.py 获取结果
                                    ↓
                     download_results.py 批量下载到本地
                                    ↓
                      向用户展示：生成结果 + 项目画布链接

最佳实践

• 自动下载：任务完成后，使用 download_results.py 将图片/视频批量下载到本地，再同时向用户展示 本地文件路径 和 项目画布链接（projectUrl）
• 增量轮询：使用 --after-seq 参数进行增量拉取，避免重复获取已处理的消息
• 项目管理：当需要隔离不同任务时，使用 change_project.py 切换到新项目
• 文件上传：在发送生图/生视频指令前，可先用 upload_file.py 上传参考图片或素材，获取 OSS 地址后再一并传入消息

🤝 贡献

欢迎提交 Pull Request 来添加新的技能或改进现有技能！

添加新技能

1. 在 skills/ 目录下创建新的技能文件夹
2. 编写 SKILL.md 技能描述文件（遵循 OpenClaw 规范）
3. 在 scripts/ 子目录中实现功能脚本
4. 更新本 README 的技能列表

📄 License

本项目采用 MIT License 开源。

Copyright © 2026 libtv-labs