Ana içeriğe atla

Nix Kurulumu

OpenClaw’ı Nix ile çalıştırmanın önerilen yolu, piller dâhil bir Home Manager modülü olan nix-openclaw üzerinden kurulmasıdır.

Hızlı Başlangıç

Bunu AI ajanınıza (Claude, Cursor, vb.) yapıştırın:
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.
📦 Tam kılavuz: github.com/openclaw/nix-openclaw nix-openclaw deposu, Nix kurulumu için asıl başvuru kaynağıdır. Bu sayfa yalnızca hızlı bir genel bakıştır.

Neler elde edersiniz

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

Nix Modu Çalışma Zamanı Davranışı

OPENCLAW_NIX_MODE=1 ayarlandığında (nix-openclaw ile otomatik): OpenClaw, yapılandırmayı deterministik hâle getiren ve otomatik kurulum akışlarını devre dışı bırakan bir Nix modu destekler. Aşağıdakini dışa aktararak etkinleştirin:
OPENCLAW_NIX_MODE=1
macOS’te GUI uygulaması kabuk ortam değişkenlerini otomatik olarak devralmaz. Nix modunu defaults üzerinden de etkinleştirebilirsiniz:
defaults write bot.molt.mac openclaw.nixMode -bool true

Yapılandırma + durum yolları

OpenClaw, JSON5 yapılandırmasını OPENCLAW_CONFIG_PATH konumundan okur ve değiştirilebilir verileri OPENCLAW_STATE_DIR konumunda saklar. When needed, you can also set OPENCLAW_HOME to control the base home directory used for internal path resolution.
  • OPENCLAW_HOME (varsayılan öncelik sırası: HOME / USERPROFILE / os.homedir())
  • OPENCLAW_STATE_DIR (varsayılan: ~/.openclaw)
  • OPENCLAW_CONFIG_PATH (varsayılan: $OPENCLAW_STATE_DIR/openclaw.json)
Nix altında çalışırken, çalışma zamanı durumu ve yapılandırmanın değişmez store dışında kalması için bunları Nix tarafından yönetilen konumlara açıkça ayarlayın.

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

  • Otomatik kurulum ve kendini değiştirme akışları devre dışıdır
  • Eksik bağımlılıklar, Nix’e özgü çözüm mesajlarıyla görünür
  • UI, mevcut olduğunda salt okunur bir Nix modu bandı gösterir

Paketleme notu (macOS)

macOS paketleme akışı, aşağıdaki konumda kararlı bir Info.plist şablonu bekler:
apps/macos/Sources/OpenClaw/Resources/Info.plist
scripts/package-mac-app.sh bu şablonu uygulama paketine kopyalar ve dinamik alanları (paket kimliği, sürüm/yapı, Git SHA, Sparkle anahtarları) yamalar. Bu yaklaşım, SwiftPM paketleme ve Nix derlemeleri için (tam bir Xcode araç zincirine dayanmadıkları için) plist’in deterministik kalmasını sağlar.

İlgili