Realtime voice

​

Requirements

• A realtime voice provider plugin (e.g. @wednesdayai/voice-openai)
• A channel with voice support (currently: Discord voice channels)

​

Quick start

openclaw plugins install @wednesdayai/voice-openai

plugins:
  voice-openai:
    apiKey: ""   # or OPENAI_API_KEY
    model: "gpt-4o-realtime-preview"
    voice: "alloy"

channels:
  discord:
    voice:
      enabled: true
      provider: "voice-openai"

openclaw restart

​

Configuration reference

channels:
  discord:
    voice:
      enabled: false
      provider: ""
      vad:
        sensitivity: 0.5    # 0–1; higher = less noise-sensitive
        silenceMs: 800      # ms of silence to end a turn
      maxSessionMinutes: 60
      requirePermission: false

​

Session observability

• Status RPC — talk.realtime.status (requires the operator.read scope) returns every active gateway-relay session with provider, owning connection, start time, duration, and audio bytes in/out.
• Relay events — the gateway broadcasts talk.realtime.relay events to the owning connection: ready, transcript (user/assistant, partial or final), toolCall, vadBargeIn, clear, mark, audio, error, and close with a close reason.
• Gateway logs — the gateway/talk-realtime-relay subsystem logs each relay session end with its id, duration, close reason, and audio byte counts (journalctl --user -u openclaw-gateway on Linux).

​

Troubleshooting