OpenClaw دليل الإعداد
يقوم OpenClaw بإضافة مزود نموذج مخصص عبر models.providers. يستخدم ai2save واجهة OpenAI Compatible، ويجب ملء Base URL بـ https://ai2save.com/v1.
1. التحضير لـ OpenClaw و API Key
يمكن تخطي التثبيت إذا كان OpenClaw مثبتًا بالفعل:
npm install -g openclaw@latest
openclaw --version
- افتح https://ai2save.com/keys.
- أنشئ API Key الذي ينتمي إلى مجموعة نماذج OpenAI / GPT.
- انسخ مفتاح
sk-...الكامل.
2. تحرير ملف إعدادات OpenClaw
ملف الإعدادات الافتراضي لـ OpenClaw هو:
~/.openclaw/openclaw.json
عادةً ما يتم دعم ملفات Windows في %USERPROFILE%\.openclaw\openclaw.json. تدعم الملفات JSON5، ويمكن دمجها في التكوين الحالي حسب الهيكل التالي:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-مفتاحك-الخاص",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
شرح الحقول الأساسية:
models.providers.ai2save.baseUrl: يجب أن يكون مصحوبًا بـ/v1.api: "openai-completions": نوع الواجهة الذي تستخدمه OpenClaw بالوكالة لـ OpenAI Compatible.models[].id: يجب أن يتطابق تمامًا مع معرف النموذج الذي يفتحه ai2save في وحدة التحكم.agents.defaults.model.primary: التنسيق هومعرّف-المزوّد/معرّف-النموذج.apiKeyيمكن كتابته مباشرة كـ"sk-..."؛ عند الرجوع إلى${AI2SAVE_API_KEY}، يجب تعريفه فيenv.vars.
إذا كنت تريد إضافة عدة نماذج، استمر في إضافة المزيد ضمن مصفوفة models، وغيّر primary إلى ai2save/model-id الذي تريد استخدامه كافتراضي.
3. تطبيق وفحص التكوين
ستستمع OpenClaw Gateway لتغييرات ملف التكوين وتطبقها تلقائيًا. إذا لم يتم تفعيل التكوين في الوقت المناسب، قم بتنفيذ:
openclaw gateway restart
ثم تحقق مما إذا كان النموذج قد ظهر بالفعل في OpenClaw:
openclaw models list --provider ai2save
قم بتغيير النموذج الافتراضي إلى ai2save:
openclaw models set ai2save/gpt-5.5
إذا لم يظهر النموذج، قم بتشغيل التشخيص وتحقق من أخطاء التكوين:
openclaw doctor
4. التحقق من الطلب
- افتح واجهة الدردشة الخاصة بـ OpenClaw أو WebChat.
- أنشئ محادثة جديدة، وأرسل "مرحبًا، يرجى الإبلاغ عن اسم النموذج الحالي".
- تأكد من أن توجيه النموذج يظهر كـ
ai2save/gpt-5.5. - في المرة الأولى، تحقق فقط من مهام النصوص، وبعد النجاح قم بفتح الأدوات المعقدة مثل الملفات والمتصفح والسياق الطويل.
يقوم OpenClaw تلقائيًا بمعالجة التوافق مع وكلاء OpenAI غير الرسميين، فلا حاجة لفتح developer role يدويًا. إذا واجهت خللًا عند استدعاء الأدوات، تأكد أولاً من أن معرف النموذج يدعم استدعاء الأدوات، ثم قم بزيادة وقت المهلة.
5. الأخطاء الشائعة
- 401 / invalid_api_key:
AI2SAVE_API_KEYلم يتم تعريفه، أو تم نسخ المفتاح بشكل غير كامل، أو مجموعة المفاتيح غير متطابقة. - 404 / model not found:
models[].id،primaryأو اسم النموذج المطلوب الفعلي غير متطابقة. - فشل الاتصال / empty response: تحقق مما إذا كان
baseUrlهوhttps://ai2save.com/v1، ولا تكتب العنوان الجذري. - قائمة النماذج فارغة: تحقق من
models.mode: "merge"، وتأكد من أنmodels.providers.ai2save.models[]يحتوي على نموذج واحد على الأقل. - لم تسري التغييرات بعد حفظ الإعدادات: أعد تنفيذ
openclaw doctor، وإذا لزم الأمر، أعد تشغيل OpenClaw Gateway.