OpenAI Codex lets you use your existing ChatGPT Plus or Pro subscription as the AI provider for your OpenClaw agent — no separate API key or billing required. xCloud includes a built-in Codex OAuth token generator that handles the authentication flow securely inside the dashboard.

Follow the steps below to connect OpenAI Codex to xCloud easily.

Step 1: Open the OpenClaw Provider Settings #

Log in to your xCloud OpenClaw dashboard. Navigate to your Site → OpenClaw → Providers. In the OpenClaw Configuration panel, look for the AI provider selector. 

If you are creating the new OpenClaw instance, just choose the ‘OpenAI Codex – CHATGPT OAuth’ from the ‘AI Provider dropdown menu.

Step 2: Set up Your OAuth Token #

Next, you can to set up OpenAI Codex in just a few clicks. Click on the ‘Generate Token’ link to proceed.

Step 3: Generate Your OAuth Token #

You will be redirected to the integration page of OpenAI Codex page.
Read the ‘How It Works’ informations carefully. And click on the ‘Connect with OpenAI’ button. Sign in to your OpenAI account (ChatGPT Plus or Pro required). After redirect, copy the full URL from your browser address bar and paste that URL in the box below and submit.

Note: If your browser blocks the redirect to localhost, you will need to manually copy the URL from the address bar after the redirect attempt. The URL will still be visible even if the page doesn’t load.

Step 4: Paste the Callback URL and Get Your Token #

Return to the xCloud tab with the OpenClaw configuration. Paste the full callback URL into the input field provided. Click Submit. xCloud will process the OAuth exchange and display your generated token

The generated token will be automatically populated into the Codex provider field. Confirm your provider configuration looks correct. Click Create (or Save) to apply the configuration to your OpenClaw server

Your OpenClaw agent will now use OpenAI Codex (backed by your ChatGPT Plus/Pro subscription) as its AI provider.

Troubleshooting #

• The redirect URL doesn’t start with http://localhost:1455/auth/callback Make sure you clicked Connect with OpenAI from inside the xCloud dashboard — do not navigate to the OAuth URL manually. If the URL looks different, try the process again from the beginning.
• “ChatGPT Plus or Pro required” error OpenAI Codex OAuth requires an active paid ChatGPT subscription. Free accounts do not have access to the Codex API. Upgrade your OpenAI plan or use a different provider (e.g., Anthropic Claude, Gemini).
• Signed in with the wrong OpenAI account Log out of your OpenAI account in the browser tab that opened, then sign in with the correct account. Restart from Step 3.
• Token was generated but agent isn’t responding Check that the token was saved correctly by revisiting Site → OpenClaw → Providers. If the field is empty, repeat Steps 3–5. Also verify your OpenClaw server is running and connected.
• Browser blocks the localhost redirect Some strict browser configurations block localhost redirects. Switch to a standard Chrome, Firefox, or Edge browser without strict security extensions, or temporarily disable HTTPS-only mode.