AI Director - AI Short Drama Generation

Complete AI short drama solution — from concept to finished film, with integrated X2C platform account management and billing.

Multi-User Support

Each user has independent X2C credentials stored in credentials/{USER_ID}.json.

Set USER_ID or TELEGRAM_USER_ID env var when calling scripts:

CODEBLOCK0

OpenClaw passes the user ID automatically from chat context.

Modules

1. Ad Account Manager

X2C platform account binding and verification.

CODEBLOCK1

2. Ad Character Manager

Manage custom characters for video production. Max 5 per user.

CODEBLOCK2

3. Ad Writer (Prompt Engineering)

Agent reads references/AD-WRITER-GUIDE.md and generates a complete script based on user's creative concept. Outputs: title, synopsis, character bios, outline, episode breakdowns, full screenplay.

4. Ad Producer (Video Production)

CODEBLOCK3

Generation Options

Cost

Quality Evaluator

Uses Gemini to score video quality against defined criteria.

CODEBLOCK4

Requires GEMINI_API_KEY env var or geminiApiKey in config.

Auto-Iterate

Automatically evaluate + improve prompt + regenerate until quality threshold met.

CODEBLOCK5

Critical Rules

• - Confirm all parameters with user before generating video
• Only use values from config options (styles, categories) — never custom values
• Episodes are fixed: shortvideo=1, shortdrama=10
• Each episode can only be submitted once for production
• Never auto-retry failed generations (costs credits)
• Use async task handling — do not block with --wait in production
• Output video URLs completely, never truncate
• Remove &response-content-disposition=attachment from video URLs for browser playback

API Reference

See references/X2C-OPEN-API.md for complete API documentation.

Credentials

Store in credentials/{USER_ID}.json:

CODEBLOCK6

Or set X2C_API_KEY env var, or configure via skills."ai-director".env.X2C_API_KEY in ~/.openclaw/openclaw.json.