Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw’u nix-openclaw ile bildirimsel olarak kurun - birinci taraf, kapsamlı Home Manager modülü.
nix-openclaw reposu, Nix kurulumu için doğruluk kaynağıdır. Bu sayfa hızlı bir genel bakıştır.

​
Ne elde edersiniz

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

​
Hızlı başlangıç

1

Determinate Nix'i kurun

Nix zaten kurulu değilse Determinate Nix installer talimatlarını izleyin.
2

Yerel bir flake oluşturun

nix-openclaw reposundaki agent-first şablonunu kullanın:
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Gizli bilgileri yapılandırın

Mesajlaşma botu token’ınızı ve model sağlayıcısı API anahtarınızı ayarlayın. ~/.secrets/ altındaki düz dosyalar yeterlidir.
4

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

home-manager switch
5

Doğrulayın

launchd servisinin ç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 modu çalışma zamanı davranışı

OPENCLAW_NIX_MODE=1 ayarlandığında (nix-openclaw ile otomatik), 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 referanstır. Bunu manuel olarak da ayarlayabilirsiniz: 
export OPENCLAW_NIX_MODE=1
macOS’te GUI uygulaması kabuk ortam değişkenlerini otomatik olarak devralmaz. Bunun yerine Nix modunu defaults üzerinden etkinleştirin: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Nix modunda neler değişir

  • Otomatik kurulum ve kendi kendini değiştirme akışları devre dışı bırakılır
  • openclaw.json değişmez kabul edilir. Başlangıçtan türetilen varsayılanlar yalnızca çalışma zamanında kalır; setup, onboarding, değişiklik yapan openclaw update, Plugin install/update/uninstall/enable, doctor --fix, doctor --generate-gateway-token ve openclaw config set gibi yapılandırma yazıcıları dosyayı düzenlemeyi reddeder.
  • Aracılar bunun yerine Nix kaynağını düzenlemelidir. nix-openclaw için agent-first Hızlı Başlangıç bölümünü kullanın ve yapılandırmayı programs.openclaw.config veya instances.<name>.config altında ayarlayın.
  • Eksik bağımlılıklar Nix’e özgü düzeltme mesajları gösterir
  • UI, salt okunur Nix modu banner’ı gösterir

​
Yapılandırma ve durum yolları

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

​
Servis PATH keşfi

launchd/systemd gateway servisi, nix ile kurulan çalıştırılabilirleri kabuk üzerinden çağıran Plugin’lerin ve araçların manuel PATH kurulumu olmadan çalışması için Nix-profile ikili dosyalarını otomatik keşfeder:
  • NIX_PROFILES ayarlandığında, her giriş sağdan sola öncelikle servis PATH’ine eklenir (Nix kabuk önceliğiyle eşleşir - en sağdaki kazanır).
  • NIX_PROFILES ayarlı olmadığında, ~/.nix-profile/bin yedek olarak eklenir.
Bu, hem macOS launchd hem de Linux systemd servis ortamları için geçerlidir.

​
İlgili

nix-openclaw

Doğruluk kaynağı Home Manager modülü ve tam kurulum kılavuzu.

Kurulum sihirbazı

Nix dışı CLI kurulum adımları.

Docker

Nix dışı alternatif olarak konteynerleştirilmiş kurulum.

Güncelleme

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