OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Containers

Nix

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

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ıç

  • Determinate Nix'i yükleyin

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

  • Yerel bir flake oluşturun

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

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

  • 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.

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

    bash
    home-manager switch

  • 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:

    bash
    export OPENCLAW_NIX_MODE=1

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

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

    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.

    Değişken Varsayılan
    OPENCLAW_HOME HOME / USERPROFILE / os.homedir()
    OPENCLAW_STATE_DIR ~/.openclaw
    OPENCLAW_CONFIG_PATH $OPENCLAW_STATE_DIR/openclaw.json

    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.
    Was this useful?
    On this page

    On this page