Skip to content

المزيد من النماذج الصينية ونقاط نهاية الوسيط المخصصة ​

صفحة النماذج الصينية تصل هنا إلى ختامها: DeepSeek و Qwen و GLM و Kimi و MiniMax و Doubao و Hunyuan و Qianfan كلها تملك إضافات رسمية وقد رُبطت في الدروس السابقة. هذا الدرس يحل الأمور الثلاثة المتبقية — StepFun و Xiaomi MiMo و Meituan LongCat التي لا تزال لديها إضافات رسمية؛ ماذا نفعل بالنماذج مثل Spark و Baichuan التي لا تملك provider رسميًا؛ ثم الحل الشامل لوساطة OpenClaw: نقطة النهاية المخصصة custom-api-key، مع ثلاثة مسارات تجميع: OpenRouter و LiteLLM و ClawRouter. يستغرق الأمر نحو 10 دقيقة، وهذا الدرس مبني على الإصدار v2026.10.9.

ماذا ستستطيع فعله بعد إتمام الدرس ​

  • تثبيت الإضافات الرسمية الثلاث لـ StepFun و Xiaomi MiMo و Meituan LongCat وتشغيل النموذج الافتراضي لكل منها
  • تمييز النماذج الصينية التي لا تملك provider رسميًا (Spark و Baichuan و Yi و SenseChat) حتى لا تضيع وقتًا في البحث عن إضافات
  • استخدام إجراء custom-api-key لربط أي نقطة نهاية وسيط متوافقة مع OpenAI بـ OpenClaw — بطريقتين: عبر onboarding أو عبر ملف الإعدادات
  • ربط مسارات التجميع الثلاثة OpenRouter / LiteLLM / ClawRouter واستخدام نماذج من عدة شركات بمفتاح واحد
  • ضبط مفاتيح التوافق لنقطة نهاية الوسيط: عندما يُرجع reasoning_effort خطأ 400، أو تُرفض نقطة نهاية داخلية، أو تُمرَّر الحقول الخاصة بالشركة

🎒 التحضير قبل البدء ​

  • إتمام نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج: فهم الخطوات الثلاث «تثبيت الإضافة ← تهيئة بيانات الاعتماد ← اختيار النموذج» وقاعدة مرجع provider/model
  • OpenClaw مثبت و Gateway يعمل: openclaw gateway status يعطي مخرجات
  • تملك بيانات الاعتماد التي ستستخدمها للربط: مفتاح API من الشركة، أو baseUrl + مفتاح API من موقع الوسيط
  • إذا كنت تستخدم نشر الخادم / الخدمة الخلفية، فاعرف مكان ~/.openclaw/.env — فالمفتاح سيستقر هناك في النهاية

نفّذ معي خطوة بخطوة ​

الخطوة 1: اختر المسار — إضافة رسمية أم نقطة نهاية مخصصة أم مسار تجميع ​

لماذا: ربط النماذج في OpenClaw يتم عبر ثلاثة مسارات، والاختيار الخاطئ يهدر جهدك — اقضِ أولًا 30 ثانية في تحديد موقعك.

حالتكالمسار المناسبإلى أي خطوة تذهب في هذا الدرس
استخدام StepFun / Xiaomi MiMo / Meituan LongCatإضافة رسمية (خارجية، تحتاج تثبيتًا)الخطوة 2
استخدام Spark أو Baichuan أو Yi من Lingyi أو SenseChat من SenseTime — الشركة توفر API متوافقًا مع OpenAIنقطة نهاية مخصصة custom-api-keyالخطوة 3
ما لديك هو موقع وسيط (وكيل متوافق مع OpenAI يمنحك baseUrl + مفتاحًا)نقطة نهاية مخصصة custom-api-keyالخطوة 3
تريد استخدام نماذج من عدة شركات بمفتاح واحد / بوابة موحدة للفريقمسار تجميعالخطوة 4

لنبدأ بنتيجة سلبية (بعد تدقيق كامل للمستودع الرسمي 2026-11-03): نماذج iFlytek Spark و Baichuan و Yi من 01.AI و SenseChat من SenseTime لا تملك إضافة provider رسمية في OpenClaw — لا يوجد كتالوج مقابل لا في extensions/ ولا في docs/providers/. أما SenseAudio من SenseTime فهي إضافة مدمجة، لكنها خدمة تحويل الكلام إلى نص وليست نموذج SenseChat الكبير. لذا لا تبحث عن «إضافة Spark» — هذه الشركات الثلاث لا يمكنها سوى السير في الخطوة 3 بنقطة النهاية المخصصة، أو الخطوة 4 بمسار التجميع.

الخطوة 2: ربط StepFun و Xiaomi MiMo و Meituan LongCat (ثلاثية الإضافات الرسمية) ​

لماذا: هذه الشركات الثلاث هي المقاعد الأخيرة بين الإضافات الرسمية للنماذج الصينية (أما النسخة الدولية BytePlus من Volcano فقد ذُكرت في درس Doubao)، وطريقة التثبيت هي نفسها تمامًا كما مع DeepSeek — تثبيت الإضافة، تهيئة المفتاح، اختيار النموذج.

لنلقِ أولًا نظرة على الجدول الموجز (المعلومات كلها من وثائق provider الرسمية):

الشركةحزمة الإضافة (خارجية، تحتاج تثبيتًا)معرّف providerمتغير البيئةالنموذج الافتراضي
阶跃星辰 StepFun@openclaw/stepfun-providerstepfun وstepfun-planSTEPFUN_API_KEYstepfun/step-3.5-flash
小米 MiMo@openclaw/xiaomi-providerxiaomi وxiaomi-token-planXIAOMI_API_KEY وXIAOMI_TOKEN_PLAN_API_KEYxiaomi/mimo-v2.6-pro
美团 LongCat@openclaw/longcat-providerlongcatLONGCAT_API_KEYlongcat/LongCat-2.0

StepFun: ميّز أولًا بين مفتاح الصين والمفتاح الدولي ​

مفاتيح StepFun مقسّمة حسب المنطقة، وتنص الوثائق الرسمية بوضوح على: مفتاح الصين يُستخدم مع نقطة النهاية .com، والمفتاح الدولي مع نقطة النهاية .ai، فلا تخلط بينهما.

bash
openclaw plugins install @openclaw/stepfun-provider
openclaw onboard --auth-choice stepfun-standard-api-key-cn    # 中国 Key → api.stepfun.com
openclaw onboard --auth-choice stepfun-standard-api-key-intl  # 国际 Key → api.stepfun.ai

ينبغي أن ترى: مطالبة onboarding تلزمك بلصق STEPFUN_API_KEY، وبعد نجاح التحقق يصبح النموذج الافتراضي stepfun/step-3.5-flash.

كتالوج النماذج على نقطة النهاية القياسية:

مرجع النموذجالسياقأقصى مخرجاتملاحظات
stepfun/step-3.5-flash262,14465,536النموذج الافتراضي
stepfun/step-3.7-flash262,144262,144متعدد الوسائط، يدعم إدخال الصور

توجد أيضًا نقطة نهاية Step Plan (موفر مستقل، بادئة المرجع stepfun-plan/...، وauth-choice هو stepfun-plan-api-key-cn|intl)، ونماذج مثل stepfun-plan/step-3.5-flash-2603. يدعم Step 3.7 ثلاث درجات من effort هي low / medium / high، ولا يوجد وضع غير استدلالي، و/think off يُحوَّل إلى low.

小米 MiMo: موفران — الدفع حسب الاستخدام و Token Plan ​

bash
openclaw plugins install @openclaw/xiaomi-provider
openclaw onboard --auth-choice xiaomi-api-key          # 按量付费,sk-... Key
openclaw onboard --auth-choice xiaomi-token-plan-sgp   # Token Plan,tp-... Key(区域可选 cn / sgp / ams)

يُنشأ مفتاح الدفع حسب الاستخدام في وحدة تحكم Xiaomi MiMo: platform.xiaomimimo.com/#/console/api-keys؛ أما Token Plan فتُنسخ منه نقطة نهاية المنطقة ومفتاح tp-... المرافق من صفحة الاشتراك.

نظرة على النماذج: mimo-v2.6-pro (الافتراضي) وmimo-v2.6-flash وmimo-v2.6-pro-ultraspeed (يذكر الكتالوج الرسمي سرعة إخراج 20x) وmimo-v2.5 وmimo-v2.5-pro — السياق في جميعها 1,048,576 token. دعم /think لكل المستويات (من off إلى max، والافتراضي high). يأتي هذا المكون الإضافي أيضًا مع TTS (mimo-v2.5-tts)، وإذا أردت إضافة صوت إلى Claw فراجعدرس الصور والصوت.

美团 LongCat: نموذج واحد، متخصص في الاستدلال ​

bash
openclaw plugins install @openclaw/longcat-provider
openclaw onboard --auth-choice longcat-api-key

يُنشأ المفتاح في منصة LongCat API: longcat.chat/platform/api_keys.

النموذج واحد فقط: longcat/LongCat-2.0 — سياق 1,048,576 / أقصى مخرجات 131,072، إدخال نصي خالص، والموقع الرسمي يصفه بأنه «نموذج استدلالي مبني لأحمال العمل البرمجية (coding) والوكيلة (agentic)». الأسعار (بحسب الوثائق الرسمية، لكل مليون token): الإدخال $0.75 (غير مخزّن مؤقتًا) / $0.015 (إصابة في الذاكرة المؤقتة)، والإخراج $2.95.

💡 هل تريد تشغيل أوزان LongCat المفتوحة محليًا؟

لا تستخدم المرجع longcat/LongCat-2.0 للاتصال بنشر محلي — فهو يشير إلى واجهة API مُدارة. لتشغيل الأوزان المفتوحة محليًا استخدم vLLM / SGLang، انظر الدرس التالي النماذج المحلية: Ollama وvLLM وds4.

  • أي موفر ثبّته، سيُدرج openclaw models list --provider stepfun (أو xiaomi / longcat) كتالوج نماذجه

الخطوة 3: تكوين نقطة نهاية وسيطة في OpenClaw — سير العمل العام لـ custom-api-key ​

لماذا: لا توجد مكونات إضافية رسمية لـ Spark وBaichuan وYi وSenseTime؛ كما أن «محطات التحويل» و«وسائط API» المنتشرة في السوق هي نشرات خاصة بكل منها. لكن ما دام الطرف الآخر يمنحك baseUrl متوافقًا مع OpenAI + مفتاح API، يمكن لـ OpenClaw الاتصال عبر سير عمل custom-api-key — وهذه هي الطريقة الجوهرية التي يشرحها هذا الدرس.

الطريقة A (موصى بها): أمر onboarding واحد ​

النسخة غير التفاعلية بكل المعاملات (المعاملات مأخوذة من أمثلة الوثائق الرسمية، ويجب أن يكون $CUSTOM_API_KEY مضبوطًا مسبقًا في البيئة):

bash
openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --custom-api-key "$CUSTOM_API_KEY" \
  --custom-compatibility openai

كل معامل من المعاملات الخمسة مسؤول عن أمر واحد:

المعاملالوظيفةملاحظات
--custom-base-urlعنوان محطة التحويلعادةً ما تتطلب نقاط النهاية المتوافقة مع OpenAI إضافة /v1، انظر تنبيه المزالق
--custom-model-idمعرّف النموذجيمكن حذفه: عند الحذف يتم الاكتشاف تلقائيًا من /models الخاص بنقطة النهاية (مهلة 5 ثوانٍ)، ويُحفظ كل النماذج المكتشفة ويكون الأول منها هو الافتراضي؛ وإذا فشل الاكتشاف فأعد التشغيل وحدّده صراحةً
--custom-api-keyمفتاح APIعند حذفها تُقرأ من متغير البيئة CUSTOM_API_KEY
--custom-compatibilityشكل البروتوكولopenai (الافتراضي، chat completions) / openai-responses (نقاط النهاية التي لديها /v1/responses فقط) / anthropic؛ مع anthropic يجب تقديم --custom-model-id
--custom-image-input / --custom-text-inputنوع الإدخالمعرّفات النماذج البصرية الشائعة (GPT-4o/4.1/5.x وClaude 3/4 وGemini وQwen-VL وLLaVA وPixtral وغيرها) تُعلَّم تلقائيًا كإدخال صور؛ والنماذج البصرية غير المدرجة في القائمة استخدم الخيار الأول لفرض وسمها

ينبغي أن ترى: اكتمال الأمر دون أخطاء؛ وظهور موفر مخصص في openclaw models status يشير نموذجه الافتراضي إلى المعرف الذي أعطيته.

لا تريد حفظ المعاملات؟ شغّل openclaw onboard تفاعليًا، واختر Custom setup لتمر بكل خيارات الإرشاد، وستملأ الأشياء نفسها.

⚠️ هل يعمل Gateway كـ daemon؟ لا تضع المفتاح في interactive shell

عندما يعمل Gateway كخدمة launchd / systemd، لا يرى متغيرات البيئة التي ضبطتها بـ export في طرفيتك. اكتب المفتاح في ~/.openclaw/.env، أو زوّد تلك العملية به عبر env.shellEnv في التكوين.

الطريقة B: تعديل ملف التكوين يدويًا ​

تحب أن يكون كل شيء تحت سيطرتك، أو تريد نشر الإعدادات دفعة واحدة على أجهزة متعددة——models.providers مكتوبة يدويًا. مثال رسمي لنقطة نهاية بدون مصادقة (كما هو):

json5
{
  agents: {
    defaults: { model: { primary: "my-studio/qwen3.8" } },
  },
  models: {
    providers: {
      "my-studio": {
        baseUrl: "https://studio.example.ts.net/v1",
        api: "openai-completions",
        auth: "none",
        models: [{ id: "qwen3.8", name: "Qwen3.8" }],
      },
    },
  },
}

الصيغة مع Key ومع بيانات وصفية كاملة للنموذج (مقتطف كما هو من المثال الرسمي):

json5
{
  agents: {
    defaults: {
      model: { primary: "lmstudio/my-local-model" },
      models: { "lmstudio/my-local-model": { alias: "Local" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

يمكن حذف حقول النموذج، والقيم الافتراضية عند الحذف: reasoning: false، input: ["text"]، وcost بالكامل 0، وعند عدم تعيين contextWindow يتم الرجوع إلى 200000 كقيمة احتياطية. التوصية الرسمية: اكتبها كاملة صراحةً وفقًا للحدود الحقيقية للوكيل / النموذج لديك.

نقطة نهاية بدون مصادقة: auth: "none" ​

خدمات الاستدلال المبنية ذاتيًا على الشبكة الداخلية أو على tailnet / VPN غالبًا لا تضع Key. OpenClaw يدعم ذلك، لكن هناك قاعدتان صارمتان:

  • التصريح الصريح بـ auth: "none" (onboarding يقابله --custom-no-auth، ولا يمكن استخدامه مع --custom-api-key)——الكشف التلقائي عن انعدام المصادقة يغطي فقط عناوين loopback وعناوين RFC1918، أما tailnet / VPN فهي من نوع «شبكة خاصة لكنها ليست RFC1918» ويجب التصريح بها صراحةً
  • auth: "none" يسري فقط على محوّل openai-completions؛ ونقاط النهاية المتوافقة مع Responses وAzure OpenAI وAnthropic تحتاج إلى مفتاح نائب (placeholder) حتى بدون مصادقة

مفتاح التوافق (compat) لنقطة النقل ​

OpenClaw يقوم تلقائيًا بتهذيب متحفظ لنقاط النهاية من نوع openai-completions التي «لا يكون baseUrl فيها هو api.openai.com»، لمنع انهيار محطات الترحيل بسبب الحقول الخاصة بـ OpenAI. مقارنة القواعد التلقائية بالمفاتيح اليدوية:

الظاهرة / الحاجةالمفتاح
محطة الترحيل لا تعترف بدور developerتلقائي: فرض compat.supportsDeveloperRole: false على النقاط غير الأصلية (حتى الكتابة الصريحة لـ true سيتم تجاوزها)
خطأ 400: لا يعرف reasoning_effortتعيين compat.supportsReasoningEffort: false لهذا النموذج (عند تفعيل thinking للنماذج المخصصة في reasoning: true يُرسل هذا الحقل افتراضيًا)
جلسة thinking تطلب إعادة تشغيل reasoning_contentتعيين compat.requiresReasoningContentOnAssistantMessages: true (تُحفظ أسماء حقول إعادة التشغيل reasoning / reasoning_text / reasoning_content كما هي افتراضيًا)
تريد تمرير الحقول الخاصة بمزود الخدمةagents.defaults.models["provider/model"].params.extra_body (أو extraBody)، وتُدمج في نص الطلب
نقاط نهاية LAN / tailnet مرفوضةmodels.providers.<id>.request.allowPrivateNetwork: true (loopback مسموح به افتراضيًا)
نقطة نهاية بطيئة تنتهي مهلتها دائمًاmodels.providers.<id>.timeoutSeconds
ترحيل متوافق مع Anthropic لا يعترف بترويسات betaتلقائي: كبت ترويسات beta الضمنية (مثل claude-code-20250219)؛ وعند الحاجة الفعلية لميزات beta صرّح بها في models.providers.<id>.headers["anthropic-beta"]
  • openclaw models status يمكنه إظهار مصدر بيانات الاعتماد للمزود المخصص؛ أما عنوان نقطة النهاية فيُعرض بـ openclaw config get models.providers.<id>.baseUrl

الخطوة 4: اختيار واحد من ثلاثة لمسارات التجميع——OpenRouter وLiteLLM وClawRouter ​

لماذا: لا تريد التسجيل لدى كل مزود نماذج؟ مسار التجميع يمنحك Key واحدًا ونماذج من مزودين متعددين. الإضافات الثلاث مدمجة جميعها في OpenClaw (included in OpenClaw)، فلا حاجة للتثبيت أولًا.

المسارما هوالمصادقةالعنوان / النموذج الافتراضي
OpenRouterخدمة تجميع تجارية، Key واحد لاستدعاء نماذج من مزودين متعددينOAuth أو API Keyالنموذج الافتراضي openrouter/auto
LiteLLMبوابة LLM مفتوحة المصدر مبنية ذاتيًا (100+ provider)تُوكّل مفاتيحك الخاصةالوكيل الافتراضي http://localhost:4000
ClawRouterOpenClaw مسار متعدد المنابع مستضاف رسميًاKey بنطاق صلاحيات policy يوقعه المسؤولhttps://clawrouter.openclaw.ai

OpenRouter: Key واحد للنماذج الصينية والأجنبية معًا ​

في دليل starter المدمج توجد نماذج صينية بالفعل: openrouter/moonshotai/kimi-k2.6، openrouter/moonshotai/kimi-k2.5؛ والمراجع الأخرى تكون بالشكل openrouter/<provider>/<model>، مع تحليل ديناميكي لدليل OpenRouter الرسمي. عند استدعاء DeepSeek V4 عبر OpenRouter، يقوم OpenClaw تلقائيًا بإعادة إرسال reasoning_content، فلا تنقطع جلسات thinking.

bash
# 方式一:API Key(在 openrouter.ai/keys 创建)
openclaw onboard --auth-choice openrouter-api-key

# 方式二:聊天里直接 OAuth(私聊发送,浏览器登录授权)
/login openrouter

يجب أن ترى: بعد نجاح التحقق يصبح النموذج الافتراضي openrouter/auto. لتثبيت نموذج محدد: openclaw models set openrouter/moonshotai/kimi-k2.6.

LiteLLM: بوابة موحدة مبنية ذاتيًا مع تسجيل للتكاليف ​

LiteLLM هي بوابة LLM مفتوحة المصدر، بواجهة API موحدة تتصل بـ 100+ provider، مع تتبع للتكاليف وسجلات ومفاتيح افتراضية بحدود وحماية من أعطال الخلفية. OpenClaw يتصل بنقطة النهاية المتوافقة مع OpenAI لديها /v1:

bash
openclaw onboard --auth-choice litellm-api-key
# 提示代理地址时回车用默认 http://localhost:4000,或填你的代理 URL

النسخة غير التفاعلية للوكيل البعيد (كما في الوثائق الرسمية):

bash
openclaw onboard --non-interactive --accept-risk --skip-health --auth-choice litellm-api-key \
  --litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"

يقوم onboarding باستدعاء /v1/models للوكيل لاكتشاف النماذج، ويُعتمد الأول كافتراضي؛ وعند فشل الاكتشاف ستُطالب بتعبئة المعرّف يدويًا. لوكيل LiteLLM داخل LAN لا تنسَ إضافة request.allowPrivateNetwork: true. لإصدار مفاتيح بحدود لأشخاص مختلفين، استخدم POST /key/generate الخاص بـ LiteLLM (max_budget / budget_duration).

ClawRouter: مستضاف رسميًا، وبيانات الاعتماد لا تغادر منزلك ​

ClawRouter هو مسار متعدد المنابع المستضاف رسميًا من OpenClaw: بيانات اعتماد المزودين المنبعيين وإعادة التوجيه تبقى جميعها في جانب ClawRouter، وعلى جهاز OpenClaw لديكلا تحتاج لتثبيت أي إضافة مزود منبعي. الإضافة مدمجة ومفعّلة افتراضيًا، وتحتاج فقط إلى Key واحد يوقعه المسؤول (يُعرض مرة واحدة عند التوقيع، فاحفظه جيدًا).

bash
export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
openclaw models list --all --provider clawrouter

(clawrouter مفعّل افتراضيًا أصلًا؛ فقط إذا عيّنت plugins.allow في الإعدادات فستحتاج إلى إضافته أولًا إلى قائمة السماح.)

تحتفظ مراجع النماذج بمساحة أسماء المنبع، بصيغة ثلاثية المقاطع: clawrouter/openai/gpt-5.5، clawrouter/anthropic/claude-sonnet-4-6، clawrouter/google/gemini-3.5-flash——تُستخدم كما هي تمامًا كما يُعيدها الدليل، openclaw models set clawrouter/<provider>/<model>. يُكتشف الدليل وفقًا لنطاق صلاحيات الـ Key عبر /v1/catalog (مع تخزين مؤقت 1 ساعة)، والحصص تمر عبر /v1/usage.

الخطوة 5: التحقق من مسار الترحيل ​

لماذا: حفظ الإعدادات على القرص لا يعني أن المسار يعمل. تحقق من الدليل، وبيانات الاعتماد، والمحادثة من طرف إلى طرف، طبقةً طبقة، فإذا انقطعت أي طبقة ستعرف أين تُصلح——هذه الخطوة تنطبق على الإضافات الرسمية ونقاط نهاية الترحيل المخصصة على حد سواء.

bash
# 1. 看目录:新接入的 provider 和模型有没有进来
openclaw models list

# 2. 看凭据:默认模型、fallback,以及各 provider 的凭据来源
openclaw models status

# 3. 发一条测试消息,确认端到端连通
openclaw agent --agent <agent-id> --model <provider/model> --message "用一句话介绍你自己"

الأمر رقم 3 يشغّل دورة agent كاملة من الطرفية (عبر تمرير Gateway). لاحظ أن openclaw agent يجب أن يحمل محدد جلسة واحدًا على الأقل: --agent أو --to أو --session-key أو --session-id، والأكثر استخدامًا --agent <id>؛ ويقبل --model مرجع provider/model، ويسري فقط على هذه الدورة دون تغيير القيمة الافتراضية للجلسة.

يجب أن ترى

  • models list: يظهر في الدليل المزوّد والنموذج اللذان أضفتهما للتو — النقطة النهائية المخصصة تعرض معرّف النموذج المحفوظ في onboarding (الاكتشاف التلقائي يحفظ جميع النماذج التي يعيدها /models)
  • models status: النموذج الافتراضي يشير إلى النموذج الذي اخترته، ومصدر بيانات الاعتماد للمزوّد المخصص يُعرض بشكل طبيعي؛ لا توجد عبارة «Unavailable auth profiles» (إن وُجدت، سيُرفق الإدخال بالسبب وإجراء الاستعادة، فاتبعها). للتحقق من عنوان النقطة النهائية: openclaw config get models.providers.<id>.baseUrl
  • agent: يرد النموذج بجملة، ورمز الخروج للأمر 0 — الأخطاء والمهلات والإلغاء كلها تخرج بـ 1. مسار الوساطة يعمل من البداية إلى النهاية

بعد نجاح الاختبار، اجعل النموذج المريح هو الافتراضي اليومي:

bash
openclaw models set <provider/model>
  • رسالة الاختبار لها رد وopenclaw agent رمز الخروج 0 — مسار الوساطة يعمل من البداية إلى النهاية

نقطة تحقق ✅ ​

  • ثبّت مزوّد ما عند استخدامه: openclaw models list --provider stepfun (أو xiaomi / longcat) يمكنه سرد دليل النماذج
  • تذكّر النتائج السلبية: Xinghuo و Baichuan و Yi من Lingyi و SenseChat من SenseTime لا تملك مزوّدًا رسميًا — استخدم مباشرةً custom-api-key لنقطة نهائية مخصصة أو مسار تجميع، ولا تضيّع وقتًا في البحث عن إضافات
  • النقطة النهائية المخصصة متصلة: openclaw models status يعرض مصدر بيانات الاعتماد لهذا المزوّد، وopenclaw config get models.providers.<id>.baseUrl يعرض عنوان النقطة النهائية
  • openclaw agent رسالة الاختبار لها رد ورمز الخروج 0 — OpenClaw مسار الوساطة يعمل من البداية إلى النهاية
  • عند مواجهة مشاكل توافق تعرف أين تبحث: جدول مفاتيح compat في الخطوة 3 (reasoning_effort يرجع 400، رفض نقطة نهائية داخلية، تمرير حقول خاصة بالمزوّد)

تنبيهات للمزالق ​

❌ baseUrl ينقصه /v1، فتُرجع جميع الطلبات 404 ​

baseUrl لنقطة نهاية متوافقة مع OpenAI يُكتب عادةً حتى .../v1: طلب اكتشاف النماذج يطلب <baseUrl>/models (توثيق رسمي يعطي مثالًا /v1/models)، وطلب المحادثة كذلك يُلحق بنهاية baseUrl (مثل /v1/chat/completions). جميع أمثلة baseUrl في الوثائق الرسمية تنتهي بـ /v1. عند الحصول على عنوان وسيط، انظر أولًا إلى نهايته؛ وإن لم تكن متأكدًا فانسخ «Base URL» من وثائق ذلك الوسيط كما هو.

❌ فشل الاكتشاف التلقائي للنماذج، أو النموذج الافتراضي ليس المطلوب ​

عند حذف --custom-model-id، سيطلب onboarding اكتشافًا تلقائيًا عبر <baseUrl>/models (مهلة 5 ثوانٍ)، حفظ جميع النماذج المكتشفة وجعل الأول هو الافتراضي. النقطة النهائية غير متاحة أو تعيد بيانات غير صالحة أو قائمة فارغة — كلها تؤدي إلى الفشل؛ أعد التشغيل وحدد --custom-model-id صراحةً. أول نموذج مكتشف غير مناسب؟ لا حاجة لإعادة الإعداد، استخدم openclaw models set <provider/model> لتغيير الافتراضي فقط.

❌ مفتاح StepFun الصيني مُعد على نقطة نهائية دولية (أو العكس) ​

مفاتيح StepFun مقسمة حسب المنطقة: المفتاح الصيني يُعد على نقطة .com النهائية، والمفتاح الدولي على نقطة .ai النهائية، والوثائق الرسمية تطلب صراحةً عدم الخلط. اختيار stepfun-standard-api-key-cn أو -intl في auth-choice يحدد النقطة النهائية — عند فشل المصادقة تحقق أولًا من اختيار المنطقة الخطأ.

❌ نقطة نهاية متوافقة مع Anthropic لم تحصل على --custom-model-id ​

إعداد --custom-compatibility anthropicيجب أن يتضمن --custom-model-id — نقاط النهاية المتوافقة مع Anthropic لا تملك خطوة اكتشاف تلقائي للنماذج، وحذفه يفشل مباشرةً.

❌ auth: "none" لا يعمل ​

قاعدتان صارمتان: ① كشف انعدام المصادقة التلقائي يغطي فقط عناوين loopback وعناوين RFC1918، والنقاط النهائية على tailnet / VPN يجب أن تعلن auth: "none" صراحةً (في onboarding يقابلها --custom-no-auth، ولا يمكن استخدامه مع --custom-api-key)؛ ② auth: "none" يعمل فقط مع محوّل openai-completions — نقاط النهاية المتوافقة مع Responses و Azure OpenAI و Anthropic تحتاج مفتاحًا مؤقتًا حتى بدون مصادقة.

❌ بعد تشغيل Gateway كخادم خفي، المفتاح المُصدَّر بـ export «لا يعمل» ​

عندما يعمل Gateway كخدمة launchd / systemd، لا يرى متغيرات البيئة من export في طرفيتك. اكتب المفتاح في ~/.openclaw/.env، أو قدّمه لذلك العمل عبر env.shellEnv في الإعداد (كما ذُكر في مربع التحذير للطريقة A في الخطوة 3، وهو من المزالق الشائعة، فنذكّر به هنا مرة أخرى).

❌ الوسيط لا يتعرف على reasoning_effort، وبمجرد تفعيل thinking يرجع 400 ​

عند تفعيل thinking لنموذج مخصص في reasoning: true، يُرسل افتراضيًا حقل reasoning_effort، وبعض الوسطاء لا يتعرفون عليه. اضبط compat.supportsReasoningEffort: false لذلك النموذج. لمشاكل التوافق الأخرى (رفض دور developer، تمرير الحقول الخاصة، رفض النقاط النهائية الداخلية) راجع جدول مفاتيح compat في الخطوة 3.

❌ رصيد الوسيط غير كافٍ / الفوترة غير مُعدة جيدًا ​

حتى مع إعداد المسار صحيحًا بالكامل قد تفشل بسبب الفوترة: رصيد الوسيط غير كافٍ، أو النموذج المرتبط غير مفعّل — الطلبات ستفشل. لاستخدام الفحص الحي المدمج في OpenClaw: openclaw models status --probe يرسل طلبات حقيقية لبيانات الاعتماد المُعدة (قد يستهلك tokens ويفعّل تحديد المعدل)، وفشائل الفوترة تُصنف في مجموعة حالة billing؛ لاحظ أنه يتطلب دليل حالة حصريًا، فأوقف Gateway أولًا بـ openclaw gateway stop ثم شغّله. للاستكشاف اليومي، تحقق أولًا من الرصيد وحالة تفعيل النماذج في لوحة تحكم الوسيط — أمرٌ أكثر مباشرةً.

الخطوة التالية ​

بهذا تُختم صفحة النماذج الصينية: الإضافات الرسمية (DeepSeek و Qwen و GLM و Kimi و MiniMax و Doubao و Hunyuan و Qianfan و StepFun و MiMo و LongCat)، والنقاط النهائية المخصصة، ومسارات التجميع — لقد نجحت في المسارات الثلاثة. OpenClaw الحل الشامل للوساطةتذكّر جملة واحدة: إن وُجدت إضافة رسمية فثبّتها، وإن لم يوجد مزوّد رسمي فاستخدم custom-api-key، وإن أردت مفتاحًا واحدًا لمزوّدين متعددين فاستخدم مسار التجميع. التالي:

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.