تكامل OpenClaw

اضبط QCode.cc كمزوّدات نماذج لـ OpenClaw: كتلة models.providers في openclaw.json، ومعالج إعداد المزوّد المخصص، وكيفية التحقق من الاتصال

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-09-18 · 📄 وفق الوثائق الرسمية (OpenClaw v2026.9.4، صدر في 2026-09-11)

نظرة سريعة¶

OpenClaw هو مساعد ذكاء اصطناعي مفتوح المصدر يعمل على أجهزتك الخاصة: تتصل عملية Gateway مستضافة ذاتيًا بـ Discord وTelegram وSlack وiMessage وغيرها من قنوات الدردشة، مع تطبيقات أصلية لـ macOS / Windows / Linux. إنه ليس محرر شيفرة — يوجد في هذا القسم لأنه يُستخدم كثيرًا كـ«بوابة مساعد شخصي عبر نماذج متعددة»، ولأنه يدعم أصلًا أي نقطة نهاية متوافقة مع OpenAI / Anthropic.

المتطلبات المسبقة¶

• OpenClaw مثبّت (المثبّت الرسمي curl -fsSL https://openclaw.ai/install.sh | bash؛ يتطلب التثبيت المباشر عبر npm إصدار Node 24.16+، والتوصية الرسمية هي 26+، راجع README).
• مفتاح cr_ من QCode.cc (أنشئ واحدًا في لوحة التحكم). لا حاجة إلى حساب منفصل لدى مزوّد نموذج.
• لا يتطلب OpenClaw نفسه أي حساب خاص به؛ فكل نموذج يأتي من المزوّدين الذين تضبطهم.

الإعداد¶

المسار أ: تحرير ملف الإعدادات مباشرةً (موصى به)¶

أضف كتلة models.providers إلى ~/.openclaw/openclaw.json. الملف بصيغة JSON5 (تُسمح التعليقات والفواصل اللاحقة) ويعيد Gateway تحميله فوريًا — دون حاجة إلى إعادة التشغيل:

{
  models: {
    mode: "merge", // keep built-in providers, append QCode
    providers: {
      qcode: {
        baseUrl: "https://api.qcode.cc/api",
        apiKey: "${QCODE_API_KEY}",
        api: "anthropic-messages",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5", input: ["text", "image"] },
        ],
      },
      qcode_openai: {
        baseUrl: "https://api.qcode.cc/openai/v1",
        apiKey: "${QCODE_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gpt-5.6", name: "GPT-5.6" },
          { id: "glm-5.3", name: "GLM-5.3" },
        ],
      },
    },
  },
}

ثلاث ملاحظات (جميعها من وثائق المزوّدين المخصصين الرسمية):

• يدعم apiKey الاستبدال بـ ${ENV_VAR}؛ وتوصي وثائق OpenClaw بمراجع الأسرار / متغيرات البيئة بدلًا من مفتاح حرفي.
• api هو محول الطلبات: بروتوكول Anthropic هو anthropic-messages، وبروتوكول OpenAI هو openai-completions. تعيين baseUrl فقط دون api يؤدي افتراضيًا إلى openai-completions.
• لا يتلقى النموذج الصور (الرؤية) إلا إذا عيّنت input: ["text", "image"] صراحةً؛ وإلا فتُمرَّر الصور كمراجع نصية.

المسار ب: إدخال «مزوّد مخصص» في معالج onboard¶

openclaw onboard --install-daemon

اختر مزوّدًا مخصصًا في قائمة المزوّدين (ضمن المزيد… عندما لا يظهر مباشرةً)، ثم أدخل Base URL ومفتاح API والتوافق ومعرّف النموذج. يتحقق المعالج من إكمال حقيقي قبل الحفظ (الصيغة الرسمية: يتحقق من رد حقيقي قبل الحفظ)، ما يكشف الأخطاء المطبعية في URL فورًا.

المكافئ غير التفاعلي، لنموذج Claude:

openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.qcode.cc/api" \
  --custom-model-id "claude-sonnet-5" \
  --custom-api-key "$QCODE_API_KEY" \
  --custom-compatibility anthropic

🔴 تختلف كتابتان: خيار المعالج --custom-compatibility يقبل anthropic، بينما يقبل api في ملف الإعدادات anthropic-messages (راجع وثائق onboard).

تحقق من أنه يعمل¶

1. إذا استخدمت المسار B، فقد أجرى معالج الإعداد بالفعل فحصًا مباشرًا لك (طلب حقيقي واحد قبل الحفظ).
2. بعد المسار A، اطلب من الوكيل شيئًا بسيطًا مثل ping. إذا فشل، فتحقق أولًا من صياغة JSON5 في ~/.openclaw/openclaw.json — فالتعليقات والفواصل الشاردة تفسد الملف.
3. للتحقق فقط من وجود المسار ووصول المفتاح:

curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $QCODE_API_KEY"
# → 401 = key invalid; any code other than a JSON error = path reachable

1. يُسجَّل كل طلب (بما في ذلك طلبات OpenClaw) في probe.qcode.cc — أدخل مفتاحك لترى النموذج وحالة الطلبات الفعلية. هل ما زال يفشل؟ اتبع قائمة التحقق في استكشاف الأخطاء وإصلاحها.

القيود المعروفة¶

• تحذير بشأن صيغة Base URL: يستخدم كلا المثالين الرسميين لـ anthropic-messages (Synthetic، MiniMax) قيمة baseUrl بدون /v1 (مثل https://api.minimax.io/anthropic)، لذا تستخدم هذه الصفحة https://api.qcode.cc/api. المسار الدقيق الذي يُلحقه OpenClaw غير موثق حرفيًا ولم يُختبَر مباشرةً هنا. إذا أعادت الطلبات 404، فغيّر baseUrl إلى المسار الكامل https://api.qcode.cc/api/v1/messages.
• محوّل openai-responses موثق للأنظمة الخلفية التي تدعم /v1/responses فقط. على QCode، تخدم نقطة نهاية Responses نماذج GPT؛ وجّه النماذج الصينية عبر openai-completions (مصفوفة البروتوكولات: نقاط النهاية ومسارات API).
• على نقاط نهاية anthropic-messages غير المباشرة، يكتم OpenClaw ترويسات beta الخاصة بـ Anthropic قبل إرسال الطلب (سلوك موثق) — وهو مفيد للبوابات التابعة لجهات خارجية. إذا واجهت أداة أخرى أخطاء 400 الخاصة بـ anthropic-beta، فليست هذه مشكلة في OpenClaw.
• يوجد محوّل Gemini (google-generative-ai) في التعداد الرسمي، لكن QCode لا يوفر نماذج Gemini حاليًا، لذا لا يُقدَّم مثال.
• توجد الوثائق الرسمية على فرع main في GitHub؛ وقد يتأخر docs.openclaw.ai قليلًا عنها.

وثائق ذات صلة¶

• نقاط النهاية ومسارات API — البروتوكولات وكيفية تعبئة Base URL
• نظرة عامة على توافق الأدوات — دعم البروتوكولات عبر جميع الأدوات
• إعداد CC Switch — تبديل المزوّد عبر واجهة رسومية لـ Claude Code / Codex
• النماذج الصينية — معرّفات GLM / Kimi / DeepSeek / Qwen المتاحة للبيع حاليًا
• استكشاف الأخطاء وإصلاحها
• إعداد LobsterAI — عميل سطح المكتب من NetEase Youdao المبني على OpenClaw؛ تقبل نماذجه المخصصة عناوين Anthropic Compatible وOpenAI Compatible
• إعداد AutoClaw — تطبيق OpenClaw المحلي من Zhipu؛ تستخدم نماذجه المخصصة بروتوكول OpenAI Chat

المؤسسات ←