Skip to main content

تثبيت Nix

الطريقة الموصى بها لتشغيل OpenClaw باستخدام Nix هي عبر nix-openclaw — وحدة Home Manager متكاملة «تشمل كل ما يلزم».

البدء السريع

الصق هذا في وكيل الذكاء الاصطناعي لديك (Claude، Cursor، إلخ):
📦 الدليل الكامل: github.com/openclaw/nix-openclaw يُعد مستودع nix-openclaw المصدر المعتمد لتثبيت Nix. هذه الصفحة مجرد نظرة سريعة.

ما الذي ستحصل عليه

  • Gateway (البوابة) + تطبيق macOS + أدوات (whisper، spotify، cameras) — جميعها مُثبّتة الإصدارات
  • خدمة Launchd تستمر عبر عمليات إعادة التشغيل
  • نظام إضافات مع تهيئة تصريحية
  • تراجع فوري: home-manager switch --rollback

سلوك وقت التشغيل في وضع Nix

عند تعيين OPENCLAW_NIX_MODE=1 (يتم تلقائيًا مع nix-openclaw): يدعم OpenClaw وضع Nix الذي يجعل التهيئة حتمية ويعطّل تدفقات التثبيت التلقائي. يمكنك تمكينه عبر التصدير:
على macOS، لا يرث تطبيق الواجهة الرسومية تلقائيًا متغيرات بيئة الصدفة. يمكنك أيضًا تمكين وضع Nix عبر defaults:

مسارات التهيئة والحالة

يقرأ OpenClaw تهيئة JSON5 من OPENCLAW_CONFIG_PATH ويخزّن البيانات القابلة للتغيير في OPENCLAW_STATE_DIR. عند الحاجة، يمكنك أيضاً تعيين OPENCLAW_HOME للتحكم في دليل المنزل الأساسي المستخدم لحل المسارات الداخلية.
  • OPENCLAW_HOME (أولوية افتراضية: HOME / USERPROFILE / os.homedir())
  • OPENCLAW_STATE_DIR (الافتراضي: ~/.openclaw)
  • OPENCLAW_CONFIG_PATH (الافتراضي: $OPENCLAW_STATE_DIR/openclaw.json)
عند التشغيل تحت Nix، اضبط هذه القيم صراحةً إلى مواقع مُدارة بواسطة Nix بحيث تبقى حالة وقت التشغيل والتهيئة خارج المخزن غير القابل للتغيير.

سلوك وقت التشغيل في وضع Nix

  • تعطيل تدفقات التثبيت التلقائي والتحوير الذاتي
  • إظهار رسائل معالجة خاصة بـ Nix عند غياب الاعتمادات
  • تعرض الواجهة شريط وضع Nix للقراءة فقط عند توفره

ملاحظة التعبئة (macOS)

يتوقع مسار تعبئة macOS قالب Info.plist ثابتًا في:
يقوم scripts/package-mac-app.sh بنسخ هذا القالب إلى حزمة التطبيق وترقيع الحقول الديناميكية (معرّف الحزمة، الإصدار/البناء، Git SHA، مفاتيح Sparkle). يحافظ ذلك على حتمية ملف plist لتعبئة SwiftPM وبُنى Nix (التي لا تعتمد على سلسلة أدوات Xcode كاملة).

ذو صلة

  • nix-openclaw — دليل الإعداد الكامل
  • Wizard — إعداد CLI غير قائم على Nix
  • Docker — إعداد مُحَوْسَب بالحاويات