First steps
بدء الاستخدام
ثبّت OmeniaClaw، وشغّل الإعداد الأولي، وتحدث مع مساعد الذكاء الاصطناعي الخاص بك — كل ذلك في نحو 5 دقائق. في النهاية سيكون لديك Gateway قيد التشغيل، ومصادقة مهيّأة، وجلسة دردشة عاملة.
ما تحتاجه
- Node.js — يُوصى باستخدام Node 24 (Node 22.16+ مدعوم أيضًا)
- مفتاح API من مزوّد نماذج (Anthropic أو OpenAI أو Google أو غيرها) — سيطلبه منك الإعداد الأولي
الإعداد السريع
ثبّت OmeniaClaw
macOS / Linux
curl -fsSL https://omeniaclaw.com/install.sh | bashWindows (PowerShell)
iwr -useb https://omeniaclaw.com/install.ps1 | iexشغّل الإعداد الأولي
OmeniaClaw onboard --install-daemonيرشدك المعالج خلال اختيار مزوّد نماذج، وتعيين مفتاح API، وتهيئة Gateway. يستغرق ذلك نحو دقيقتين.
راجع الإعداد الأولي (CLI) للاطلاع على المرجع الكامل.
تحقق من أن Gateway قيد التشغيل
OmeniaClaw gateway statusينبغي أن ترى Gateway يستمع على المنفذ 18789.
افتح لوحة التحكم
OmeniaClaw dashboardيفتح هذا واجهة التحكم في متصفحك. إذا تم تحميلها، فكل شيء يعمل.
أرسل رسالتك الأولى
اكتب رسالة في دردشة واجهة التحكم، وينبغي أن تتلقى ردًا من الذكاء الاصطناعي.
هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة يمكن إعدادها هي Telegram (مجرد رمز بوت). راجع القنوات للاطلاع على كل الخيارات.
متقدم: تثبيت إصدار مخصص من واجهة التحكم
إذا كنت تدير إصدارًا مترجمًا أو مخصصًا من لوحة التحكم، فاجعل
gateway.controlUi.root يشير إلى دليل يحتوي على الأصول الثابتة
المبنية لديك وindex.html.
mkdir -p "$HOME/.OmeniaClaw/control-ui-custom"# Copy your built static files into that directory.ثم عيّن:
{"gateway": { "controlUi": { "enabled": true, "root": "$HOME/.OmeniaClaw/control-ui-custom" }}}أعد تشغيل Gateway وافتح لوحة التحكم من جديد:
OmeniaClaw gateway restartOmeniaClaw dashboardما الخطوة التالية
Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد.
تحكّم في من يمكنه مراسلة وكيلك.
النماذج والأدوات وبيئة العزل والإعدادات المتقدمة.
المتصفح وexec وبحث الويب وSkills وPlugins.
متقدم: متغيرات البيئة
إذا كنت تشغّل OmeniaClaw كحساب خدمة أو تريد مسارات مخصصة:
OmeniaClaw_HOME— الدليل الرئيسي لحلّ المسارات الداخليةOmeniaClaw_STATE_DIR— تجاوز دليل الحالةOmeniaClaw_CONFIG_PATH— تجاوز مسار ملف الإعدادات
المرجع الكامل: متغيرات البيئة.