Чат-завершения OpenAI

​

Включение конечной точки

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

​

Граница безопасности (важно)

• Действительный токен/пароль Gateway для этой конечной точки эквивалентен учетным данным владельца/оператора, а не узкой области доступа отдельного пользователя.
• Запросы проходят по тому же пути агента плоскости управления, что и доверенные действия оператора, поэтому, если политика целевого агента разрешает чувствительные инструменты, эта конечная точка может их использовать.
• Оставляйте ее доступной только через loopback-интерфейс, tailnet или частную точку входа. Не предоставляйте к ней доступ из общедоступного интернета.

​

Аутентификация

• Клиенты на том же хосте, обходящие прокси для Gateway с trusted-proxy, могут напрямую использовать в качестве резервного варианта gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD. Наличие данных в любом из заголовков Forwarded, X-Forwarded-* или X-Real-IP сохраняет обработку запроса по пути доверенного прокси.
• Если настроен gateway.auth.rateLimit и происходит слишком много неудачных попыток аутентификации, конечная точка возвращает 429 с заголовком Retry-After.

​

Когда использовать эту конечную точку

• Предпочитайте ее добавлению нового встроенного канала, если ваша интеграция представляет собой лишь еще один операторский/клиентский интерфейс для того же Gateway.
• Для нативных мобильных клиентов, напрямую подключающихся к удаленному Gateway, предпочитайте WebChat или протокол Gateway с начальной настройкой сопряженного устройства и потоком токенов устройства, чтобы устройству не требовался общий HTTP-токен/пароль.
• Вместо этого создайте плагин канала, если интегрируете внешнюю сеть обмена сообщениями с собственными пользователями, комнатами, доставкой через Webhook или исходящим транспортом. См. Создание плагинов.

​

Контракт модели с приоритетом агента

​

Поведение сеанса

​

Ограничения запросов (конфигурация)

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: {
          enabled: true,
          maxBodyBytes: 20000000,
          maxImageParts: 8,
          maxTotalImageBytes: 20000000,
          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,
          },
        },
      },
    },
  },
}

​

Контракт инструмента чата

​

Поддерживаемые поля запроса

• Ограничение токенов: имя поля в протоколе выбирается транспортом провайдера: max_completion_tokens для конечных точек семейства OpenAI, max_tokens для провайдеров, принимающих только устаревшее имя (Mistral, Chutes).
• stop сопоставляется с полем остановки транспорта: stop для серверных реализаций Chat Completions, stop_sequences для Anthropic. В OpenAI Responses API параметр остановки отсутствует, поэтому stop не применяется для моделей на базе Responses.
• Серверная реализация Codex Responses на базе ChatGPT использует фиксированное серверное семплирование и удаляет temperature/top_p (вместе с max_output_tokens, metadata, prompt_cache_retention, service_tier) до того, как запрос поступает в эту серверную реализацию.

​

Неподдерживаемые варианты

• значения tools, не являющегося массивом, элементов инструментов, не являющихся функциями, или отсутствующего tool.function.name
• вариантов tool_choice, таких как allowed_tools и custom
• значений tool_choice.function.name, не соответствующих предоставленному инструменту

​

Формат непотокового ответа инструмента

• choices[0].finish_reason = "tool_calls"
• элементы choices[0].message.tool_calls[] с id, type: "function", function.name, function.arguments (строка JSON)
• Комментарий ассистента перед вызовом инструмента в choices[0].message.content (возможно, пустой)

​

Формат потокового ответа инструмента

​

Цикл последующих вызовов инструмента

​

Потоковая передача (SSE)

• Content-Type: text/event-stream
• Каждая строка события имеет вид data: <json>
• Поток завершается значением data: [DONE]

​

Быстрая настройка Open WebUI

• Базовый URL: http://127.0.0.1:18789/v1
• Базовый URL Docker в macOS: http://host.docker.internal:18789/v1
• Ключ API: ваш bearer-токен Gateway
• Модель: openclaw/default

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

​

Примеры

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":"Составь сводку моих задач на сегодня"}]
  }'

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":"привет"}]
  }'

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":"привет"}]
  }'

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": ["альфа", "бета"]
  }'

​

Связанные разделы

• Справочник по конфигурации
• Области доступа оператора
• OpenAI