使用此技能创建通用的、可复用的 OBS 自动化基线。
前置条件
- 已安装/配置好带有
obs MCP 服务器的 mcporter
- 目标 OBS 主机上已启用 OBS WebSocket（默认
4455）
python3、sqlite3、ss（iproute2）和标准 shell 工具
前置条件 0（必需）：验证 obs MCP 路径
mcporter list
mcporter call 'obs.get_obs_status()'
如果此步骤失败，请先完成 mcporter + OBS MCP 配置。
工作流
- 切换目标 OBS 主机
- 启动覆盖层 HTTP 服务器
- 从技能资产重建基线场景包
- 可选应用转场 + 音频默认值
- 运行录制冒烟测试
- 可选运行推流试运行
命令
# 1) 目标 OBS 主机（需要显式写入确认 + 数据库路径）
./skills/clawcast/scripts/obs_target_switch.sh 4455 \
"$HOME/.agentic-obs/db.sqlite" --allow-cross-component-write# 2) 启动/验证覆盖层主机服务器（仅提供技能目录）
./skills/clawcast/scripts/start_overlay_server.sh
# 3) 重建基线场景 + 覆盖层
./skills/clawcast/scripts/rebuild_scenes.sh
# 4) 应用转场预设
./skills/clawcast/scripts/apply_transition_preset.sh Fade 300
# 5) 可选音频基线
# export OBS_AUDIO_INPUTS="Mic/Aux,Desktop Audio"
./skills/clawcast/scripts/apply_audio_baseline.sh
# 6) 运行录制演练
./skills/clawcast/scripts/smoke_test_walkthrough.sh
# 7) 可选推流试运行
./skills/clawcast/scripts/stream_dry_run.sh 15 "Intro" "Main Live"
注意事项
- 此技能以样板优先；在引导后自定义场景和资产。
- 基线所需的覆盖层位于
assets/overlays/。
- 可选的项目特定示例位于
examples/project-specific/。
- 避免使用
/tmp 存储持久资产。
- 对于远程 OBS，优先使用 HTTP 浏览器源 URL 而非
file://。
安全与传输
- 默认情况下此技能不需要 API 密钥/令牌。
- OBS 控制使用配置的 WebSocket 端点（默认端口
4455）。
- 覆盖层页面通过本地 HTTP（
:8787）提供，应保持在可信的 LAN/VPN 上。
start_overlay_server.sh 仅提供技能目录（而非工作区根目录）。obs_target_switch.sh 仅在给出显式数据库路径参数加上 --allow-cross-component-write 时执行跨组件配置写入。- 不要公开暴露 OBS WebSocket 或覆盖层 HTTP 端口。
参考资料
references/scene-map.mdreferences/networking.mdreferences/troubleshooting.mdreferences/v0.2-features.md
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
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 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.mdreferences/networking.mdreferences/troubleshooting.mdreferences/v0.2-features.md
by