ClawHub
SkillsPluginsOfficialDocsSupport
K
plugins/djc00p/obs-controller
Media
#obs-get-current-scene#obs-get-recording-status#obs-get-scene-items#obs-get-scenes

OBS Controller

OpenClaw plugin to control OBS Studio via obs-websocket

Deonte Cooper@djc00p

OBS Controller — OpenClaw Plugin

ClawHub Plugin OpenClaw OBS Studio License: MIT

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.

⚠️ Important Safety Notice

This plugin gives your AI agent live control over OBS Studio. The tools it provides can start streams, stop recordings, change scenes during a broadcast, toggle sources, and trigger arbitrary hotkeys — all of which can immediately affect a live production.

  • Use tool allowlisting — only expose obs_* tools to agents you trust with production control
  • Configure confirmation rules for destructive actions (obs_start_stream, obs_stop_stream, obs_start_recording, obs_stop_recording, obs_trigger_hotkey) if you want a human in the loop
  • Set a strong OBS WebSocket password — this plugin connects to your local OBS instance via WebSocket; anyone with access to that port can control your stream
  • Use TLS for anything that is not loopback — OBS's WebSocket protocol does not encrypt traffic or authenticate the server, so a plaintext remote connection can be read and modified in transit. See Transport Security
  • Be aware of prompt injection risk — if an agent can trigger OBS actions based on chat input, untrusted content could theoretically induce scene switches or stream state changes

These tools are powerful on purpose. Use them with the same caution you'd use for any live-production control surface.

Requirements

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

Install

bash
clawhub install obs-controller

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

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

KeyDefaultDescription
hostlocalhostOBS WebSocket host
port4455OBS WebSocket port
password""WebSocket password (set in OBS → Settings → WebSocket Server)
reconnectIntervalMs5000Reconnect delay on disconnect
securefalseUse wss:// (TLS) instead of ws://. Required for any non-loopback host.
allowInsecureRemotefalseAllow an unencrypted ws:// connection to a non-loopback host. See the warning below.
rejectUnauthorizedtrueVerify the TLS certificate chain and hostname on a wss:// connection
ca—PEM-encoded CA certificate, for a private PKI the system does not already trust

Every key can also be set through the environment: OBS_WEBSOCKET_HOST, OBS_WEBSOCKET_PORT, OBS_WEBSOCKET_PASSWORD, OBS_RECONNECT_MS, OBS_WEBSOCKET_SECURE, OBS_ALLOW_INSECURE_REMOTE, OBS_TLS_REJECT_UNAUTHORIZED, OBS_TLS_CA.


🔒 Transport Security

OBS's WebSocket protocol is not encrypted, and its password challenge does not authenticate the server. The client proves it knows the password; the server never proves it is really OBS. Over a plaintext ws:// connection that is not loopback, anyone on the network path can relay the handshake, then read or rewrite every control message — including scene switches, stream commands, and hotkeys.

What the plugin does

HostTransportBehavior
localhost / 127.0.0.1ws://Allowed. The traffic never leaves the machine.
Any hostws://Refused unless allowInsecureRemote: true.
Any hostwss://Allowed, with certificate and hostname verification on.

A refused connection fails fast with an explanatory error and does not enter the reconnect loop — a configuration that cannot succeed will not spin.

Connecting to a remote OBS over TLS

Put OBS behind a TLS reverse proxy or an authenticated tunnel, then:

json
{
  "plugins": {
    "entries": {
      "obs-controller": {
        "config": {
          "host": "obs.example.com",
          "port": 443,
          "password": "your-obs-websocket-password",
          "secure": true
        }
      }
    }
  }
}

Certificate and hostname verification stay on. If your endpoint uses a private PKI, supply the CA explicitly:

json
{ "secure": true, "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----" }

Do not set rejectUnauthorized: false to work around a certificate problem — fix the certificate instead.

If you must use plaintext remotely

Set allowInsecureRemote: true and understand what you are accepting: every OBS control message is readable and modifiable by anyone on the path. If you do this, also firewall the OBS port to the agent host and use a strong OBS password.

Tests

bash
node test-transport.mjs          # 27 policy and config tests
node test-transport-live.mjs      # 6 live TLS tests against a local server

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

text
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

Install

$
openclaw plugins install clawhub:@djc00p/obs-controller
Downloads
Repository
djc00p/openclaw-obs-controller
Security audit
Pass
Last updated
2d ago
Current version
v0.1.5
Type
Code Plugin
Download
ClawHub

Skills and plugins for OpenClaw agents. Part of the wider OpenClaw ecosystem.

Explore docs

SkillsPluginsOfficialAudits

Publish SkillPublish PluginCreate org

OverviewOpenClawDocsBlog

SupportGitHubDiscord

Built alongside the OpenClaw ecosystem

LobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projectsLobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projects

© 2026 OpenClaw Foundation

Privacy policy·Status·Deployed on Vercel·Powered by Convex

....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals