Magic Image2Video for Openclaw

A professional AI video generation skill that converts text descriptions and static images into dynamic video content via remote API integration.

zhangyuangao
v1.0.1
Mar 17, 2026
2
883
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install magic-image2video

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 magic-image2video 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 Magic Image2Video?

Magic Image2Video is a specialized skill designed for Openclaw Skills that bridges the gap between static assets and cinematic video. By leveraging a remote video service, it allows users to provide a prompt and an image (either via URL or local path) to generate high-fidelity video content automatically.

This skill is built for seamless integration within AI agent workflows, featuring built-in polling mechanisms that track task status from creation to completion. It ensures that developers and creators can automate the video production lifecycle without manual oversight, making it a cornerstone for automated media pipelines.

Magic Image2Video Use Cases

  • Creating dynamic marketing clips from static product photography.
  • Animating conceptual art or AI-generated images based on specific text prompts.
  • Automating video content creation for social media using localized image assets.
  • Transforming storyboard frames into video previews during the creative design process.

How Magic Image2Video Works

  1. The agent extracts the user's text prompt and the image source (URL or local file path).
  2. A video-create command is issued to the remote service to initialize the generation task.
  3. The system captures the unique task_id from the JSON response and shares it with the user.
  4. An automated polling process triggers the video-wait command to monitor progress every 10 seconds.
  5. Upon successful completion (status 2), the final video URL is retrieved and presented to the user.

Magic Image2Video Setup

To use this within your Openclaw Skills environment, ensure Python 3 is installed and configure your API credentials:

# Set your Magic API Key
export MAGIC_API_KEY="your-key-here"

# Verify the client script is accessible in your skill directory
python3 ./scripts/media_gen_client.py --help

Magic Image2Video Data Schema & Taxonomy

The skill utilizes standardized JSON structures for communication with the video API. Below is the schema for task monitoring:

Field Type Description
task_id String Unique identifier for the video generation task.
task_status Integer Represents current state (e.g., 2 for Success).
video_url String The direct URL to the generated MP4 file.
biz_code Integer Business logic return code (10000 for Success).

Magic Image2Video Advanced Features

  • Intelligent polling with configurable intervals and timeouts (up to 600 seconds).
  • Automatic escaping of special characters in text prompts to prevent command-line injection.
  • Support for both remote hosted image URLs and local filesystem paths.
  • Detailed trace_id logging for debugging and tracking API requests across the Openclaw Skills ecosystem.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python
Github Stars: 0
forks: 0

Featured*