ClawCast

SKILL.md

---
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

- `mcporter` installed/configured with `obs` MCP 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

```bash
mcporter list
mcporter call 'obs.get_obs_status()'
```

If this fails, stop and finish `mcporter` + OBS MCP configuration first.

## Workflow

1. Switch target OBS host
2. Start overlay HTTP server
3. Rebuild baseline scene pack from skill assets
4. Optionally apply transition + audio defaults
5. Run recording smoke walkthrough
6. Optionally run stream dry-run

## Commands

```bash
# 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 `/tmp` for 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.sh` serves only the skill directory (not workspace root).
- `obs_target_switch.sh` performs 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.md`
- `references/networking.md`
- `references/troubleshooting.md`
- `references/v0.2-features.md`