Skip to main content
OpenClaw’u, birinci taraf, kullanıma hazır Home Manager modülü nix-openclaw ile bildirimsel olarak kurun.
nix-openclaw deposu, Nix kurulumu için temel referans kaynağıdır. Bu sayfa kısa bir genel bakış sunar.

​
Neler sunulur?

  • Gateway + macOS uygulaması + araçlar (whisper, spotify, kameralar), tümü sabitlenmiş sürümlerde
  • Yeniden başlatmalardan etkilenmeyen Launchd hizmeti
  • Bildirimsel yapılandırmaya sahip Plugin sistemi
  • Anında geri alma: home-manager switch --rollback

​
Hızlı başlangıç

1

Determinate Nix'i yükleyin

Nix henüz yüklü değilse Determinate Nix yükleyicisi talimatlarını izleyin.
2

Yerel bir flake oluşturun

nix-openclaw deposundaki öncelikle aracı kullanan şablonu kullanın:
3

Gizli bilgileri yapılandırın

Mesajlaşma botu belirtecinizi ve model sağlayıcısının API anahtarını ayarlayın. ~/.secrets/ konumundaki düz dosyalar sorunsuz çalışır.
4

Şablon yer tutucularını doldurun ve geçiş yapın

5

Doğrulayın

launchd hizmetinin çalıştığını ve botunuzun mesajlara yanıt verdiğini doğrulayın.
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 belirlenimci bir moda girer. Diğer Nix paketleri de aynı modu ayarlayabilir; nix-openclaw birinci taraf referansıdır. Bunu elle de ayarlayabilirsiniz:
macOS’te GUI uygulaması, kabuk ortam değişkenlerini devralmaz. Bunun yerine defaults aracılığıyla Nix modunu etkinleştirin:

​
Nix modunda neler değişir?

  • Otomatik yükleme ve kendi kendini değiştirme akışları devre dışı bırakılır.
  • openclaw.json değişmez 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, değişiklik yapan openclaw update, Plugin yükleme/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 aracı kullanan 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ünde salt okunur bir Nix modu başlığı gösterilir.

​
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 konumunda saklar. Çalışma zamanı durumu ve yapılandırmanın değişmez deponun dışında kalması için Nix altında bunları açıkça Nix tarafından yönetilen konumlara ayarlayın.

​
Hizmet PATH keşfi

launchd/systemd Gateway hizmeti, nix tarafından yüklenen yürütülebilir dosyaları çalıştıran Plugin’lerin ve araçların elle PATH ayarı olmadan çalışması için Nix profili ikili dosyalarını otomatik olarak keşfeder:
  • NIX_PROFILES ayarlandığında, her giriş sağdan sola öncelik sırasıyla hizmet PATH’ine eklenir (Nix kabuk önceliğiyle eşleşir: en sağdaki kazanır).
  • NIX_PROFILES ayarlanmadığında, ~/.nix-profile/bin yedek olarak eklenir.
Bu, hem macOS launchd hem de Linux systemd hizmet ortamları için geçerlidir.

​
İlgili içerikler

nix-openclaw

Temel referans kaynağı olan Home Manager modülü ve eksiksiz kurulum kılavuzu.

Kurulum sihirbazı

Nix kullanmayan CLI kurulumu için adım adım açıklama.

Docker

Nix kullanmayan bir alternatif olarak kapsayıcılı kurulum.

Güncelleme

Home Manager tarafından yönetilen kurulumları paketle birlikte güncelleme.