Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix bug(talk): OpenAI Realtime Beta endpoint shutdown (beta_api_shape_disabled)

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

When trying to use the Talk mode (realtime voice) with OpenAI, the gateway fails immediately with HTTP 400 and the following error code:

{
  "error": {
    "message": "The Realtime Beta API is no longer supported. Please use /v1/realtime for the GA API.",
    "type": "invalid_request_error",
    "param": null,
    "code": "beta_api_shape_disabled"
  }
}

Error Message

When trying to use the Talk mode (realtime voice) with OpenAI, the gateway fails immediately with HTTP 400 and the following error code: "error": { 3. Observe the "Permission denied" error or immediate connection close.

Root Cause

OpenClaw is still hardcoded to request ephemeral client WebRTC secrets via POST https://api.openai.com/v1/realtime/sessions (the old beta endpoint shape). OpenAI has fully deprecated and disabled this endpoint shape, instructing developers to use /v1/realtime directly.

Code Example

{
  "error": {
    "message": "The Realtime Beta API is no longer supported. Please use /v1/realtime for the GA API.",
    "type": "invalid_request_error",
    "param": null,
    "code": "beta_api_shape_disabled"
  }
}
RAW_BUFFERClick to expand / collapse

Description

When trying to use the Talk mode (realtime voice) with OpenAI, the gateway fails immediately with HTTP 400 and the following error code:

{
  "error": {
    "message": "The Realtime Beta API is no longer supported. Please use /v1/realtime for the GA API.",
    "type": "invalid_request_error",
    "param": null,
    "code": "beta_api_shape_disabled"
  }
}

Steps to Reproduce

  1. Configure talk.realtime.provider: "openai" in openclaw.json.
  2. Attempt to start a Talk session in the Control UI.
  3. Observe the "Permission denied" error or immediate connection close.

Cause

OpenClaw is still hardcoded to request ephemeral client WebRTC secrets via POST https://api.openai.com/v1/realtime/sessions (the old beta endpoint shape). OpenAI has fully deprecated and disabled this endpoint shape, instructing developers to use /v1/realtime directly.

A Touch of Irony 😉

There is a beautiful, chef-kiss level of irony here: OpenClaw's primary creator (Peter Steinberger) now works at OpenAI. Yet, OpenAI went ahead and unilaterally turned off the exact Realtime Beta API endpoint that OpenClaw depends on to function, without updating OpenClaw's implementation first!

It seems the left hand at OpenAI is currently not keeping track of what the right hand's favorite open-source AI project is doing.

Suggested Fix

Update the OpenAI Realtime connector inside the Gateway to use the new GA API endpoint structure (/v1/realtime WebSocket/WebRTC connection flow) rather than trying to mint session tokens via the deprecated /v1/realtime/sessions endpoint.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING