Przejdź do głównej treści

​
Instalacja Nix

Zainstaluj OpenClaw deklaratywnie za pomocą nix-openclaw — kompletnego modułu Home Manager.
Repozytorium nix-openclaw jest źródłem prawdy dla instalacji Nix. Ta strona to szybki przegląd.

​
Co otrzymujesz

  • Gateway + aplikację macOS + narzędzia (whisper, spotify, cameras) — wszystko przypięte
  • Usługę Launchd, która przetrwa restarty
  • System pluginów z konfiguracją deklaratywną
  • Natychmiastowy rollback: home-manager switch --rollback

​
Szybki start

1

Zainstaluj Determinate Nix

Jeśli Nix nie jest jeszcze zainstalowany, postępuj zgodnie z instrukcjami instalatora Determinate Nix.
2

Utwórz lokalny flake

Użyj szablonu agent-first z repozytorium nix-openclaw:
mkdir -p ~/code/openclaw-local
# Skopiuj templates/agent-first/flake.nix z repozytorium nix-openclaw
3

Skonfiguruj sekrety

Skonfiguruj token bota wiadomości i klucz API providera modelu. Zwykłe pliki w ~/.secrets/ działają dobrze.
4

Uzupełnij placeholdery w szablonie i wykonaj switch

home-manager switch
5

Zweryfikuj

Potwierdź, że usługa launchd działa i że Twój bot odpowiada na wiadomości.
Pełną listę opcji modułu i przykłady znajdziesz w README nix-openclaw.

​
Zachowanie runtime w trybie Nix

Gdy ustawione jest OPENCLAW_NIX_MODE=1 (automatycznie z nix-openclaw), OpenClaw przechodzi w tryb deterministyczny, który wyłącza przepływy automatycznej instalacji. Możesz też ustawić to ręcznie: 
export OPENCLAW_NIX_MODE=1
Na macOS aplikacja GUI nie dziedziczy automatycznie zmiennych środowiskowych powłoki. Zamiast tego włącz tryb Nix przez defaults: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Co zmienia się w trybie Nix

  • Przepływy auto-install i self-mutation są wyłączone
  • Brakujące zależności pokazują komunikaty naprawcze specyficzne dla Nix
  • UI pokazuje baner tylko do odczytu dla trybu Nix

​
Ścieżki config i stanu

OpenClaw odczytuje config JSON5 z OPENCLAW_CONFIG_PATH i przechowuje zmienne dane w OPENCLAW_STATE_DIR. Podczas działania pod Nix ustaw je jawnie na lokalizacje zarządzane przez Nix, aby stan runtime i config pozostawały poza niemutowalnym store.
ZmiennaDomyślnie
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Powiązane

  • nix-openclaw — pełny przewodnik konfiguracji
  • Wizard — konfiguracja CLI poza Nix
  • Docker — konfiguracja kontenerowa