إكمالات الدردشة من OpenAI

​

تمكين نقطة النهاية

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

​

الحد الأمني (مهم)

• يُعادل رمز Gateway المميز/كلمة المرور الصالحة لنقطة النهاية هذه بيانات اعتماد المالك/المشغّل، وليس نطاقًا محدودًا لكل مستخدم.
• تمر الطلبات عبر مسار وكيل مستوى التحكم نفسه الذي تستخدمه إجراءات المشغّل الموثوق بها، ولذلك يمكن لنقطة النهاية هذه استخدام الأدوات الحساسة إذا كانت سياسة الوكيل المستهدف تسمح بها.
• أبقِها مقتصرة على local loopback أو الشبكة الطرفية أو الدخول الخاص. لا تعرضها للإنترنت العام.

​

المصادقة

• يمكن للمستدعين على المضيف نفسه الذين يتجاوزون الوكيل في 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 مميز/كلمة مرور مشتركة.
• أنشئ Plugin قناة بدلًا من ذلك عند التكامل مع شبكة مراسلة خارجية لها مستخدموها أو غرفها أو تسليم Webhook أو نقلها الصادر. راجع إنشاء Plugins.

​

عقد النموذج القائم على الوكيل أولًا

​

سلوك الجلسة

​

حدود الطلبات (الإعدادات)

{
  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 للواجهات الخلفية لإكمالات المحادثة، و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: رمز حامل 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":"Summarize my tasks for today"}]
  }'

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":"hi"}]
  }'

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":"hi"}]
  }'

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