الدرس 01 — البداية السريعة: تشغيل مساعدك الشخصي بالذكاء الاصطناعي في 5 دقائق
الهدف: تثبيت OpenClaw، وإعداد نموذج MiniMax، وتشغيل البوابة، وإرسال أول رسالة.
ما تحتاجه
- macOS / Linux (يحتاج Windows إلى WSL2)
- Node.js 22+ (يُنصح باستخدام nvm للإدارة)
- pnpm 9+
- مفتاح MiniMax API Key (رابط التسجيل)
الخطوة الأولى: استنساخ المستودع وتثبيت التبعيات
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm installالخطوة الثانية: إعداد متغيرات البيئة
انسخ ملف .env النموذجي وأدخل مفتاح MiniMax API الخاص بك:
cp .env.example .env # إذا لم يكن هناك نموذج، أنشئ ~/.openclaw/.env مباشرةًعدّل ملف .env وأضف:
MINIMAX_API_KEY=sk-مفتاحكالخطوة الثالثة: إنشاء ملف الإعداد
أنشئ ~/.openclaw/openclaw.json:
{
"gateway": { "mode": "local" },
"env": { "MINIMAX_API_KEY": "${MINIMAX_API_KEY}" },
"agents": {
"defaults": {
"model": { "primary": "minimax/MiniMax-M2.1" }
}
},
"models": {
"mode": "merge",
"providers": {
"minimax": {
"baseUrl": "https://api.minimax.io/anthropic",
"apiKey": "${MINIMAX_API_KEY}",
"api": "anthropic-messages",
"models": [
{
"id": "MiniMax-M2.1",
"name": "MiniMax M2.1",
"reasoning": false,
"input": ["text"],
"cost": { "input": 15, "output": 60, "cacheRead": 2, "cacheWrite": 10 },
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}الخطوة الرابعة: تثبيت البوابة وتشغيلها
pnpm openclaw gateway install
pnpm openclaw gateway startتحقق من الحالة:
pnpm openclaw gateway status
# يجب أن ترى: Runtime: running و RPC probe: okالخطوة الخامسة: فتح واجهة WebChat للمحادثة
افتح المتصفح واذهب إلى:
http://127.0.0.1:18789/
اكتب رسالتك الأولى، مثلاً:
"مرحباً! ساعدني في كتابة دالة فرز فقاعي بلغة Python"
التحقق من النموذج
pnpm openclaw models list
# يجب أن ترى: minimax/MiniMax-M2.1 defaultالأسئلة الشائعة
هل يدعم OpenClaw نظام Windows؟
يدعم OpenClaw نظامي macOS وLinux. يحتاج مستخدمو Windows إلى تثبيت WSL2 (نظام Windows الفرعي لـ Linux)، ثم اتباع نفس الخطوات داخل بيئة WSL2. يمكن الرجوع إلى الوثائق الرسمية من Microsoft لتعليمات تثبيت WSL2.
ما هي نماذج الذكاء الاصطناعي التي يدعمها OpenClaw غير MiniMax؟
يدعم OpenClaw عدة مزودي نماذج رئيسيين، بما فيهم MiniMax (M2.1، M2.5، VL-01)، وAnthropic (Claude Sonnet، Opus)، وOpenAI (GPT-4o) وغيرهم. راجع الدرس 05 لمعرفة طريقة إعداد نماذج متعددة.
ماذا أفعل إذا لم أتمكن من فتح المتصفح بعد تشغيل البوابة؟
تأكد أولاً من أن المنفذ غير مشغول: lsof -i :18789. إذا كان هناك تعارض في المنفذ، عدّل حقل gateway.port في ملف openclaw.json ثم أعد التشغيل. إذا كانت المشكلة في جدار الحماية، تأكد من أن الوصول إلى localhost غير محجوب.
كيف أتعامل مع أخطاء pnpm install؟
السبب الأكثر شيوعاً هو أن إصدار Node.js لا يستوفي المتطلبات (يلزم 22+). شغّل node -v للتحقق من الإصدار، ويُنصح باستخدام nvm: nvm install 22 && nvm use 22، ثم أعد تنفيذ pnpm install.
ماذا أفعل إذا لم يستجب الذكاء الاصطناعي بعد إرسال الرسالة؟
شغّل pnpm openclaw gateway status للتحقق من أن البوابة تعمل (يجب أن ترى Runtime: running). ثم شغّل pnpm openclaw models list للتأكد من تحميل النموذج بشكل صحيح. إذا كانت قائمة النماذج فارغة، تحقق من صحة إعداد مفتاح API.