Hermes Agent مع Qwen: الإعداد وQwen 4 Preview وحل أخطاء 401

الطرق الأربعة من Hermes إلى Qwen

يسرد توثيق Hermes أربعة مدخلات منفصلة لـ Qwen. اختر المدخل وبيانات الاعتماد المناسبة لخطة الفوترة لديك؛ ويمكن لمزوّد Coding Plan الرجوع إلى DASHSCOPE_API_KEY.

يصف Hermes الخيار qwen-oauth بأنه مثالي للمستخدمين الأفراد، والخيار alibaba بأنه مثالي للأحمال البرمجية أو الإنتاجية. وكلاهما يصل إلى نماذج عائلة Qwen، لكن عبر نقطتي اتصال مختلفتين.

إعداد كل طريق

للطرق القائمة على المفاتيح، شغّل hermes model واختر المزوّد المناسب لخطة الفوترة لديك وأدخل المفتاح واختر نموذجًا. ويمكن إجراء فحص سريع لمرة واحدة من سطر الأوامر:

hermes chat --provider alibaba --model qwen3.5-plus

هذا المثال هو الوارد في توثيق Hermes، مع ضبط DASHSCOPE_API_KEY في ~/.hermes/.env. ولخطة Coding Plan الصيغة نفسها:

hermes chat --provider alibaba_coding --model qwen3-coder-plus

لـ Qwen OAuth، اختر Qwen OAuth (Portal) في hermes model وسجّل الدخول عبر المتصفح وأكّد. يحفظ Hermes بيانات الاعتماد في ~/.hermes/auth.json. والمكافئ في config.yaml هو:

model:
  provider: "qwen-oauth"
  default: "qwen3-coder-plus"

يمرّ دليل Qwen Cloud نفسه عبر المنتقي ذاته: لمفتاح Token Plan، اختر Qwen ثم Alibaba Cloud (Token Plan)، وأدخل مفتاح Token Plan واترك عنوان base URL الافتراضي. ولمفتاح الدفع حسب الاستخدام، اختر Qwen Cloud (Alibaba DashScope) وأدخل عنوان base URL لمنطقتك. ومثاله لسنغافورة:

https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1

تحقق بالأمر hermes chat -q "hello". يستخدم Hermes Desktop المزوّد والنموذج نفسيهما ضمن الإعدادات ثم النموذج؛ اطّلع على صفحة Hermes Desktop لدينا.

إذا كان QwenCloud غير موجود في hermes model

تقول Qwen Cloud إن قائمة المزوّدين في hermes model تتضمن QwenCloud ابتداءً من v2026.8.31. وعلى تثبيت أقدم، أو إذا كان المدخل غائبًا، تقدّم طريقًا عبر ملف الإعداد. الملف هو ~/.hermes/config.yaml على macOS وLinux وWSL2، و%LOCALAPPDATA%\hermes\config.yaml على Windows. ويبدو مدخل Token Plan هكذا، مع مفتاح خطتك بدل النص النائب:

model:
  default: auto
  provider: custom
  base_url: https://token-plan.maas.qwencloudapi.com/compatible-mode/v1
  api_key: YOUR_API_KEY

تقدّم Qwen Cloud أيضًا صيغة متوافقة مع Anthropic لكل مدخل، تستخدم api_mode: anthropic_messages وعنوان base URL ينتهي بـ /apps/anthropic. ولمفتاح الدفع حسب الاستخدام تنطبق الصيغة نفسها مع عنوان base URL الإقليمي الموضح أعلاه ونموذج مثل qwen3.8-max. وبعد الحفظ، شغّل hermes chat -q "Hello" للتحقق.

تضيف Qwen Cloud تنبيهًا: قد تتضمن قائمة النماذج في hermes model نماذج لا تدعمها خطتك، وقائمة النماذج المدعومة في الخطة نفسها هي المرجع. ويمكنك اختيار Enter custom model name وكتابة معرّف النموذج.

Qwen4-Max-Preview في Hermes

تصف Qwen Cloud النموذج Qwen4-Max-Preview بأنه نموذجها الرائد متعدد الوسائط من الجيل التالي، للبرمجة والعمل المكتبي وتصميم الواجهات والمهام الوكيلية. معرّف النموذج هو qwen4-max-preview. وهذا ما تقوله صفحات Qwen Cloud عن الوصول إليه:

• إنه معاينة، ومتاح عبر Token Plan فقط. ولا يُدعم الوصول بالدفع حسب الاستخدام.
• تمتد المعاينة من الساعة 10:00 يوم 11 نوفمبر 2026 إلى الساعة 24:00 يوم 25 نوفمبر 2026 (UTC+8). ولن تُجرى أي تغييرات في تلك الفترة، وسيُسحب النموذج بعد انتهاء المعاينة.
• طول السياق 1M رمز. والحد الأقصى للمخرجات 393,216 رمزًا، يتقاسمها التفكير والإجابة النهائية.
• التفكير مفعّل افتراضيًا، ويمكن ضبطه بـ reasoning_effort. ويقبل أيضًا الصور والفيديو، ويدعم استدعاء الأدوات والمخرجات المنظّمة.
• يحتاج إلى مفتاح Token Plan المخصص وعنوان base URL الخاص به، https://token-plan.maas.qwencloudapi.com، مع ضبط معرّف النموذج على qwen4-max-preview.

يسرد توثيق Hermes مزوّدًا باسم alibaba-token-plan لـ Token Plan بوجه عام. أما للنموذج Qwen4-Max-Preview، فاتبع إعداد Hermes الخاص بـ Qwen Cloud بدلًا من ذلك: استخدم المدخل المخصص أعلاه، واضبط default: qwen4-max-preview، وأبقِ provider: custom. ويحذّر دليل Qwen Cloud من ضبط المزوّد على anthropic، وإلا أُعيدت كتابة اسم النموذج وأعاد الطلب الخطأ 400.

تغيير واحد في السلوك يجب أن تخطط له: في واجهة OpenAI Chat Completions، يكافئ max_tokens لهذا النموذج max_completion_tokens، ويسحب التفكير من الميزانية نفسها. فقد يقطع حدٌّ كان يكفي الإجابة وحدها المخرجات الآن. وتقول Qwen Cloud إن نماذج Qwen الحالية تحتفظ بسلوكها السابق.

لا نقول هنا شيئًا عمّا يحدث بعد المعاينة، لأن صفحات Qwen Cloud تقول فقط إن النموذج يُسحب.

لماذا يعيد مفتاح Qwen الخطأ 401

تسرد الأسئلة الشائعة لـ Token Plan Individual لدى Qwen Cloud أخطاء الاتصال الشائعة. وتشمل أسبابها المحتملة عدم تطابق المفاتيح مع نقاط الاتصال، والاشتراكات المنتهية، والمفاتيح المنسوخة ناقصة، ورؤوس الطلب المفقودة.

هناك سببان آخران خارج هذا الجدول. تقول Qwen Cloud إن مفاتيح الدفع حسب الاستخدام خاصة بكل منطقة، فلن يعمل مفتاح أُنشئ لمنطقة مع عنوان base URL لمنطقة أخرى. وداخل Hermes، طابِق المفتاح مع الطريق الذي اخترته: alibaba يقرأ DASHSCOPE_API_KEY، ويمكن لمزوّد Coding Plan الرجوع إلى المتغير نفسه. أما المزوّد alibaba-token-plan فيقرأ ALIBABA_TOKEN_PLAN_API_KEY. وفي الإعداد المخصص من دليل Qwen Cloud، يوضع مفتاح Token Plan في api_key بجانب عنوان base URL الخاص بـ Token Plan.

وهناك جانب فوترة أيضًا. تحذّر Qwen Cloud من أنك إذا أرسلت الطلبات بالمفتاح العام وعنوان base URL العام (مثل عنوان ap-southeast-1) بدل مفتاح Token Plan وعنوانه، فإنها تُوجَّه عبر الفوترة بالدفع حسب الاستخدام. ولا يمكن مقاصة الرسوم التي تكبّدتها بالفعل بالرصيد (Credits) ولا استردادها بعد ذلك. وإذا استمرت المكالمات في الخصم من رصيدك بعد تفعيل خطة، فتحقق من المفتاح وعنوان base URL أولًا.

تحقق من قواعد الخطة قبل ربطها بوكيل يعمل دائمًا

تصف Qwen Cloud خطة Token Plan Individual بأنها للتطوير الشخصي التفاعلي عبر أدوات محددة. ويقول نطاق استخدامها إن المفتاح يجب ألا يُستخدم لسكربتات الأتمتة أو الواجهات الخلفية للتطبيقات المخصصة أو الاستدعاءات الدفعية غير التفاعلية، وإنها لشخص واحد. وتقول أيضًا إن منطقة Token Plan الوحيدة المتاحة هي سنغافورة، بنشر عالمي، فتتضمن الأوامر والمخرجات نقل بيانات عبر الحدود.

أما هل يُعدّ وكيل Hermes الذي يردّ عليك في تطبيق مراسلة استخدامًا تفاعليًا فهذا قرار Qwen Cloud، ولم نرَ بيانًا في أي اتجاه. اقرأ شروط الخطة قبل أن توجّه بوابة تعمل دائمًا إلى مفتاح Token Plan. ومفتاح الدفع حسب الاستخدام هو الطريق الذي يصفه Hermes للاستخدام البرمجي. ولخيارات نماذج أخرى، اطّلع على صفحاتنا عن DeepSeek وGLM وNous Portal.

Qwen على ReadyHermes

يشغّل ReadyHermes وكيل Hermes Agent الخاص بك على خوادمنا، يعمل دائمًا ومتصلًا بتطبيقات المراسلة التي تختارها، ابتداءً من US$3.99 شهريًا (Lite) أو US$6.99 (Pro)، مع US$1 من الذكاء الاصطناعي مشمولة كل شهر على Lite وUS$3 على Pro. وهناك أيضًا تجربة مجانية لمدة ساعة.

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

اختر Qwen في قائمة المزوّدين؛ وتذكر ملاحظة المزوّد أنه Alibaba Cloud. يستدعي نقطة اتصال Alibaba الدولية بالدفع حسب الاستخدام، https://dashscope-intl.aliyuncs.com/compatible-mode/v1، ويقود رابط الحصول على مفتاح إلى Alibaba Cloud Model Studio. ولا يوجد خيار Token Plan أو Coding Plan أو Qwen OAuth، لذلك لا يمكن استخدام qwen4-max-preview، وهو Token Plan فقط، على ReadyHermes أثناء المعاينة. ولم تُختبر معه مفاتيح من Qwen Cloud.