- name
- clawcast
- description
- Bootstrap and automate OBS scenes for local or remote instances via agentic-obs + mcporter. Includes optional explicit target-switch step that writes agentic-obs DB config only when acknowledged with a cross-component-write flag. Use when an OpenClaw agent needs to create a reusable baseline scene pack, wire browser/media sources over LAN-safe HTTP, run recording/stream smoke tests, and provide a clean starting point for project-specific customization.
- metadata
- {"openclaw":{"emoji":"🎬","homepage":"https://github.com/ironystock/clawcast","requires":{"bins":["mcporter","python3","sqlite3","ss"]}}}
ClawCast
Use this skill to create a generic, reusable OBS automation baseline.
Prerequisites
mcporterinstalled/configured withobsMCP server- OBS WebSocket enabled on target OBS host (default
4455) python3,sqlite3,ss(iproute2), and standard shell tools
Prerequisite 0 (required): verify obs MCP path
mcporter list
mcporter call 'obs.get_obs_status()'If this fails, stop and finish mcporter + OBS MCP configuration first.
Workflow
- Switch target OBS host
- Start overlay HTTP server
- Rebuild baseline scene pack from skill assets
- Optionally apply transition + audio defaults
- Run recording smoke walkthrough
- Optionally run stream dry-run
Commands
# 1) Target OBS host (explicit write acknowledgement + DB path required)
./skills/clawcast/scripts/obs_target_switch.sh <obs-host-ip> 4455 \
"$HOME/.agentic-obs/db.sqlite" --allow-cross-component-write
# 2) Start/verify overlay host server (serves skill directory only)
./skills/clawcast/scripts/start_overlay_server.sh
# 3) Rebuild baseline scenes + overlays
./skills/clawcast/scripts/rebuild_scenes.sh
# 4) Apply transition preset
./skills/clawcast/scripts/apply_transition_preset.sh Fade 300
# 5) Optional audio baseline
# export OBS_AUDIO_INPUTS="Mic/Aux,Desktop Audio"
./skills/clawcast/scripts/apply_audio_baseline.sh
# 6) Run walkthrough recording
./skills/clawcast/scripts/smoke_test_walkthrough.sh
# 7) Optional stream dry-run
./skills/clawcast/scripts/stream_dry_run.sh 15 "Intro" "Main Live"Notes
- This skill is boilerplate-first; customize scenes and assets after bootstrap.
- Baseline-required overlays live in
assets/overlays/. - Optional project-specific examples live in
examples/project-specific/. - Avoid
/tmpfor persistent assets. - For remote OBS, prefer HTTP browser source URLs over
file://.
Security & transmission
- No API keys/tokens are required by default for this skill.
- OBS control uses the configured WebSocket endpoint (default port
4455). - Overlay pages are served over local HTTP (
:8787) and should remain on trusted LAN/VPN. start_overlay_server.shserves only the skill directory (not workspace root).obs_target_switch.shperforms a cross-component config write only when given an explicit DB path argument plus--allow-cross-component-write.- Do not expose OBS WebSocket or overlay HTTP ports publicly.
References
references/scene-map.mdreferences/networking.mdreferences/troubleshooting.mdreferences/v0.2-features.md