OpenClaw-ready

OpenClaw uses the same Luma Cloud API contract.

Set the public /v1 endpoint, a workspace API key, and a canonical model id. Keep private gateway, bridge, shard, and local OmniRoute details out of client-facing setup.

Step 1

Open API setup

Use the public Luma Cloud /v1 endpoint from App -> API. Local dev commands are only for internal smoke work, not for customer provider setup.

Step 2

Verify the branded endpoint

Call `https://api.lumaos.cloud/healthz` first, then sign in to `/app` so the current session gets a workspace-scoped starter key.

Step 3

Copy the workspace key

Open the customer app, sign in, and copy the included starter key from Home or Access. Do not rely on the shared local builder seed for onboarding.

Step 4

Configure an OpenAI-compatible client

Set `baseURL=https://api.lumaos.cloud/v1`, use the workspace key from `/app`, and start with model `gpt-5.5-medium` before switching to `gpt-5.5-xhigh`.

Step 5

Confirm request-id support

Keep the x-lumacloud-request-id or error.request_id from the first failed request. Support works from public ids, not from private bridge details.

Provider setup

Use the branded base URL exactly as the provider surface.

The client should only know Luma Cloud. OmniRoute, bridge hosts, and private topology remain hidden behind the gateway boundary.

Connection values

Local alpha defaults for the first OpenClaw-style provider hookup.

Base URL

https://api.lumaos.cloud/v1

Access key

Sign in to `/app` and copy the included starter key for the current workspace.

Health check

https://api.lumaos.cloud/healthz

Local alpha truth

What is already real versus what stays future work.

Already supported

OpenAI-compatible `chat.completions.create` shape
Bearer key auth with `lc_live_...` format
Model discovery via `GET /v1/models`
Streaming chat completion smoke path
Responses endpoint for SuperCodex-compatible clients
Route, billing, and quota telemetry in the `lumacloud` response block

Still intentionally missing

Multi-modal message blocks
Client-native provider listing
Full tool-call parity claim before current-client smoke