Nix

OpenClaw'u, birinci taraf, kullanıma hazır Home Manager modülü nix-openclaw ile bildirimsel olarak kurun.

Neler elde edersiniz

• Tamamı sabitlenmiş Gateway + macOS uygulaması + araçlar (whisper, spotify, kameralar)
• Yeniden başlatmalardan sonra çalışmaya devam eden launchd hizmeti
• Bildirimsel yapılandırmaya sahip Plugin sistemi
• Anında geri alma: home-manager switch --rollback

Hızlı başlangıç

mkdir -p ~/code/openclaw-local# nix-openclaw deposundan templates/agent-first/flake.nix dosyasını kopyalayın

home-manager switch

Tüm modül seçenekleri ve örnekler için nix-openclaw README dosyasına bakın.

Nix modu çalışma zamanı davranışı

OPENCLAW_NIX_MODE=1 ayarlandığında (nix-openclaw ile otomatik olarak), OpenClaw Nix tarafından yönetilen kurulumlar için deterministik bir moda girer. Diğer Nix paketleri de aynı modu ayarlayabilir; nix-openclaw birinci taraf referansıdır.

Bunu elle de ayarlayabilirsiniz:

export OPENCLAW_NIX_MODE=1

macOS'ta GUI uygulaması kabuk ortam değişkenlerini devralmaz. Bunun yerine Nix modunu defaults aracılığıyla etkinleştirin:

defaults write ai.openclaw.mac openclaw.nixMode -bool true

Nix modunda neler değişir?

• Otomatik kurulum ve kendini değiştirme akışları devre dışı bırakılır.
• openclaw.json değiştirilemez kabul edilir. Başlangıçta türetilen varsayılanlar yalnızca çalışma zamanında kalır ve yapılandırma yazıcıları (kurulum, ilk kullanım yapılandırması, değişiklik yapan openclaw update, Plugin kurma/güncelleme/kaldırma/etkinleştirme, doctor --fix, doctor --generate-gateway-token, openclaw config set) dosyayı düzenlemeyi reddeder.
• Bunun yerine Nix kaynağını düzenleyin. nix-openclaw için öncelikle ajan odaklı Hızlı Başlangıç kılavuzunu kullanın ve yapılandırmayı programs.openclaw.config veya instances.<name>.config altında ayarlayın.
• Eksik bağımlılıklar için Nix'e özgü düzeltme mesajları gösterilir.
• Kullanıcı arayüzü salt okunur bir Nix modu başlığı gösterir.

Yapılandırma ve durum yolları

OpenClaw, JSON5 yapılandırmasını OPENCLAW_CONFIG_PATH konumundan okur ve değiştirilebilir verileri OPENCLAW_STATE_DIR içinde depolar. Nix altında bunları açıkça Nix tarafından yönetilen konumlara ayarlayın; böylece çalışma zamanı durumu ve yapılandırma, değiştirilemez deponun dışında kalır.

Hizmet PATH keşfi

launchd/systemd Gateway hizmeti, Nix profili ikili dosyalarını otomatik olarak keşfeder; böylece nix ile kurulmuş yürütülebilir dosyaları kabuk üzerinden çalıştıran Plugin'ler ve araçlar, elle PATH ayarı yapılmadan çalışır:

• NIX_PROFILES ayarlandığında, her girdi sağdan sola öncelik sırasıyla hizmet PATH'ine eklenir (Nix kabuğu önceliğiyle eşleşir: en sağdaki kazanır).
• NIX_PROFILES ayarlanmadığında, geri dönüş olarak ~/.nix-profile/bin eklenir.

Bu, hem macOS launchd hem de Linux systemd hizmet ortamları için geçerlidir.

İlgili