OpenClaw Investor Relations Manager

AI-powered Investor Relations Manager - automated video generation for earnings reports, financial updates, and stakeholder communications.

Overview

Transform your financial data and business updates into professional video presentations for investors, stakeholders, and the financial community. Built on OpenClaw + Remotion + OpenAI, this system automates the entire pipeline from data to polished IR videos.

Key Features

• Professional Business Voice - OpenAI TTS with corporate-appropriate voices
• Financial Metric Detection - Intelligent recognition of revenue, profit, growth indicators
• IR-Optimized Scenes - 6 scene types designed for investor presentations
• Corporate Visual Style - Professional blue/green color scheme
• Background Video Support - Custom backgrounds with opacity control
• Complete Automation - From financial data to rendered video in minutes

Quick Start

Prerequisites

• Node.js >= 18
• npm or pnpm
• OpenAI API Key (with TTS + Whisper access)

Installation

# 1. Clone the repository
git clone https://github.com/ZhenRobotics/openclaw-investor-relations-manager.git
cd openclaw-investor-relations-manager

# 2. Install dependencies
npm install

# 3. Configure API key
echo 'OPENAI_API_KEY="sk-your-key-here"' > .env

# 4. Verify installation
investor-relations-manager help

Generate Your First IR Video

# Quick example - Q3 earnings
investor-relations-manager generate "Q3 earnings report. Revenue reached 2.3 billion dollars, up 45%. Net profit 35 million dollars, up 60%. User base 5 million. Strongest quarter ever."

# View the output
mpv out/generated.mp4

Usage

Method 1: CLI (Recommended)

investor-relations-manager generate "Your financial update here"

Method 2: From Script File

./scripts/script-to-video.sh scripts/example-q3-earnings.txt

Method 3: With Background Video

./scripts/script-to-video.sh scripts/annual-report.txt \
  --voice alloy \
  --speed 1.0 \
  --bg-video public/corporate-bg.mp4 \
  --bg-opacity 0.3

Pipeline Architecture

Financial Data/Script
    ↓
OpenAI TTS (Professional Voice)
    ↓
OpenAI Whisper (Timestamp Extraction)
    ↓
Financial Scene Detection
    ↓
Remotion Rendering (Corporate Style)
    ↓
Professional IR Video (MP4)

Scene Types for IR

The system automatically detects and applies appropriate scenes:

| Scene Type | Use Case | Visual Effect | |------------|----------|---------------| | Title | Opening ("Q3 Earnings Report") | Professional intro with subtle effect | | Emphasis | Key metrics ("+45% growth") | Highlight animation | | Circle | Important KPIs ("$2.3B revenue") | Circular spotlight | | Content | Business updates | Clean fade-in | | Pain | Challenges/risks | Attention-grabbing | | End | Closing message | Professional outro |

Financial Metric Detection

Automatically recognizes and highlights:

• Growth: 增长, 提升, %, growth, increase, up
• Revenue/Profit: 营收, 收入, 利润, revenue, profit, earnings
• Metrics: 用户, 客户, users, customers
• Periods: Q1-Q4, 季度, quarter, annual
• Concerns: 挑战, 风险, challenge, risk

Example Scripts

Q3 Earnings Report

Q3季度业绩报告。
营收增长45%，达到2.3亿美元。
净利润提升60%，至3500万美元。
用户规模突破500万。
这是公司历史上最强劲的一个季度。
我们将继续保持增长势头。
感谢投资者的信任与支持。

Annual Shareholder Update

2024年度业绩总结。
全年营收突破8亿美元。
同比增长120%。
研发投入增加40%。
新增客户超过200家。
市场份额提升至行业第三。
展望2025，我们充满信心。

Product Launch Announcement

重磅新品发布。
AI驱动的企业解决方案正式上线。
预计贡献年收入5000万美元。
已获得50家企业客户预订。
这将开启公司新的增长阶段。
投资者可期待持续回报。

Configuration

Voice Options

• alloy (Recommended) - Neutral, professional, clear
• echo - Authoritative and clear
• onyx - Deep, executive-style

investor-relations-manager generate "Your script" --voice alloy

Speed Control

• 1.0 (Recommended) - Professional, easy to follow
• 0.9 - Slower, more emphasis
• 1.1 - Slightly faster

./scripts/script-to-video.sh script.txt --speed 1.0

Background Video

./scripts/script-to-video.sh script.txt \
  --bg-video public/corporate-bg.mp4 \
  --bg-opacity 0.3 \
  --bg-overlay "rgba(15, 20, 25, 0.6)"

Opacity recommendations:

• 0.2-0.3 - Subtle background, text-focused
• 0.3-0.4 - Balanced professional look (recommended)
• 0.4-0.5 - More visual background

Video Specifications

• Resolution: 1080 x 1920 (Portrait) - configurable for landscape
• Frame Rate: 30 fps
• Format: MP4 (H.264 + AAC)
• Style: Professional corporate
• Duration: Auto-calculated (typically 30-90 seconds)
• Color Scheme: Corporate Blue (#0078D7) + Financial Green (#00A86B)

Cost Analysis

Per 60-second IR video:

| Component | Cost | |-----------|------| | OpenAI TTS | ~$0.004 | | OpenAI Whisper | ~$0.008 | | Remotion Rendering | Free (local) | | Total | ~$0.012 |

Less than 2 cents per professional IR video!

Processing Time

For a typical 60-second video:

| Step | Time | |------|------| | TTS Generation | 5-10 sec | | Whisper Extraction | 10-20 sec | | Scene Conversion | <1 sec | | Video Rendering | 40-90 sec | | Total | 60-120 sec |

Project Structure

openclaw-investor-relations-manager/
├── agents/                      # AI Agent system
│   ├── ir-cli.sh               # CLI tool
│   ├── video-generator.json    # Agent config
│   └── tools.ts                # Tool functions
├── scripts/                     # Core pipeline scripts
│   ├── script-to-video.sh      # Complete pipeline
│   ├── tts-generate.sh         # TTS generation
│   ├── whisper-timestamps.sh   # Timestamp extraction
│   ├── timestamps-to-scenes.js # Scene conversion
│   ├── example-q3-earnings.txt # Example: Q3 earnings
│   ├── example-annual-report.txt # Example: Annual report
│   └── example-product-launch.txt # Example: Product launch
├── src/                         # Remotion source
│   ├── types.ts                # TypeScript types
│   ├── scenes-data.ts          # Scene data (auto-generated)
│   ├── CyberWireframe.tsx      # Main component
│   └── SceneRenderer.tsx       # Scene renderer
├── audio/                       # Audio files
├── out/                         # Output videos
└── public/                      # Public assets (backgrounds, etc.)

Best Practices for IR Videos

Content Guidelines

• Accuracy First - Always verify financial data before generation
• Clear Metrics - Use specific numbers (45%, $2.3B, 5M users)
• Professional Tone - Formal language appropriate for investors
• Key Highlights - Focus on material information
• Time Periods - Always specify quarters/years (Q3 2024)

Script Writing Tips

• Start with period/report type ("Q3 Earnings Report")
• Present metrics in logical order (revenue → profit → users)
• Use specific numbers and percentages
• Include year-over-year or quarter-over-quarter comparisons
• End with forward-looking statement or thank you

Voice Selection

• Quarterly Reports: alloy (neutral, professional)
• Annual Updates: echo or onyx (more authoritative)
• Product Launches: alloy or echo (clear communication)

Compliance & Legal

Important:

• This tool generates presentation videos only
• Users are responsible for data accuracy
• Always review content before distribution
• Ensure compliance with financial disclosure regulations (SEC, etc.)
• Consider legal review for material investor communications

Advanced Features

Custom Scene Colors

Edit src/types.ts to add financial metric colors:

color: '#00A86B'  // Financial green for positive metrics
color: '#DC3545'  // Red for challenges/risks

Multiple Language Support

The system supports both English and Chinese scripts automatically.

Batch Processing

for script in scripts/q*.txt; do
  ./scripts/script-to-video.sh "$script"
done

Troubleshooting

API Key Issues

# Check API key is set
echo $OPENAI_API_KEY

# Or use .env file (recommended)
echo 'OPENAI_API_KEY="sk-xxx"' > .env

Missing Dependencies

# Reinstall dependencies
npm install

# Verify tools
npx tsx --version
npx remotion --version

Rendering Issues

# Test in development mode
npm run dev
# Open http://localhost:3000

# Check logs
cat /tmp/remotion-*.log

Use Cases

• Quarterly Earnings Reports - Q1, Q2, Q3, Q4 updates
• Annual Shareholder Updates - Year-end summaries
• Product Launch Announcements - New revenue opportunities
• Business Milestone Communications - User growth, market expansion
• Financial Guidance Updates - Forecast changes
• M&A Announcements - Acquisitions, partnerships

Integration

OpenClaw Chat Integration

# Install as ClawHub skill
clawhub install investor-relations-manager

# Use in OpenClaw Chat
"Generate Q3 earnings video with our latest numbers"

API Integration

The tool can be integrated into existing IR workflows via command-line automation.

Support

• GitHub Issues: https://github.com/ZhenRobotics/openclaw-investor-relations-manager/issues
• Documentation: See QUICKSTART.md for quick start guide
• ClawHub: https://clawhub.ai/ZhenStaff/investor-relations-manager

License

MIT License - See LICENSE file for details

Credits

Built with:

• Remotion - React-based video generation
• OpenAI TTS - Professional text-to-speech
• OpenAI Whisper - Accurate speech recognition
• TypeScript - Type-safe development
• React - Component framework

Contributing

Contributions welcome! Please open an issue or PR on GitHub.

Professional Investor Relations Videos, Automated. 📊💼🎥