Ana içeriğe atla

Nix kurulumu

OpenClaw’ı nix-openclaw ile bildirime dayalı olarak kurun — her şey dahil bir Home Manager modülü.
Nix kurulumu için doğruluk kaynağı nix-openclaw reposudur. Bu sayfa hızlı bir genel bakıştır.

Elde edecekleriniz

  • Gateway + macOS uygulaması + araçlar (whisper, spotify, kameralar) — hepsi sabitlenmiş
  • Yeniden başlatmalardan sonra da çalışan Launchd hizmeti
  • Bildirime dayalı yapılandırmaya sahip plugin sistemi
  • Anında geri alma: home-manager switch --rollback

Hızlı başlangıç

1

Determinate Nix kurun

Nix henüz kurulu değilse Determinate Nix installer yönergelerini izleyin.
2

Yerel bir flake oluşturun

nix-openclaw reposundaki agent-first şablonunu kullanın:
mkdir -p ~/code/openclaw-local
# templates/agent-first/flake.nix dosyasını nix-openclaw reposundan kopyalayın
3

Gizli bilgileri yapılandırın

Mesajlaşma bot token’ınızı ve model provider API key’inizi ayarlayın. ~/.secrets/ altındaki düz dosyalar gayet uygundur.
4

Şablon yer tutucularını doldurun ve switch çalıştırın

home-manager switch
5

Doğrulayın

Launchd hizmetinin çalıştığını ve botunuzun mesajlara yanıt verdiğini doğrulayın.
Tam modül seçenekleri ve örnekler için nix-openclaw README dosyasına bakın.

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

OPENCLAW_NIX_MODE=1 ayarlandığında (nix-openclaw ile otomatik olarak), OpenClaw otomatik kurulum akışlarını devre dışı bırakan deterministik bir moda girer. Bunu el ile de ayarlayabilirsiniz:
export OPENCLAW_NIX_MODE=1
macOS üzerinde GUI uygulaması kabuk ortam değişkenlerini otomatik olarak devralmaz. Bunun yerine defaults aracılığıyla Nix mode’u etkinleştirin:
defaults write ai.openclaw.mac openclaw.nixMode -bool true

Nix mode’da neler değişir

  • Otomatik kurulum ve kendini değiştirme akışları devre dışı bırakılır
  • Eksik bağımlılıklar Nix’e özgü düzeltme mesajları gösterir
  • UI, salt okunur bir Nix mode başlığı gösterir

Yapılandırma ve durum yolları

OpenClaw, JSON5 yapılandırmasını OPENCLAW_CONFIG_PATH içinden okur ve değiştirilebilir verileri OPENCLAW_STATE_DIR içinde depolar. Nix altında çalışırken, çalışma zamanı durumu ve yapılandırma değiştirilemez store dışında kalsın diye bunları Nix tarafından yönetilen konumlara açıkça ayarlayın.
DeğişkenVarsayılan
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

İlgili