Przejdź do głównej treści

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.

Zainstaluj OpenClaw deklaratywnie za pomocą nix-openclaw - oficjalnego modułu Home Manager z pełnym zestawem funkcji.
Repozytorium nix-openclaw jest źródłem prawdy dla instalacji Nix. Ta strona to krótki przegląd.

​
Co otrzymujesz

  • Gateway + aplikacja macOS + narzędzia (whisper, spotify, cameras) — wszystko przypięte
  • Usługa launchd działająca po ponownym uruchomieniu
  • System Plugin z deklaratywną konfiguracją
  • Natychmiastowe wycofanie: 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
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Skonfiguruj sekrety

Skonfiguruj token bota komunikatora i klucz API dostawcy modelu. Zwykłe pliki w ~/.secrets/ działają dobrze.
4

Wypełnij symbole zastępcze w szablonie i przełącz

home-manager switch
5

Zweryfikuj

Potwierdź, że usługa launchd działa, a bot odpowiada na wiadomości.
Pełne opcje 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 deterministyczny tryb dla instalacji zarządzanych przez Nix. Inne pakiety Nix mogą ustawić ten sam tryb; nix-openclaw jest oficjalnym punktem odniesienia. Możesz też ustawić go ręcznie: 
export OPENCLAW_NIX_MODE=1
W 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 automatycznej instalacji i samomodyfikacji są wyłączone
  • openclaw.json jest traktowany jako niezmienny. Wartości domyślne wyprowadzone podczas uruchamiania pozostają tylko w runtime, a zapisujące konfigurację mechanizmy, takie jak setup, onboarding, modyfikujące openclaw update, instalacja/aktualizacja/odinstalowanie/włączenie pluginu, doctor --fix, doctor --generate-gateway-token i openclaw config set, odmawiają edycji pliku.
  • Agenci powinni zamiast tego edytować źródło Nix. Dla nix-openclaw użyj agent-first Szybkiego startu i ustaw konfigurację w programs.openclaw.config lub instances.<name>.config.
  • Brakujące zależności wyświetlają komunikaty naprawcze specyficzne dla Nix
  • UI wyświetla baner trybu Nix tylko do odczytu

​
Ścieżki konfiguracji i stanu

OpenClaw odczytuje konfigurację JSON5 z OPENCLAW_CONFIG_PATH i przechowuje dane mutowalne w OPENCLAW_STATE_DIR. Podczas działania w Nix ustaw je jawnie na lokalizacje zarządzane przez Nix, aby stan runtime i konfiguracja pozostały poza niezmiennym magazynem.
ZmiennaDomyślnie
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Wykrywanie PATH usługi

Usługa gateway launchd/systemd automatycznie wykrywa pliki binarne z profilu Nix, dzięki czemu pluginy i narzędzia wywołujące pliki wykonywalne zainstalowane przez nix działają bez ręcznej konfiguracji PATH:
  • Gdy ustawione jest NIX_PROFILES, każdy wpis jest dodawany do PATH usługi z priorytetem od prawej do lewej (zgodnie z priorytetem powłoki Nix - wygrywa skrajnie prawy).
  • Gdy NIX_PROFILES nie jest ustawione, ~/.nix-profile/bin jest dodawane jako rezerwa.
Dotyczy to zarówno środowisk usług macOS launchd, jak i Linux systemd.

​
Powiązane

nix-openclaw

Moduł Home Manager będący źródłem prawdy oraz pełny przewodnik konfiguracji.

Kreator konfiguracji

Przewodnik konfiguracji CLI bez Nix.

Docker

Konfiguracja kontenerowa jako alternatywa bez Nix.

Aktualizacja

Aktualizowanie instalacji zarządzanych przez Home Manager wraz z pakietem.