OpenClaw Video Publisher

支持一键将视频批量上传至抖音、快手、视频号、B站、YouTube 和 TikTok，具备凭证管理和失败自动重试功能。

OpenClaw Video Publisher Skill

多平台视频发布工具 - AI Agent 使用指南

---

🎯 Skill 简介

这是一个多平台视频发布工具，支持一键将视频上传到抖音、快手、视频号、B站、YouTube、TikTok 等平台。

核心功能

• 📤 多平台批量发布
• 🔐 统一的凭证管理
• 🔄 失败自动重试
• 📊 发布记录追踪
• ⚡ 命令行和编程接口

---

📋 依赖和要求

系统要求

• Node.js: >= 18.0.0
• 操作系统: Linux, macOS, Windows
• 磁盘空间: >= 100MB

外部 API 依赖

• 抖音开放平台 API (可选)
• 快手开放平台 API (可选)
• 微信视频号 API (可选)
• 哔哩哔哩创作中心 API (可选)
• YouTube Data API v3 (可选)
• TikTok for Developers API (可选)

npm 依赖包

{
  "dependencies": {
    "axios": "^1.6.0",
    "dotenv": "^16.3.1",
    "form-data": "^4.0.0",
    "commander": "^11.1.0"
  }
}

---

🚀 快速开始

安装

# 方式 1: npm 安装
npm install -g openclaw-video-publisher

# 方式 2: 克隆仓库
git clone https://github.com/ZhenRobotics/openclaw-video-publisher.git
cd openclaw-video-publisher
npm install

配置

# 1. 复制配置模板
cp config/platforms.example.json config/platforms.json
cp .env.example .env

# 2. 编辑 .env 填入 API 凭证
nano .env

使用

# 发布视频到抖音和快手
./publish.sh upload \
  --video my-video.mp4 \
  --title "我的视频" \
  --platforms "douyin,kuaishou"

---

🤖 AI Agent 使用指南

推荐使用场景

1. 批量发布内容

   User: "帮我把 videos 目录下的所有视频发布到抖音和快手"
   Agent: 使用批量发布功能处理所有视频
   

2. 定时发布

   User: "每天下午 6 点发布视频到所有平台"
   Agent: 创建定时任务，自动调用发布工具
   

3. 多平台管理

   User: "查看今天发布了哪些视频"
   Agent: 读取发布历史记录并汇总
   

Agent 调用示例

// TypeScript Agent 示例
import { VideoPublisher } from 'openclaw-video-publisher';

async function publishVideo(videoPath: string, title: string) {
  const publisher = new VideoPublisher(
    platformsConfig,
    credentials
  );

  const result = await publisher.publish({
    video: {
      path: videoPath,
      filename: path.basename(videoPath),
      size: fs.statSync(videoPath).size,
    },
    metadata: {
      title: title,
      tags: ['AI', '技术'],
    },
    platforms: ['douyin', 'kuaishou'],
    retry: true,
    maxRetries: 3,
  });

  return result;
}

Shell Script Agent 示例

#!/bin/bash
# Agent 批量发布脚本

VIDEO_DIR="./videos"
PLATFORMS="douyin,kuaishou,bilibili"

for video in "$VIDEO_DIR"/*.mp4; do
  echo "发布: $video"

  ./publish.sh upload \
    --video "$video" \
    --title "$(basename "$video" .mp4)" \
    --platforms "$PLATFORMS" \
    --retry

  sleep 5  # 避免 API 限流
done

---

🔐 安全性说明

API 凭证管理

• ✅ 所有凭证存储在 .env 文件中
• ✅ .env 已加入 .gitignore，不会提交到版本控制
• ✅ 支持环境变量覆盖
• ⚠️ 请勿在日志中输出完整凭证

数据隐私

• ✅ 视频文件仅上传到用户配置的平台
• ✅ 发布记录存储在本地 data/ 目录
• ✅ 不收集用户数据
• ✅ 不连接第三方服务器（除配置的平台 API）

网络安全

• ✅ 使用 HTTPS 连接平台 API
• ✅ 支持代理配置
• ✅ 遵循平台 API 频率限制

---

📊 API 频率限制

平台	每小时	每天
抖音	100	1000
快手	100	1000
视频号	50	500
B站	50	500
YouTube	1000	10000

建议：

• 使用 --retry 参数处理临时失败
• 批量发布时添加延迟（5-10秒）
• 监控 API 配额使用情况

---

📁 项目结构

openclaw-video-publisher/
├── src/
│   ├── core/           # 核心逻辑
│   ├── platforms/      # 平台适配器
│   ├── cli/            # CLI 入口
│   └── utils/          # 工具函数
├── config/
│   └── platforms.json  # 平台配置
├── examples/           # 使用示例
├── publish.sh          # 主入口脚本
├── .env               # 环境变量（需创建）
└── README.md          # 完整文档

---

🐛 常见问题

Q1: 上传失败怎么办？

A: 检查以下几点：

1. API 凭证是否正确
2. 视频文件是否符合平台要求
3. 网络连接是否正常
4. 是否超过 API 限流

使用 --retry 参数自动重试。

Q2: 如何添加新平台？

A:

1. 在 src/platforms/ 创建新的适配器类
2. 在 config/platforms.example.json 添加配置
3. 在 .env.example 添加凭证模板
4. 提交 Pull Request

Q3: 支持视频编辑吗？

A: 当前版本仅支持发布，不支持编辑。可以结合其他工具（如 ffmpeg）预处理视频。

---

🔗 相关资源

• GitHub 仓库: https://github.com/ZhenRobotics/openclaw-video-publisher
• npm 包: https://www.npmjs.com/package/openclaw-video-publisher
• 问题反馈: https://github.com/ZhenRobotics/openclaw-video-publisher/issues
• 文档: README.md | QUICKSTART.md

---

📝 验证信息

• Skill 版本: 1.0.0
• 最后更新: 2024-03-10
• 作者: justin
• 许可证: MIT
• 验证仓库: https://github.com/ZhenRobotics/openclaw-video-publisher
• 验证提交: [待发布]

---

🙏 贡献

欢迎贡献代码！

1. Fork 仓库
2. 创建特性分支
3. 提交 Pull Request

---

让 AI Agent 帮你自动发布视频！ ✨🚀