OpenAI Chat Completions (HTTP)¶

OpenClaws Gateway kan levere et lille OpenAI-kompatibelt Chat Completions-endpoint.

Dette endepunkt er deaktiveret som standard. Aktiver det i config først.

• POST /v1/chat/completions
• Samme port som Gateway (WS + HTTP-multiplex): http://<gateway-host>:<port>/v1/chat/completions

Under motorhjelmen udføres anmodninger som en normal Gateway agent-kørsel (samme kodevej som openclaw agent), så routing/tilladelser/konfiguration matcher din Gateway.

Autentificering¶

Bruger Gateway auth konfiguration. Send et bærer-token:

• Authorization: Bearer <token>

Noter:

• Når gateway.auth.mode="token", brug gateway.auth.token (eller OPENCLAW_GATEWAY_TOKEN).
• Når gateway.auth.mode="password", brug gateway.auth.password (eller OPENCLAW_GATEWAY_PASSWORD).

Valg af agent¶

Ingen brugerdefinerede headers kræves: kod agent-id’et i OpenAI-feltet model:

• model: "openclaw:<agentId>" (eksempel: "openclaw:main", "openclaw:beta")
• model: "agent:<agentId>" (alias)

Eller målret en specifik OpenClaw-agent via header:

• x-openclaw-agent-id: <agentId> (standard: main)

Avanceret:

• x-openclaw-session-key: <sessionKey> for fuld kontrol over session-routing.

Aktivering af endpointet¶

Sæt gateway.http.endpoints.chatCompletions.enabled til true:

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: true },
      },
    },
  },
}

Deaktivering af endpointet¶

Sæt gateway.http.endpoints.chatCompletions.enabled til false:

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: false },
      },
    },
  },
}

Session-adfærd¶

Som standard er endpointet tilstandsløst pr. anmodning (der genereres en ny sessionsnøgle for hvert kald).

Hvis anmodningen indeholder en OpenAI user-streng, udleder Gateway en stabil sessionsnøgle fra den, så gentagne kald kan dele en agent-session.

Streaming (SSE)¶

Sæt stream: true for at modtage Server-Sent Events (SSE):

• Content-Type: text/event-stream
• Hver eventlinje er data: <json>
• Streamen slutter med data: [DONE]

Eksempler¶

Ikke-streaming:

curl -sS http://127.0.0.1:18789/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'x-openclaw-agent-id: main' \
  -d '{
    "model": "openclaw",
    "messages": [{"role":"user","content":"hi"}]
  }'

Streaming:

curl -N http://127.0.0.1:18789/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'x-openclaw-agent-id: main' \
  -d '{
    "model": "openclaw",
    "stream": true,
    "messages": [{"role":"user","content":"hi"}]
  }'