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

​
تثبيت Nix

ثبّت OpenClaw بشكل تصريحي باستخدام nix-openclaw — وهي وحدة Home Manager متكاملة.
يُعد مستودع nix-openclaw المصدر المرجعي لتثبيت Nix. وهذه الصفحة نظرة عامة سريعة.

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

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

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

1

تثبيت Determinate Nix

إذا لم يكن Nix مثبتًا بالفعل، فاتبع تعليمات مثبّت Determinate Nix.
2

إنشاء flake محلي

استخدم القالب agent-first من مستودع nix-openclaw:
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

إعداد الأسرار

اضبط الرمز المميز لبوت المراسلة لديك وAPI key الخاصة بموفّر النموذج. تعمل الملفات النصية العادية ضمن ~/.secrets/ بشكل جيد.
4

املأ العناصر النائبة في القالب ثم نفّذ switch

home-manager switch
5

التحقق

أكّد أن خدمة launchd تعمل وأن البوت الخاص بك يستجيب للرسائل.
راجع README الخاص بـ nix-openclaw للحصول على خيارات الوحدة الكاملة والأمثلة.

​
سلوك وقت التشغيل في Nix Mode

عند تعيين OPENCLAW_NIX_MODE=1 (تلقائيًا مع nix-openclaw)، يدخل OpenClaw في وضع حتمي يعطّل تدفقات التثبيت التلقائي. يمكنك أيضًا تعيينه يدويًا: 
export OPENCLAW_NIX_MODE=1
على macOS، لا يرث تطبيق GUI متغيرات بيئة shell تلقائيًا. فعّل Nix mode عبر defaults بدلًا من ذلك: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
ما الذي يتغير في Nix mode

  • يتم تعطيل تدفقات التثبيت التلقائي والتعديل الذاتي
  • تعرض التبعيات المفقودة رسائل معالجة خاصة بـ Nix
  • تعرض واجهة المستخدم لافتة Nix mode للقراءة فقط

​
مسارات الإعدادات والحالة

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

​
ذو صلة

  • nix-openclaw — دليل الإعداد الكامل
  • Wizard — إعداد CLI بدون Nix
  • Docker — إعداد قائم على الحاويات