@vibevideo/openclaw-storyboard

OpenClaw plugin + skill for generating storyboard only (分镜脚本), powered by existing backend APIs:

• POST /scripts/create_async
• GET /board?video_id=... (polling)

It does not generate downstream assets (image prompts, video prompts, TTS, editing timeline).

Install in OpenClaw

openclaw plugins install @vibevideo/openclaw-storyboard
openclaw plugins enable openclaw-storyboard

Global npm auto-setup

When users run:

npm install -g @vibevideo/openclaw-storyboard

the package postinstall tries to auto-run:

• openclaw plugins install --link <global-package-path>
• openclaw plugins enable openclaw-storyboard

Notes:

• It only auto-runs for global install.
• If OpenClaw CLI is missing, install still succeeds and setup is skipped.
• Disable auto-setup with OPENCLAW_STORYBOARD_AUTO_SETUP=0.

Setup auth (recommended: file provider)

1. Save token:

mkdir -p ~/.openclaw/secrets
chmod 700 ~/.openclaw/secrets
printf '%s' '<OPENCLAW_AUTH_TOKEN>' > ~/.openclaw/secrets/storyboard.token
chmod 600 ~/.openclaw/secrets/storyboard.token

2. Bind skill credential:

openclaw config set secrets.providers.storyboard_file "{\"source\":\"file\",\"path\":\"$HOME/.openclaw/secrets/storyboard.token\",\"mode\":\"singleValue\"}" --strict-json
openclaw config set skills.entries.storyboard.apiKey '{"source":"file","provider":"storyboard_file","id":"value"}' --strict-json
openclaw secrets reload

3. Optional API base override:

openclaw config set skills.entries.storyboard.env.STORYBOARD_API_BASE '"http://localhost:30003/api"'

4. Verify:

openclaw skills info storyboard
openclaw secrets audit

Expected:

• storyboard is Ready
• no REF_UNRESOLVED for skills.entries.storyboard.apiKey

Local CLI usage

openclaw-storyboard --text "一个女孩在雨夜追踪旧录音带，最终在天台找到真相" --shots 6 --locale zh

Or in this repo:

npm --prefix packages/storyboard run storyboard -- --text "..." --shots 6 --locale zh