OpenClaw (Clawdbot) — الإعداد وتكامل واجهة البرمجة
ما هو OpenClaw؟
بوابة وكلاء تعمل على أنظمة تشغيل شائعة ويمكنها الاتصال بقنوات مثل WhatsApp و Telegram و Discord و iMessage وغيرها. ترسل رسالة وتتلقى إجابات من وكلائك عبر سطحيات متعددة؛ يمكن إضافة قنوات إضافية عبر الإضافات.
اطلع على المشروع الرسمي لأحدث الميزات والوثائق: OpenClaw.
1. تثبيت OpenClaw
اختر الإجراء المناسب لنظامك.
التثبيت عبر السكربت (موصى به)
macOS / Linux
- التثبيت
curl -fsSL https://openclaw.ai/install.sh | bash
- التحقق
openclaw --version
Windows (PowerShell)
ملاحظة: غالبًا يُشغّل مُثبّت OpenClaw من WSL2. في PowerShell، ابدأ WSL ونفّذ التثبيت داخل WSL.
iwr -useb https://openclaw.ai/install.ps1 | iex
تحقق:
openclaw --version
2. تهيئة OpenClaw
ابدأ المعالج التفاعلي:
openclaw onboard
تدفق نموذجي (قد تختلف الصياغة حسب الإصدار):
- اختر QuickStart
- اختر Skip for now حيث لا تحتاج مفاتيح مزوّد بعد
- اختر All providers (أو الخيار المطابق لخطتك)
- اختر Keep current عند عدم اليقين
- يمكنك Skip خطوات أدوات المحادثة الاختيارية أو skills وإنهاء الإعداد
- فعّل خيارات الخصوصية / البوابة الموصى بها إن اقترحها المعالج
عند اكتمال الإعداد قد يفتح OpenClaw واجهة البوابة في المتصفح.
إذا كانت البوابة غير قيد التشغيل:
openclaw gateway
2. ربط OpenClaw بـ mixgateway.io
1. الحصول على مفتاح API للبوابة
- افتح mixgateway.io وسجّل الدخول.
- في [لوحة التحكم](/dashboard)، افتح API Keys (أو ما يعادلها).
- أنشئ مفتاحًا وانسخه — استخدمه كـ
Authorization: Bearer …مع البوابة.
2. تعديل openclaw.json
بعد التثبيت، يحفظ OpenClaw الإعداد داخل مجلد الإعداد (غالبًا ~/.openclaw).
افتح المجلد
open ~/.openclaw
على Windows + WSL، من هذا المجلد يمكنك فتح Explorer بـ:
explorer.exe .
حرر openclaw.json. ادمج الفكرة التالية مع ملفك الحالي: عيّن مزوّدًا يشير إلى عنوان URL الأساسي المتوافق مع OpenAI https://api.mixgateway.io/v1, واربط agents.defaults.model.primary بمعرف نموذج يستخدم ذلك المزوّد.
مثال (اضبط الأسماء لتطابق إصدار OpenClaw — الهيكل مستوحى من أدلة بوابات خارجية مثل وثائق ApiSet لـ OpenClaw):
{
"agents": {
"defaults": {
"model": {
"primary": "mixgateway/deepseek:deepseek-chat"
},
"models": {
"mixgateway/deepseek:deepseek-chat": {}
}
}
},
"models": {
"mode": "merge",
"providers": {
"mixgateway": {
"baseUrl": "https://api.mixgateway.io/v1",
"apiKey": "PASTE_YOUR_GATEWAY_API_KEY_HERE",
"api": "openai-completions",
"models": [
{
"id": "deepseek:deepseek-chat",
"name": "deepseek-chat",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
}
}
ملاحظات:
- استبدل
PASTE_YOUR_GATEWAY_API_KEY_HEREبمفتاحك الحقيقي من لوحة التحكم. - غيّر
deepseek:deepseek-chatإلى أي نموذج تدعمه البوابة (انظر النماذج والتوجيه). mixgatewayهنا مجرد مفتاح المزوّد في المثال — يمكنك إعادة تسميته، لكن أبقِ agents.defaults.model.primary متزامنًا (providerKey/modelId).
3. إعادة تشغيل البوابة
openclaw gateway restart
يجب أن تعكس واجهة البوابة المزوّد والنموذج الجديدين.
انظر أيضًا
- نظرة عامة على OpenClaw — لماذا تستخدم OpenClaw مع mixgateway.io.
- البدء السريع — استدعاء
https://api.mixgateway.io/v1/chat/completionsمباشرة.