من الصفر إلى مساعد ذكي في 5 دقائق
اختر منصّتك وتابع الخطوات. ستتحدث مع ذكائك الاصطناعي في وقت قصير.
التثبيت على macOS
أسرع طريقة للبدء. يتطلب Node.js 18+.
ثبّت OpenClaw
npm install -g openclawشغّل معالج الإعداد
سيرشدك خلال تهيئة مفتاح API والإعدادات الأساسية.
openclaw initشغّل البوابة
البوابة هي خدمة الخلفية التي تتولى جميع الاتصالات.
openclaw gateway startقُل مرحباً!
openclaw chat "Hello! What can you do?"التثبيت على Windows
يعمل OpenClaw بامتياز على Windows عبر WSL2 (مُوصى به) أو Node.js الأصلي.
إعداد WSL2 (مُوصى به)
إذا لم يكن WSL2 مُثبّتاً، افتح PowerShell كمسؤول وشغّل:
wsl --installأعد تشغيل الحاسوب بعد التثبيت.
ثبّت Node.js في WSL
افتح طرفية WSL (Ubuntu) وثبّت Node.js:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejsثبّت OpenClaw
npm install -g openclawهيّئ وشغّل
openclaw init
openclaw gateway start
openclaw chat "Hello!"التثبيت على Linux
يعمل على أي توزيعة بها Node.js 18+. مثالي للخوادم!
ثبّت Node.js (إن لزم)
"comment"># Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
"comment"># Arch
sudo pacman -S nodejs npmثبّت OpenClaw
npm install -g openclawهيّئ وشغّل
openclaw init
openclaw gateway startاختبر
openclaw chat "Hello! What can you do?"التثبيت باستخدام Docker
ممتاز للعزل والنشر السهل. يعمل أينما يعمل Docker.
اسحب الصورة
docker pull openclaw/openclaw:latestشغّل معالج الإعداد
docker run -it \
-v openclaw-config:/home/openclaw/.openclaw \
openclaw/openclaw:latest initشغّل البوابة
docker run -d \
--name openclaw \
--restart unless-stopped \
-v openclaw-config:/home/openclaw/.openclaw \
openclaw/openclaw:latest gateway startتحدّث
docker exec -it openclaw openclaw chat "Hello!"النشر على السحابة
نشر بنقرة واحدة للتوافر الدائم.
احصل على مفتاح API
يحتاج OpenClaw إلى مفتاح API من مزوّد الذكاء الاصطناعي المفضل لديك.
استكشاف الأخطاء وإصلاحها
المشكلات الشائعة وكيفية حلّها.
Command not found: openclaw
Make sure npm's global bin directory is in your PATH. Try:
npm config get prefixAdd the returned path + /bin to your shell's PATH variable.
Gateway won't start
Check if the port is already in use. The gateway runs on port 3000 by default.
lsof -i :3000 # macOS/Linux
netstat -ano | findstr :3000 # WindowsYou can also try restarting: openclaw gateway restart
API key not working
Verify your API key is correctly set:
openclaw config showMake sure there are no extra spaces. You can reset it with openclaw init.
WhatsApp QR code not appearing
The WhatsApp QR code is shown in the terminal. Make sure you run the command in a terminal that supports QR display. If issues persist, see the official WhatsApp docs.
ما زلت عالقاً؟
🎉 أنت جاهز!
الآن بعد أن يعمل OpenClaw، إليك الخطوات التالية: