🎬 视频生成技能

一套自动化的文本转视频生成系统，可将文本脚本转化为具备 AI 语音配音、精准时间控制与赛博线框视觉风格的专业短视频。

成本：约 $0.003 / 15 秒视频 | 许可证：MIT | 包名：openclaw-video-generator

📦 包信息

验证方式：

npm info openclaw-video-generator version repository.url
# 预期输出：1.6.2 和 https://github.com/ZhenRobotics/openclaw-video-generator

🔐 提供商配置（任选其一）

本工具支持 4 种可选的 TTS/ASR 服务商，您只需配置其中 任意一个 即可：

选项 1：OpenAI（推荐）

export OPENAI_API_KEY="sk-..."

• 优势：音质最佳，配置最简
• 成本：约 $0.003 / 15 秒视频

选项 2：Azure

export AZURE_SPEECH_KEY="..."
export AZURE_SPEECH_REGION="eastasia"

• 优势：企业级可靠性
• 成本：与 OpenAI 相当

选项 3：阿里云

export ALIYUN_ACCESS_KEY_ID="..."
export ALIYUN_ACCESS_KEY_SECRET="..."
export ALIYUN_APP_KEY="..."

• 优势：国内网络连通性佳，支持中文语音
• 成本：约 ¥0.02 / 15 秒视频

选项 4：腾讯云

export TENCENT_SECRET_ID="..."
export TENCENT_SECRET_KEY="..."
export TENCENT_APP_ID="..."

• 优势：国内网络连通性佳
• 成本：约 ¥0.02 / 15 秒视频

为何支持多个服务商？ 为应对网络限制、区域偏好及成本优化提供自动回退（fallback）支持。

🚀 快速开始

前提条件

node --version  # 需 >= 18
npm --version
ffmpeg -version

安装方式

方式 1：npm 全局安装

npm install -g openclaw-video-generator@1.6.2
export OPENAI_API_KEY="sk-..."  # 或添加至 ~/.bashrc
openclaw-video-generator --version

方式 2：源码构建

git clone https://github.com/ZhenRobotics/openclaw-video-generator.git
cd openclaw-video-generator
npm install

# 配置服务商
cp .env.example .env
nano .env  # 填入您的 API 密钥
chmod 600 .env

生成首个视频

cd ~/openclaw-video-generator
cat > test.txt << 'EOF'
AI makes development easier
Saving time and boosting efficiency
EOF

./scripts/script-to-video.sh test.txt --voice nova --speed 1.15
# 输出：out/test.mp4

💻 Agent 使用方式

触发时机

当用户提及以下关键词时自动触发：video、generate video、create video、生成视频

标准命令

cd ~/openclaw-video-generator && 
./scripts/script-to-video.sh  
  --voice nova 
  --speed 1.15

添加背景视频

cd ~/openclaw-video-generator && 
./scripts/script-to-video.sh  
  --voice nova 
  --bg-video "backgrounds/tech.mp4" 
  --bg-opacity 0.6

示例流程

用户：“Generate video: AI makes development easier”

Agent：

# 1. 检查项目是否存在
ls ~/openclaw-video-generator || echo "Not installed"

# 2. 创建脚本
cat > ~/openclaw-video-generator/scripts/user-script.txt << 'EOF'
AI makes development easier
EOF

# 3. 生成视频
cd ~/openclaw-video-generator && 
./scripts/script-to-video.sh scripts/user-script.txt

# 4. 显示结果路径
echo "Video: ~/openclaw-video-generator/out/user-script.mp4"

使用指南

应执行的操作：

• 运行前确认项目已存在
• 检查 .env 配置是否正确
• 明确告知输出文件路径

禁止执行的操作：

• 未经用户确认即执行克隆操作
• 在命令中硬编码 API 密钥
• 新建 Remotion 项目

🎯 核心功能

• 多服务商 TTS 支持：OpenAI、Azure、阿里云、腾讯云，支持自动回退
• 时间戳提取：高精度语音转文字分段
• 场景检测：6 类智能场景类型，支持自动样式匹配
• 视频渲染：基于 Remotion 实现赛博线框美学风格
• 背景视频：支持自定义背景视频及透明度调节
• 本地处理：视频渲染全程在本地机器完成

⚙️ 配置说明

TTS 语音选项

OpenAI：

• nova（推荐）、alloy、echo、shimmer

Azure：

• zh-CN-XiaoxiaoNeural、zh-CN-YunxiNeural

语速设置

取值范围：0.25 – 4.0 | 推荐值：1.15

背景视频

• --bg-video —— 背景视频文件路径
• --bg-opacity <0–1> —— 透明度（0 完全透明，1 完全不透明）
• --bg-overlay —— 文字叠加层颜色（RGBA 格式）

推荐配置：

📊 视频规格

• 分辨率：1080 × 1920（竖屏）
• 帧率：30 fps
• 格式：MP4（H.264 编码 + AAC 音频）
• 风格：赛博线框 + 霓虹配色
• 时长：自动计算

🎨 场景类型

💰 成本说明

每 15 秒视频成本：约 $0.003（低于 1 美分）

• TTS 服务：约 $0.001
• Whisper（语音识别）：约 $0.0015
• 渲染：免费（本地执行）

🔧 故障排查

项目未找到

ls ~/openclaw-video-generator || 
git clone https://github.com/ZhenRobotics/openclaw-video-generator.git ~/openclaw-video-generator && 
cd ~/openclaw-video-generator && npm install

API 密钥错误

# 检查 .env 文件
cat ~/openclaw-video-generator/.env

# 若缺失则创建
cd ~/openclaw-video-generator
echo 'OPENAI_API_KEY="sk-..."' > .env
chmod 600 .env

服务商测试

cd ~/openclaw-video-generator && ./scripts/test-providers.sh

🔒 隐私说明

本地处理环节：

• 视频渲染
• 场景编排
• 文件管理

云端处理环节（由所选服务商执行）：

• 文本转语音（文本发送至对应 API）
• 语音识别（音频发送至对应 API）

API 密钥存储于 .env 文件中（权限设为 600，且严禁提交至 Git 仓库）。

📚 文档资源

• npm：https://www.npmjs.com/package/openclaw-video-generator
• GitHub：https://github.com/ZhenRobotics/openclaw-video-generator
• 问题反馈：https://github.com/ZhenRobotics/openclaw-video-generator/issues

📊 技术栈

Remotion · OpenAI · Azure · 阿里云 · 腾讯云 · TypeScript · Node.js · FFmpeg

🆕 版本历史

v1.6.2（2026-03-25）—— 当前版本

• 集成阿里云中文 TTS 支持
• 双字幕样式支持
• 新增医疗类内容示例

v1.6.0（2026-03-18）

• 高级样式系统
• 海报生成器
• 设计令牌（Design Tokens）支持

v1.2.0（2026-03-07）

• 支持背景视频
• 多服务商架构
• 自动回退机制

v1.0.0（2026-03-03）

• 初始发布

许可证：MIT | 作者：@ZhenStaff | 技术支持：GitHub Issues