الانتقال إلى المحتوى الرئيسي

​
تثبيت Nix

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

​
البدء السريع

الصق هذا في وكيل الذكاء الاصطناعي لديك (Claude، Cursor، إلخ): 
I want to set up nix-openclaw on my Mac.
Repository: github:openclaw/nix-openclaw

What I need you to do:
1. Check if Determinate Nix is installed (if not, install it)
2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine
5. Fill in the template placeholders and run home-manager switch
6. Verify: launchd running, bot responds to messages

Reference the nix-openclaw README for module options.
📦 الدليل الكامل: 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 الذي يجعل التهيئة حتمية ويعطّل تدفقات التثبيت التلقائي. يمكنك تمكينه عبر التصدير: 
OPENCLAW_NIX_MODE=1
على macOS، لا يرث تطبيق الواجهة الرسومية تلقائيًا متغيرات بيئة الصدفة. يمكنك أيضًا تمكين وضع Nix عبر defaults: 
defaults write bot.molt.mac openclaw.nixMode -bool true

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

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

​
ذو صلة

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