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

> **آخر تحقق**: 2026-11-13 · 📄 وفق الوثائق الرسمية (LobsterAI 2026.11.6، صدر في 2026-11-06: README، دليل المستخدم، مصدر المستودع؛ وأُعيد التحقق من أمثلة معرّفات النماذج مقابل qcode.cc/models في 2026-11-13)

هل يمكن لـ LobsterAI استخدام مفتاح API الخاص بك؟ نعم. حتى 2026-11-10، ووفقًا لـREADME الرسمي ومصدر المستودع وردّ أحد القائمين على الصيانة: افتح **Settings → Custom Model**، وانقر على **+ Add Custom** أسفل قائمة المزوّدين، واختر **Anthropic Compatible (Messages)** أو **OpenAI Compatible (Chat Completions)** ضمن **API Format**، وأدخل Base URL الخاص بـQCode والمفتاح `cr_` الخاص بك، وأضف معرّف النموذج، ثم انقر على **Test Connection**.

## نظرة سريعة

| البند | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (Anthropic Compatible) · GPT ✅ (OpenAI Compatible) · GLM / Kimi / DeepSeek / Qwen ✅ (أي منهما) · Gemini ❌ (لا يوفره QCode في الوقت الحالي) |
| Base URL | Anthropic Compatible (Messages): `https://api.qcode.cc/api` · OpenAI Compatible (Chat Completions): `https://api.qcode.cc/openai/v1` |
| مكان الإعداد | داخل التطبيق: **Settings → Custom Model → + Add Custom** |
| الوثائق الرسمية | [دليل إعداد النموذج](https://lobsterai.youdao.com/en/docs/lobsterai_model_config_guide) · [دليل المستخدم](https://lobsterai.youdao.com/en/docs/lobsterai_user_manual) · [مستودع GitHub](https://github.com/netease-youdao/LobsterAI) |

تصف الأسئلة الشائعة الرسمية LobsterAI (الاسم الصيني: Youdao Lobster) بوصفه وكيل ذكاء اصطناعي مفتوح المصدر لسطح المكتب من NetEase Youdao، مُصممًا كمساعد مكتبي لجميع السيناريوهات. وهو مبني على OpenClaw، إطار عمل الوكلاء مفتوح المصدر، ويعمل على macOS (Apple Silicon وIntel) وWindows، وصدر بموجب ترخيص MIT على GitHub (netease-youdao/LobsterAI). وهو منتج مختلف عن [OpenClaw](/docs/ide/openclaw): OpenClaw هو إطار عمل وقت التشغيل، وLobsterAI عميل مكتبي بواجهة مستخدم خاصة به.

الإصدار: حتى 2026-11-10، الإصدار الذي يضع عليه GitHub علامة **Latest** هو `LobsterAI 2026.11.6` (نُشر في 2026-11-06)؛ ولا تزال الصفحة الرئيسية للموقع الرسمي تعرض 2026.10.30 في اليوم نفسه. تم التحقق من تسميات واجهة المستخدم أدناه مقابل مصدر 2026.11.6.
## أي بروتوكول تستخدم

يوفّر المزوّد المخصص عدة صيغ API. وتغطي اثنتان منها الاستخدام اليومي مع QCode:

- **Anthropic Compatible (Messages)** + `https://api.qcode.cc/api`: نماذج Claude، وأيضًا GLM / Kimi / DeepSeek / Qwen.
- **OpenAI Compatible (Chat Completions)** + `https://api.qcode.cc/openai/v1`: نماذج GPT، وأيضًا GLM / Kimi / DeepSeek / Qwen.

يعمل مفتاح `cr_` واحد مع كلا الصيغتين. تُقدَّم نماذج Claude على نقطة نهاية Anthropic فقط، ونماذج GPT على نقاط نهاية OpenAI فقط؛ والمصفوفة الكاملة في [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths). تُغطّى صيغة **OpenAI Compatible (Responses)** في قسم اختياري أدناه.

## التثبيت

يشير ملف README الرسمي إلى [صفحة التنزيل](https://lobsterai.youdao.com/#/download-list) (macOS Apple Silicon، macOS Intel، Windows x64)، أو إلى أحدث مثبّتات على GitHub Releases. لا تحتاج إلى حساب لدى أي مزوّد نماذج: أنشئ مفتاح `cr_` في [لوحة التحكم](https://qcode.cc/dashboard) واحتفظ به في متناول يدك.

## الإعداد

تصف المصادر الرسمية مسار القائمة بصياغات مختلفة قليلًا:

- README: أضف مفتاح API الخاص بك ضمن **Settings → Custom Model**.
- ردّ أحد مشرفي المستودع في المسألة #362 (2026-10-06): «أضف مزوّدًا مخصصًا ضمن Settings → Custom Models … اختر خيارًا متوافقًا مع OpenAI مع Base URL … والمفتاح …، وأضف معرّف نموذج … وشغّل Test Connection». ويقول الردّ نفسه إنه بعد اختبار ناجح يُفعَّل المزوّد تلقائيًا ويمكن اختياره من محدّد النموذج في مربع الإدخال؛ والصيغة المتوافقة مع Anthropic هي الخيار الآخر.
- يشير دليل المستخدم ودليل إعداد النماذج إلى الصفحة نفسها باسم **Settings → Models** (وهي أيضًا الصفحة التي تُضبط فيها المزوّدات المدمجة مثل DeepSeek وMoonshot وZhipu وMiniMax وQwen). إنها ليست صفحة ثانية: في مصدر 2026.11.6 تحمل صفحة الإعدادات هذه التسمية **Custom Model**، وتقع المزوّدات المدمجة و**+ Add Custom** في القائمة نفسها.

### الخطوة 1: إضافة مزوّد مخصص

1. افتح الإعدادات وانتقل إلى **Custom Model**.
2. انقر على **+ Add Custom** أسفل قائمة المزوّدين.
3. املأ الحقول أدناه (التسميات كما في سلاسل واجهة المستخدم الإنجليزية في مصدر 2026.11.6).

| الحقل | نماذج Claude والنماذج الصينية | نماذج GPT والنماذج الصينية |
|---|---|---|
| اسم العرض | `QCode` (أي اسم) | `QCode OpenAI` (أي اسم) |
| صيغة API | `Anthropic Compatible (Messages)` | `OpenAI Compatible (Chat Completions)` |
| API Base URL | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| مفتاح API | `cr_xxx` | `cr_xxx` |

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

### الخطوة 2: هل يحتاج Base URL إلى `/v1`؟

تجيب عن ذلك ثلاثة مصادر رسمية:

1. التلميح الموجود أسفل **API Format**: «يجب أن يطابق البروتوكول الكامن وراء Base URL الخاص بك؛ عادةً ما تنتهي عناوين URL المتوافقة مع OpenAI بـ /v1».
2. تقرن الأمثلة الموجودة أسفل حقل Base URL («Examples (SiliconFlow, click to fill)») **OpenAI Compatible** بـ `https://api.siliconflow.cn/v1` و**Anthropic Compatible** بـ `https://api.siliconflow.cn`، الذي لا يحتوي على `/v1` (مصدر المستودع).
3. يبني **Test Connection** مسار الطلب بنفسه (مصدر المستودع، 2026.11.6). ترسل صيغة Anthropic إلى Base URL + `/v1/messages`، أو إلى `/messages` فقط عندما ينتهي Base URL بالفعل بـ `/v1`. ترسل صيغة OpenAI Chat Completions إلى Base URL + `/chat/completions` عندما ينتهي Base URL بإصدار مثل `/v1`، وتضيف `/v1` أولًا بخلاف ذلك. ترسل صيغة Responses إلى Base URL + `/responses`، وتضيف أيضًا `/v1` أولًا عندما يكون مفقودًا.

لذلك أدخل `https://api.qcode.cc/api` من أجل Anthropic Compatible (ثم يستدعي الاختبار `/api/v1/messages`) و`https://api.qcode.cc/openai/v1` من أجل OpenAI Compatible (يستدعي الاختبار `/openai/v1/chat/completions`). لا تضف `/v1/messages` أو `/chat/completions` إلى الحقل بنفسك. لم يُشغَّل هذا الإعداد على تثبيت LobsterAI من جانبنا، لذا فإن نتيجة **Test Connection** هي الكلمة الفصل. على شبكة غير مستقرة يمكنك استبدال المضيف بـ `asia.qcode.cc` (آسيا) أو `us.qcode.cc` (أمريكا الشمالية)؛ ويبقى المسار كما هو.

### الخطوة 3: إضافة نموذج واختبار الاتصال

1. في المزوّد الجديد انقر على **Add Model** واملأ **Model Name** (التسمية الظاهرة في القائمة) و**Model ID**.
2. يجب أن يطابق **Model ID** نموذجًا معروضًا للبيع على [qcode.cc/models](https://qcode.cc/models) حرفًا بحرف، على سبيل المثال:

| صيغة API | أمثلة على Model ID |
|---|---|
| Anthropic Compatible (Messages) | `claude-sonnet-5-5`, `claude-opus-5-5`, `claude-haiku-5-5`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max` |
| OpenAI Compatible (Chat Completions) | `gpt-6.1-sol`, `gpt-6.1-terra`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max` |

3. انقر على **Test Connection**. وفقًا لردّ المشرف في المسألة #362، بعد النجاح يُفعَّل المزوّد تلقائيًا ويمكنك اختياره من محدّد النموذج في مربع الإدخال. أسعار كل نموذج على https://qcode.cc/models.

### اختياري: OpenAI Compatible (Responses)

تقول ملاحظات الإصدار الرسمية بتاريخ 2026.10.23: «تدعم المزوّدات المخصصة الآن OpenAI Responses وواجهات API الأصلية لـ Gemini». الخيار هو **OpenAI Compatible (Responses)**، مع التلميح «يتطلب أن يدعم المزوّد OpenAI Responses API. تذهب الطلبات إلى Base URL + /responses». على QCode، تخدم Responses نماذج GPT؛ ومع Base URL `https://api.qcode.cc/openai/v1` يصل الطلب إلى `/openai/v1/responses`، الذي تدرجه صفحة نقاط النهاية مكافئًا لـ `/openai/responses`. للاستخدام اليومي، يكفي **OpenAI Compatible (Chat Completions)**. لا يوفّر QCode نماذج Gemini في الوقت الحالي، لذا يبقى خيار **Gemini (generateContent)** دون استخدام.
## التحقق

1. انقر على **Test Connection**؛ ظهور "Connection successful" يعني أن المسار والمفتاح يعملان معًا.
2. بعد العودة إلى مربع الإدخال، اختر النموذج الجديد من محدد النموذج وأرسل `ping`.
3. للتحقق من الشبكة والمفتاح من الطرفية أولًا (رمز 400 عند إرسال جسم فارغ يعني أن المسار والمفتاح سليمان):

```bash
KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/api/v1/messages -H "x-api-key: $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)؛ أدخل مفتاحك لترى النموذج ورمز الحالة لكل استدعاء.

## القيود المعروفة والأخطاء الشائعة

من الدليل الرسمي وسجل التغييرات ومصدر المستودع والمشكلات:

- **Responses على المزوّدات المخصصة (المشكلة #185)**: طلبت المشكلة #185 (المفتوحة بتاريخ 2026-02-28) دعم صيغة API الأحدث من OpenAI على المزوّدات المخصصة؛ وكان جواب المشرف حينها تغيير لغة التطبيق إلى الإنجليزية واستخدام مزوّد OpenAI المدمج. الحالة الحالية: منذ 2026.10.23 تدعم المزوّدات المخصصة Responses من OpenAI (راجع القسم الاختياري أعلاه).
- **لغة التطبيق تغيّر قائمة المزوّدات المدمجة**: يوضح المشرف في المشكلتين #87 و#185 أن واجهة المستخدم الإنجليزية تسرد مزوّدات مدمجة إضافية مثل OpenAI وGemini. الحالة الحالية: لا يزال مصدر الإصدار 2026.11.6 يختار القائمة المدمجة وفق لغة واجهة المستخدم ويعرض المزوّدات المخصصة في اللغتين، لذا فإن إعداد QCode واحد في الواجهتين الصينية والإنجليزية.
- **معرّف Claude تحت صيغة OpenAI**: يجيب QCode بالخطأ `model_not_available_on_endpoint`. غيّر **API Format** لذلك المزوّد إلى **Anthropic Compatible (Messages)** مع `https://api.qcode.cc/api`؛ فالمسألة عدم تطابق في البروتوكول وليست مشكلة في المفتاح.
- **معرّف نموذج غير معروف**: في المشكلة #87 أجابت خدمة أخرى بالخطأ `invalid param model:claude-haiku-4-5-20251001` (رمز 400) لأنها لا تعرف ذلك المعرّف. مع QCode، استخدم فقط المعرّفات المتاحة للبيع على [qcode.cc/models](https://qcode.cc/models).
- يسرد دليل إعداد النماذج الرسمي أربع رسائل خطأ: "API Key Invalid" و"Insufficient Balance" و"Network Error" و"Service Unavailable". في QCode: انسخ المفتاح الكامل `cr_` مرة أخرى، وتحقق من رصيدك في QCode، وتحقق من الشبكة، ثم تحقق من حالة الخدمة.
- تخزين المفتاح: ينص الدليل الرسمي على أن مفتاح API يُخزَّن على جهازك المحلي فقط ولا يُرفع إلى أي خادم.

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

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