// dokumentacja openclaw

Instalacja OpenClaw z Nix — deklaratywna konfiguracja

OpenClaw z Nix

Nix umożliwia w pełni deklaratywną instalację OpenClaw za pomocą modułu Home Manager — nix-openclaw. To podejście gwarantuje powtarzalność, łatwy rollback i precyzyjną kontrolę nad zależnościami.

Co otrzymujesz

  • Gateway + aplikacja macOS + narzędzia (whisper, spotify, kamery) — wszystko z przypiętymi wersjami.
  • Usługa launchd — automatyczne uruchamianie po restarcie systemu.
  • System wtyczek — deklaratywna konfiguracja rozszerzeń.
  • Szybki rollback — powrót do poprzedniej konfiguracji jednym poleceniem: home-manager switch --rollback.

Instalacja krok po kroku

1. Zainstaluj Determinate Nix

Jeśli nie masz jeszcze Nixa, zainstaluj go za pomocą oficjalnego instalatora Determinate Systems:

curl --proto '=https' --tlsv1.2 -sSf -L \
  https://install.determinate.systems/nix | sh -s -- install

2. Utwórz lokalny flake

mkdir -p ~/code/openclaw-local
cd ~/code/openclaw-local

# Skopiuj szablony z nix-openclaw
nix flake init -t github:openclaw/nix-openclaw

3. Skonfiguruj sekrety

Utwórz plik z sekretami zawierający tokeny botów komunikacyjnych i klucze API providerów. Sekrety nie powinny trafiać do repozytorium — użyj narzędzi takich jak sops-nix lub zmiennych środowiskowych.

4. Uzupełnij placeholdery i zastosuj konfigurację

# Edytuj flake.nix i uzupelnij ustawienia
$EDITOR flake.nix

# Zastosuj konfiguracje
home-manager switch --flake .

5. Zweryfikuj działanie

# Sprawdz usluge launchd
launchctl list | grep openclaw

# Zweryfikuj status Gateway
openclaw gateway status

Tryb Nix

Gdy zmienna OPENCLAW_NIX_MODE=1 jest aktywna, OpenClaw przechodzi w tryb deterministyczny:

  • Automatyczne przepływy instalacji są wyłączone.
  • Brakujące zależności wyświetlają komunikaty specyficzne dla Nixa.
  • W interfejsie użytkownika pojawia się baner informujący o trybie tylko do odczytu.

Na aplikacji macOS GUI włącz tryb poleceniem:

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

Ścieżki konfiguracji

  • OPENCLAW_HOME — domyślnie katalog domowy użytkownika.
  • OPENCLAW_STATE_DIR — domyślnie ~/.openclaw.
  • OPENCLAW_CONFIG_PATH — domyślnie $OPENCLAW_STATE_DIR/openclaw.json.

Aktualizacja

Aby zaktualizować OpenClaw w konfiguracji Nix:

# Zaktualizuj wejscia flake
nix flake update

# Zastosuj nowa konfiguracje
home-manager switch --flake .

W razie problemów wróć do poprzedniej wersji: home-manager switch --rollback.

Wróc do dokumentacji