openstoryline-use

Operates OpenStoryline services to edit videos through natural language conversation sessions.

3.4k|400|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/FireRedTeam/FireRed-OpenStoryline --skill openstoryline-use-fireredteam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openstoryline-use
Source: https://github.com/FireRedTeam/FireRed-OpenStoryline/tree/main/.claude/skills/openstoryline-use
Command: npx skills add https://github.com/FireRedTeam/FireRed-OpenStoryline --skill openstoryline-use-fireredteam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires websockets, requests, and includes scripts (resource) components.

What problem does it solve? Once OpenStoryline is installed, users still face a multi-step operational burden: configuring model credentials, starting the MCP and Web services, creating sessions, uploading media, and driving multi-turn editing conversations. This Skill automates that entire loop so users can go from raw footage to a rendered video using plain-language instructions. ## Core Features & Use Cases - Service Orchestration: Configures config.toml fields (LLM/VLM credentials, TTS providers, Pexels search) and launches the MCP server and uvicorn Web service as long-running processes with log monitoring. - Session-Based Editing: Creates a session, uploads media, sends editing prompts via a WebSocket bridge script, and preserves the session_id for multi-turn re-editing that produces new output_*.mp4 files. - Output Verification & Delivery: Locates rendered videos in the server cache and can send them to users through Feishu using the bundled sender script. - Use Case: A user asks to "cut a Xiaohongshu-style video" from local clips; the Skill starts the services, creates a session, runs the edit, verifies the output MP4, then applies follow-up requests like "use a more upbeat BGM" on the same session. ## Quick Start Start OpenStoryline and use it to edit my video clips in /path/to/media into a short social-media style video.

Frequently Asked Questions about openstoryline-use

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start OpenStoryline and edit a video with natural language?▼

Configure the six required LLM/VLM fields in config.toml, start the MCP server and the uvicorn Web service on 127.0.0.1, create a session via the API, upload your media, then send editing prompts through the bridge script. The rendered video appears as output_*.mp4 in the session cache.

How do I re-edit a video in the same OpenStoryline session?▼

Reuse the session_id returned when the session was created and send a new prompt through bridge_openstoryline.py, such as changing the copy style or BGM. The system reruns the relevant nodes and renders a new output_*.mp4 in a new render_video directory under the same session.

What configuration is required before OpenStoryline can edit videos?▼

Six fields must be set in config.toml: model, base_url, and api_key for both the [llm] and [vlm] sections. Optional settings include the MCP port, a Pexels API key for media search, and one TTS provider (minimax, bytedance, or 302) for voiceover generation.

Why does the OpenStoryline MCP server seem stuck at startup?▼

MCP server startup can take several minutes, so do not kill the process prematurely. Run it as a long-lived process and poll its logs until you see the Uvicorn running message; also watch the Web service logs for progress nodes like filter_clips and render_video.

Can OpenStoryline send the rendered video to Feishu?▼

Yes, the bundled feishu_file_sender.py script uploads the MP4 and sends it as a file message using credentials read from ~/.openclaw/openclaw.json. Provide a receive_id such as a chat_id (oc_ prefix) or open_id (ou_ prefix), and the type is auto-detected.

Does this Skill handle OpenStoryline installation and model downloads?▼

No, it only covers usage and editing after installation is complete. Dependency installation, model downloads, and resource setup belong to the separate openstoryline-install skill, which you should consult if startup failures suggest an installation problem.