OpenAI-chatvoltooiingen

​

Het endpoint inschakelen

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

​

Beveiligingsgrens (belangrijk)

• Een geldig Gateway-token/wachtwoord voor dit endpoint is gelijkwaardig aan een referentie voor een eigenaar/operator, niet aan een beperkt bereik per gebruiker.
• Verzoeken doorlopen hetzelfde agentpad in het besturingsvlak als vertrouwde operatoracties. Als het beleid van de doelagent gevoelige tools toestaat, kan dit endpoint deze dus gebruiken.
• Houd het uitsluitend op loopback/tailnet/privé-ingress. Stel het niet bloot aan het openbare internet.

​

Authenticatie

• Aanroepers op dezelfde host die de proxy op een trusted-proxy-Gateway omzeilen, kunnen rechtstreeks terugvallen op gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD. Bewijs in een Forwarded-, X-Forwarded-*- of X-Real-IP-header houdt het verzoek in plaats daarvan op het trusted-proxy-pad.
• Als gateway.auth.rateLimit is geconfigureerd en te veel authenticatiepogingen mislukken, retourneert het endpoint 429 met een Retry-After-header.

​

Wanneer je dit endpoint gebruikt

• Geef hieraan de voorkeur boven het toevoegen van een nieuw ingebouwd kanaal wanneer je integratie slechts een ander operator-/clientoppervlak voor dezelfde Gateway is.
• Geef voor native mobiele clients die rechtstreeks met een externe Gateway verbinden de voorkeur aan WebChat of het Gateway-protocol met de bootstrap-/apparaat-tokenflow voor gekoppelde apparaten, zodat het apparaat geen gedeeld HTTP-token/wachtwoord nodig heeft.
• Bouw in plaats daarvan een kanaalplugin wanneer je een extern berichtenplatform integreert met eigen gebruikers, ruimtes, Webhook-bezorging of uitgaand transport. Zie Plugins bouwen.

​

Agent-eerst-modelcontract

​

Sessiegedrag

​

Verzoeklimieten

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: {
          enabled: true,
          images: {
            allowUrl: false,
            urlAllowlist: ["cdn.example.com", "*.assets.example.com"],
            allowedMimes: [
              "image/jpeg",
              "image/png",
              "image/gif",
              "image/webp",
              "image/heic",
              "image/heif",
            ],
            maxBytes: 10485760,
            maxRedirects: 3,
            timeoutMs: 10000,
          },
        },
      },
    },
  },
}

​

Contract voor chattools

​

Ondersteunde verzoekvelden

• Tokenlimiet: de veldnaam op de verbinding wordt gekozen door het providertransport: max_completion_tokens voor eindpunten uit de OpenAI-familie, max_tokens voor providers die alleen de verouderde naam accepteren (Mistral, Chutes).
• stop wordt gekoppeld aan het stopveld van het transport: stop voor Chat Completions-backends, stop_sequences voor Anthropic. De OpenAI Responses-API heeft geen stopparameter, dus stop wordt niet toegepast op modellen die door Responses worden ondersteund.
• De op ChatGPT gebaseerde Codex Responses-backend gebruikt vaste sampling aan de serverzijde en verwijdert temperature/top_p (samen met max_output_tokens, metadata, prompt_cache_retention, service_tier) voordat de aanvraag die backend bereikt.

​

Niet-ondersteunde varianten

• tools die geen array is, toolitems die geen functie zijn, of ontbrekende tool.function.name
• tool_choice-varianten zoals allowed_tools en custom
• tool_choice.function.name-waarden die niet overeenkomen met een opgegeven tool

​

Vorm van niet-streamend toolantwoord

• choices[0].finish_reason = "tool_calls"
• choices[0].message.tool_calls[]-items met id, type: "function", function.name, function.arguments (JSON-tekenreeks)
• Commentaar van de assistent vóór de toolaanroep, in choices[0].message.content (mogelijk leeg)

​

Vorm van streamend toolantwoord

​

Vervolglus voor tools

​

Streaming (SSE)

• Content-Type: text/event-stream
• Elke gebeurtenisregel is data: <json>
• De stream eindigt met data: [DONE]

​

Snelle installatie van Open WebUI

• Basis-URL: http://127.0.0.1:18789/v1
• Basis-URL voor Docker op macOS: http://host.docker.internal:18789/v1
• API-sleutel: je bearer-token voor de Gateway
• Model: openclaw/default

curl -sS http://127.0.0.1:18789/v1/models \
  -H 'Authorization: Bearer YOUR_TOKEN'

​

Voorbeelden

curl -sS http://127.0.0.1:18789/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "openclaw/default",
    "user": "conv:YOUR_CONVERSATION_ID",
    "messages": [{"role":"user","content":"Vat mijn taken voor vandaag samen"}]
  }'

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

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

curl -sS http://127.0.0.1:18789/v1/models \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -sS http://127.0.0.1:18789/v1/models/openclaw%2Fdefault \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -sS http://127.0.0.1:18789/v1/embeddings \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'x-openclaw-model: openai/text-embedding-3-small' \
  -d '{
    "model": "openclaw/default",
    "input": ["alpha", "beta"]
  }'

​

Gerelateerd

• Configuratiereferentie
• Operatorbereiken
• OpenAI