Przejdź do głównej treści

​
OpenAI Chat Completions (HTTP)

Gateway OpenClaw może udostępniać niewielki, zgodny z OpenAI punkt końcowy Chat Completions. Ten punkt końcowy jest domyślnie wyłączony. Najpierw włącz go w konfiguracji.
  • POST /v1/chat/completions
  • Ten sam port co Gateway (multipleks WS + HTTP): http://<gateway-host>:<port>/v1/chat/completions
Pod spodem żądania są wykonywane jako zwykłe uruchomienie agenta Gateway (ta sama ścieżka kodu co openclaw agent), więc routing/uprawnienia/konfiguracja odpowiadają Twojemu Gateway.

​
Uwierzytelnianie

Korzysta z konfiguracji uwierzytelniania Gateway. Wyślij token typu bearer:
  • Authorization: Bearer <token>
Uwagi:
  • Gdy gateway.auth.mode="token", użyj gateway.auth.token (lub OPENCLAW_GATEWAY_TOKEN).
  • Gdy gateway.auth.mode="password", użyj gateway.auth.password (lub OPENCLAW_GATEWAY_PASSWORD).
  • Jeśli skonfigurowano gateway.auth.rateLimit i wystąpi zbyt wiele błędów uwierzytelniania, endpoint zwraca 429 z nagłówkiem Retry-After.

​
Wybór agenta

Nie są wymagane niestandardowe nagłówki: zakoduj identyfikator agenta w polu OpenAI model:
  • model: "openclaw:<agentId>" (przykład: "openclaw:main", "openclaw:beta")
  • model: "agent:<agentId>" (alias)
Albo wskaż konkretny agent OpenClaw za pomocą nagłówka:
  • x-openclaw-agent-id: <agentId> (domyślnie: main)
Zaawansowane:
  • x-openclaw-session-key: <sessionKey> w celu pełnej kontroli routingu sesji.

​
Włączanie punktu końcowego

Ustaw gateway.http.endpoints.chatCompletions.enabled na true: 
{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: true },
      },
    },
  },
}

​
Wyłączanie punktu końcowego

Ustaw gateway.http.endpoints.chatCompletions.enabled na false: 
{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: false },
      },
    },
  },
}

​
Zachowanie sesji

Domyślnie punkt końcowy jest bezstanowy dla każdego żądania (dla każdego wywołania generowany jest nowy klucz sesji). Jeśli żądanie zawiera ciąg OpenAI user, Gateway wyprowadza z niego stabilny klucz sesji, dzięki czemu powtarzane wywołania mogą współdzielić sesję agenta.

​
Strumieniowanie (SSE)

Ustaw stream: true, aby otrzymywać zdarzenia Server-Sent Events (SSE):
  • Content-Type: text/event-stream
  • Każda linia zdarzenia to data: <json>
  • Strumień kończy się data: [DONE]

​
Przykłady

Bez strumieniowania: 
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"}]
  }'
Strumieniowanie: 
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"}]
  }'