# إعداد AutoClaw مع QCode (نموذج مخصص)

> **آخر تحقق**: 2026-11-10 · 📄 وفق الوثائق الرسمية (موقع AutoClaw الصيني v2.3.0، صدر في 2026-10-29)

هل يمكن لـ AutoClaw استخدام مفتاح API الخاص بك؟ نعم، عبر بروتوكول OpenAI. حتى 2026-11-10، ووفق الوثائق الرسمية والمدونة الرسمية: الإعدادات → النماذج وAPI → إضافة نموذج مخصص، واضبط المزوّد على مخصص وبروتوكول API على OpenAI، وأدخل عنوان QCode OpenAI في Base URL، ثم شغّل اختبار الاتصال واضبط النموذج كافتراضي.

## نظرة سريعة

| البند | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | GPT ✅ · النماذج الصينية ✅ (DeepSeek / GLM / Kimi / Qwen) · Claude ❌ (البروتوكول المخصص الموثق هو OpenAI) · Gemini ❌ (لا يوفره QCode في الوقت الحالي) |
| البروتوكول وBase URL | OpenAI: `https://api.qcode.cc/openai/v1` |
| مكان الإعداد | داخل التطبيق: الإعدادات → النماذج وAPI → إضافة نموذج مخصص |
| الوثائق الرسمية | [إعدادات النموذج](https://autoclaw.zhipuai.cn/docs/advanced/models/) · [دليل إعداد نموذج محلي](https://autoclaw.zhipuai.cn/blog/news/autoclaw-local-model-setup-guide/) · [سجل التغييرات](https://autoclaw.zhipuai.cn/changelog/) |

يصف مركز الوثائق الرسمي AutoClaw بأنه منتج وكيل ذكاء اصطناعي لسطح المكتب من Zhipu، وأول تطبيق OpenClaw محلي يُثبّت بنقرة واحدة. هناك موقع صيني (autoclaw.zhipuai.cn) وموقع دولي (autoclaw.z.ai، تصف صفحته الإنجليزية أنه وكيل عام طوّرته Z.ai). أما الإصدارات حتى 2026-11-10: فيسرد سجل التغييرات على الموقع الصيني v2.3.0 (2026-10-29) كأحدث إصدار؛ ويسرد سجل التغييرات الدولي v1.17.8 (2026-08-27) في اليوم نفسه.

الشاشة موثقة فقط على الموقع الصيني، بالصينية، لذا فإن التسميات الواردة أدناه هي ترجمتنا لنص الواجهة الصينية. لا يوجد لدى الموقع الدولي صفحة مطابقة، لذا اتبع التسميات الظاهرة على الشاشة في النسخة التي ثبّتتها.

## أي بروتوكول تستخدم

في مثال النموذج المخصص في المدونة الرسمية، يُضبط بروتوكول API على OpenAI، وتقول المدونة إن AutoClaw يعمل مع أي خدمة نماذج متوافقة مع بروتوكول OpenAI Chat Completions. على QCode، يقدّم هذا البروتوكول GPT والنماذج الصينية (DeepSeek / GLM / Kimi / Qwen)، وBase URL هو `https://api.qcode.cc/openai/v1`.

تُقدَّم نماذج Claude عبر نقطة نهاية Anthropic، وهي لا تستخدمها شاشة النموذج المخصص في AutoClaw. إذا كنت تحتاج إلى Claude، فانظر إلى الأدوات التي تقبل نقطة نهاية Anthropic: [LobsterAI](/docs/ide/lobsterai)، [Qoder](/docs/ide/qoder)، [OpenClaw](/docs/ide/openclaw)، أو Claude Code في الطرفية ([التثبيت](/docs/getting-started/installation)). توجد مصفوفة النموذج حسب البروتوكول كاملة في [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).
## التثبيت

نزّل مثبّت macOS أو Windows من [الموقع الصيني](https://autoclaw.zhipuai.cn/) (تذكر المدونة الرسمية أن macOS وWindows مدعومان)، واتبع دليل التشغيل الأول لتعيين دليل عمل. تحتاج أيضًا إلى مفتاح QCode من نوع `cr_` من [لوحة التحكم](https://qcode.cc/dashboard)؛ ولا يلزم حساب لدى أي مزوّد نماذج.

## التهيئة

المسار في المدونة الرسمية (2026-10-26): افتح AutoClaw، وانقر على أيقونة الإعدادات في أسفل اليسار، واختر «Models & API» من قائمة التنقل اليسرى. تحتوي الصفحة على منطقتين: النماذج المضمّنة والنماذج المخصصة. انقر على «Add custom model» على اليمين، وفي مربع الحوار عيّن المزوّد إلى Custom. توفّر صفحة إعدادات النموذج الرسمية مدخلًا آخر: انقر على النموذج الحالي في مربع المحادثة، وانقر على «+» لإضافة نموذج مخصص، فينتقل التطبيق إلى «Settings → Models & API».

املأ مربع الحوار كما يلي:

| الحقل | القيمة |
|---|---|
| المزوّد | `Custom` |
| معرّف النموذج | معرّف نموذج متاح للبيع على [qcode.cc/models](https://qcode.cc/models) تمامًا، مثل `gpt-6.1-sol` |
| بروتوكول API | `OpenAI` |
| Base URL | `https://api.qcode.cc/openai/v1` |
| مفتاح API | مفتاحك `cr_xxx` |

أمثلة على معرّفات النماذج: `gpt-6.1-sol`، `gpt-6.1-terra`، `glm-5.3`، `deepseek-v4.1-flash`، `kimi-k3`، `qwen3.8-max`. توجد أسعار كل نموذج على https://qcode.cc/models.

### هل يحتاج Base URL إلى `/v1`؟

نعم، وتوقّف عند `/v1`. يستند ذلك إلى مثال المدونة الرسمية: بالنسبة إلى Ollama، يكون Base URL هو `http://localhost:11434/v1`، وهو ما تسميه المدونة عنوان نقطة النهاية المتوافقة مع OpenAI لدى Ollama، وتوضح أن مسار `/v1` لدى Ollama يقدّم API المتوافق مع OpenAI. وبالنسبة إلى QCode يصبح `https://api.qcode.cc/openai/v1`؛ لا تُلحق `/chat/completions`. لا تذكر الوثائق الرسمية أي مقطع مسار يلحقه AutoClaw بـ Base URL، لذا اترك اختبار الاتصال في الخطوة التالية ليحسم الأمر. على شبكة غير مستقرة في آسيا يمكنك استبدال المضيف بـ `asia.qcode.cc`؛ ويبقى المسار كما هو.

### اختبار الاتصال والتعيين كافتراضي

1. بعد ملء الحقول، انقر على اختبار الاتصال. تذكر المدونة الرسمية أن التطبيق يرسل طلبًا حقيقيًا، وأن ظهور حالة تفيد بنجاح الاختبار يعني أن التهيئة صحيحة.
2. انقر على «Add» لتسجيل النموذج.
3. بعد العودة إلى قائمة النماذج، اعثر على النموذج الجديد وانقر على «Set as default»؛ وستعمل مهام AutoClaw عليه بعد ذلك. تذكر المدونة أيضًا أنه يمكنك الاحتفاظ بعدة نماذج مخصصة والتبديل بينها يدويًا.

## التحقق

بعد نجاح الاختبار، اختر النموذج في مربع المحادثة وأرسل `ping`. للتحقق من الشبكة والمفتاح من الطرفية أولًا (يعني رمز 400 على جسم فارغ أن المسار والمفتاح سليمان):

```bash
KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = path and key fine; 401 = bad key; 404 = wrong path prefix
```

يظهر كل طلب على [probe.qcode.cc](https://probe.qcode.cc)؛ أدخل مفتاحك لترى النموذج ورمز الحالة لكل استدعاء.

## قيود معروفة

- **يجب أن يدعم النموذج استدعاء الأدوات**: تذكر المدونة الرسمية أن قدرات AutoClaw الأساسية تعتمد على استدعاء الأدوات، لذا يجب أن يدعم النموذج المختار استدعاء الدوال؛ وإلا فيمكنه المحادثة لكنه لا يستطيع تشغيل Skills وتتعطّل سلسلة المهام.
- **تعمل نماذج الجهات الخارجية باستقلالية**: تذكّرك صفحة إعدادات النموذج الرسمية بمراقبة حالة خدمة الجهة الخارجية وفوترة استخدامها، لأن الطلبات قد تستمر في الانطلاق أثناء الاستخدام. يظهر استخدامك لـ QCode في لوحة التحكم وعلى [probe.qcode.cc](https://probe.qcode.cc).

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

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — البروتوكولات وكيفية ملء Base URL
- [نظرة عامة على توافق الأدوات](/docs/ide/tool-compatibility) — دعم البروتوكولات عبر جميع الأدوات
- [تكامل LobsterAI](/docs/ide/lobsterai) — مبني أيضًا على OpenClaw؛ وتقبل نماذجه المخصصة Anthropic Compatible
- [تكامل OpenClaw](/docs/ide/openclaw) — تهيئة إطار عمل OpenClaw نفسه
- [النماذج الصينية](/docs/usage/cn-models) — معرّفات GLM / Kimi / DeepSeek / Qwen المتاحة للبيع حاليًا
- [دليل استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting)