OBS Controller — OpenClaw Plugin

Control OBS Studio directly from OpenClaw chat. Switch scenes, start/stop streaming/recording, manage audio, toggle sources, save replays, trigger hotkeys — all through natural language.

Requirements

• OpenClaw gateway
• OBS Studio 28+ with obs-websocket enabled (Settings → WebSocket Server)

Install

clawhub install obs-controller

Then enable it in your OpenClaw config (openclaw.json):

{
  "plugins": {
    "allow": ["obs-controller"],
    "entries": {
      "obs-controller": {
        "config": {
          "host": "localhost",
          "port": 4455,
          "password": "your-obs-websocket-password"
        }
      }
    }
  }
}

If your agent's tool policy restricts tools, whitelist the obs_* tools in alsoAllow.

Configuration

Tools

Scenes

• obs_get_scenes — List all scenes
• obs_get_current_scene — Get active program scene
• obs_switch_scene — Switch to a scene by name

Streaming & Recording

• obs_start_stream / obs_stop_stream — Start/stop streaming
• obs_get_stream_status — Current stream state, bitrate, duration
• obs_start_recording / obs_stop_recording — Start/stop recording
• obs_get_recording_status — Current recording state
• obs_save_replay — Save replay buffer (instant highlight)
• obs_start_virtualcam / obs_stop_virtualcam — Virtual camera output

Audio

• obs_toggle_mute — Mute/unmute audio inputs
• obs_set_volume — Set input volume (0.0–1.0)

Sources & Items

• obs_get_scene_items — List sources in a scene
• obs_toggle_source — Show/hide scene sources

Transitions

• obs_trigger_transition — Trigger studio mode transition
• obs_get_transitions — List available transitions
• obs_set_transition — Set transition type

Other

• obs_get_stats — Performance stats (FPS, CPU, dropped frames)
• obs_get_version — OBS version info
• obs_trigger_hotkey — Trigger OBS hotkeys by name

Example Usage

You: Switch to Starting Soon
Kael: Switched to scene: Starting Soon

You: Start the stream
Kael: Stream started.

You: I'm done — switch to Thanks For Watching and stop the stream
Kael: Switched to scene: Thanks For Watching
Kael: Stream stopped.

License

MIT