OpenAI チャット補完

​

エンドポイントの有効化

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

​

セキュリティ境界（重要）

• このエンドポイントに対する有効な Gateway トークン／パスワードは、限定されたユーザー単位のスコープではなく、所有者／オペレーターの認証情報に相当します。
• リクエストは、信頼されたオペレーター操作と同じコントロールプレーンのエージェントパスを通じて実行されるため、対象エージェントのポリシーで機密性の高いツールが許可されている場合、このエンドポイントからそれらを使用できます。
• loopback／tailnet／プライベートイングレスのみに配置してください。公開インターネットに公開しないでください。

​

認証

• trusted-proxy Gateway 上でプロキシを迂回する同一ホストの呼び出し元は、gateway.auth.password／OPENCLAW_GATEWAY_PASSWORD に直接フォールバックできます。Forwarded、X-Forwarded-*、または X-Real-IP のいずれかのヘッダー証拠がある場合、リクエストは代わりに trusted-proxy パスに維持されます。
• gateway.auth.rateLimit が設定されており、認証試行が何度も失敗した場合、エンドポイントは Retry-After ヘッダー付きで 429 を返します。

​

このエンドポイントを使用する場合

• 統合が同じ Gateway に対する別のオペレーター／クライアントサーフェスにすぎない場合は、新しい組み込みチャネルを追加するよりも、これを優先してください。
• リモート Gateway に直接接続するネイティブモバイルクライアントでは、デバイスが共有 HTTP トークン／パスワードを必要としないように、ペアリング済みデバイスのブートストラップ／デバイストークンフローを備えた WebChat または Gateway プロトコルを使用することを推奨します。
• 独自のユーザー、ルーム、Webhook 配信、または送信トランスポートを持つ外部メッセージングネットワークと統合する場合は、代わりにチャネル Plugin を構築してください。Plugin の構築を参照してください。

​

エージェント優先のモデル契約

​

セッションの動作

​

リクエスト制限

{
  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,
          },
        },
      },
    },
  },
}

​

チャットツール契約

​

サポートされるリクエストフィールド

• トークン上限: ワイヤー上のフィールド名はプロバイダーのトランスポートによって選択されます。OpenAI 系エンドポイントでは max_completion_tokens、レガシー名のみを受け付けるプロバイダー（Mistral、Chutes）では max_tokens です。
• stop はトランスポートの停止フィールドにマッピングされます。Chat Completions バックエンドでは stop、Anthropic では stop_sequences です。OpenAI Responses API には停止パラメーターがないため、Responses ベースのモデルには stop が適用されません。
• ChatGPT ベースの Codex Responses バックエンドは、固定されたサーバー側サンプリングを使用し、リクエストがそのバックエンドに到達する前に temperature/top_p（および max_output_tokens、metadata、prompt_cache_retention、service_tier）を除去します。

​

サポートされていないバリアント

• 配列でない tools、関数でないツール項目、または tool.function.name の欠落
• allowed_tools や custom などの tool_choice バリアント
• 指定されたツールと一致しない tool_choice.function.name 値

​

非ストリーミングのツール応答形式

• choices[0].finish_reason = "tool_calls"
• id、type: "function"、function.name、function.arguments（JSON 文字列）を含む choices[0].message.tool_calls[] 項目
• ツール呼び出し前のアシスタントの解説。choices[0].message.content に格納されます（空の場合があります）

​

ストリーミングのツール応答形式

​

ツールの後続ループ

​

ストリーミング（SSE）

• Content-Type: text/event-stream
• 各イベント行は data: <json> です
• ストリームは data: [DONE] で終了します

​

Open WebUI のクイックセットアップ

• ベース URL: http://127.0.0.1:18789/v1
• macOS 上の Docker のベース URL: http://host.docker.internal:18789/v1
• API キー: 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": ["alpha", "beta"]
  }'

​

関連項目

• 設定リファレンス
• オペレータースコープ
• OpenAI