HeyGen Stack for Openclaw

An advanced AI video production framework for creating high-fidelity avatar videos via the HeyGen v3 API.

eve-builds
v1.3.1
Apr 10, 2026
1
172
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install heygen-stack

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install heygen-stack using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is HeyGen Stack?

The HeyGen Stack is a comprehensive skill designed to transform raw ideas into professional-grade AI videos. Unlike basic API wrappers, this skill acts as a virtual producer, handling complex tasks like aspect ratio correction, prompt engineering, and avatar resolution. By leveraging Openclaw Skills, users can bypass the limitations of raw API calls to produce content with superior framing, optimized motion verbs, and localized narration.

This system is built specifically for the HeyGen v3 API, ensuring that every video benefits from the latest rendering engine and digital twin capabilities. It manages the entire lifecycle of video creation, from initial identity design to the final delivery of polished assets, making it an essential tool for developers and creators building identity-first video experiences.

HeyGen Stack Use Cases

  • Creating personalized video messages for sales outreach, pitches, or team updates.
  • Developing AI-driven digital twins and avatars from static photos.
  • Generating multi-language training videos with localized scripts and voices.
  • Automating the personification of AI agents into talking head videos.
  • Producing high-retention social media content with optimized visual hooks.

How HeyGen Stack Works

  1. The skill analyzes user intent and automatically detects the preferred communication language.
  2. Performs a first-run avatar check, invoking the avatar designer if no identity profile is found.
  3. Conducts a conversational Discovery phase to gather video purpose, audience, and visual assets.
  4. Drafts a specialized script and crafts a prompt optimized for the HeyGen v3 engine.
  5. Executes a mandatory Frame Check to correct aspect ratios and prevent background artifacts.
  6. Submits the request to the HeyGen API and polls for completion in a silent background process.
  7. Delivers the final video URL and thumbnail while logging session metadata for future reference.

HeyGen Stack Setup

To use this skill, ensure you have your HeyGen API key configured in your environment.

export HEYGEN_API_KEY="your_api_key_here"

This skill requires the presence of the heygen-avatar-designer and heygen-video-producer sub-skills within your Openclaw Skills directory for full pipeline automation.

HeyGen Stack Data Schema & Taxonomy

The HeyGen Stack organizes its operations using the following file structure:

Path Purpose
AVATAR-<NAME>.md Stores saved avatar identities including group_id and voice_id.
heygen-video-producer-log.jsonl A local learning log that appends metadata for every video generated.
SOUL.md / IDENTITY.md Read-only files used to extract personality traits for new avatars.
/tmp/openclaw/uploads/ Temporary storage for voice previews and session assets.

HeyGen Stack Advanced Features

  • Automated Frame Check Matrix: Corrects orientation and aspect ratio mismatches before API submission.
  • Buddy Pipeline Integration: Seamlessly converts agent identities into visual avatars.
  • Language-Agnostic Routing: Automatically generates scripts and narration in the user's detected language.
  • Silent Polling: Background monitoring of video status to maintain a clean chat experience.
  • Asset Contextualization: Intelligently routes URLs and files for either script analysis or direct video attachment.

SKILL.md


Loading

Related Openclaw Skills

Featured*