Instalacja Nix

Zalecanym sposobem uruchamiania OpenClaw z Nix jest nix-openclaw — moduł Home Manager „z pełnym zestawem”.

Szybki start

Wklej to do swojego agenta AI (Claude, Cursor itp.):

I want to set up nix-openclaw on my Mac.
Repository: github:openclaw/nix-openclaw

What I need you to do:
1. Check if Determinate Nix is installed (if not, install it)
2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine
5. Fill in the template placeholders and run home-manager switch
6. Verify: launchd running, bot responds to messages

Reference the nix-openclaw README for module options.

📦 Pełny przewodnik: github.com/openclaw/nix-openclaw Repozytorium nix-openclaw jest źródłem prawdy dla instalacji Nix. Ta strona to jedynie szybki przegląd.

Co otrzymujesz

Gateway + aplikację na macOS + narzędzia (whisper, spotify, kamery) — wszystko przypięte
Usługę launchd, która przetrwa restarty
System wtyczek z konfiguracją deklaratywną
Natychmiastowe cofanie zmian: home-manager switch --rollback

Zachowanie środowiska uruchomieniowego w trybie Nix

Gdy ustawione jest OPENCLAW_NIX_MODE=1 (automatycznie z nix-openclaw): OpenClaw obsługuje tryb Nix, który czyni konfigurację deterministyczną i wyłącza przepływy auto‑instalacji. Włącz go, eksportując:

OPENCLAW_NIX_MODE=1

W macOS aplikacja GUI nie dziedziczy automatycznie zmiennych środowiskowych powłoki. Możesz również włączyć tryb Nix za pomocą defaults:

defaults write bot.molt.mac openclaw.nixMode -bool true

Ścieżki konfiguracji i stanu

OpenClaw czyta konfigurację JSON5 z OPENCLAW_CONFIG_PATH i przechowuje dane mutowalne w OPENCLAW_STATE_DIR. When needed, you can also set OPENCLAW_HOME to control the base home directory used for internal path resolution.

OPENCLAW_HOME (domyślna kolejność pierwszeństwa: HOME / USERPROFILE / os.homedir())
OPENCLAW_STATE_DIR (domyślnie: ~/.openclaw)
OPENCLAW_CONFIG_PATH (domyślnie: $OPENCLAW_STATE_DIR/openclaw.json)

Podczas uruchamiania w Nix ustaw je jawnie na lokalizacje zarządzane przez Nix, aby stan środowiska uruchomieniowego i konfiguracja pozostały poza niemutowalnym store.

Zachowanie środowiska uruchomieniowego w trybie Nix

Przepływy auto‑instalacji i samomutacji są wyłączone
Brakujące zależności zgłaszają komunikaty naprawcze specyficzne dla Nix
Interfejs wyświetla baner trybu Nix tylko do odczytu, gdy jest obecny

Uwaga dotycząca pakowania (macOS)

Proces pakowania macOS oczekuje stabilnego szablonu Info.plist w:

apps/macos/Sources/OpenClaw/Resources/Info.plist

scripts/package-mac-app.sh kopiuje ten szablon do pakietu aplikacji i łata pola dynamiczne (identyfikator pakietu, wersja/build, Git SHA, klucze Sparkle). Dzięki temu plist pozostaje deterministyczny dla pakowania SwiftPM oraz buildów Nix (które nie polegają na pełnym łańcuchu narzędzi Xcode).

Powiązane

nix-openclaw — pełny przewodnik konfiguracji
Wizard — konfiguracja CLI bez Nix
Docker — konfiguracja konteneryzowana

Przegląd instalacji

Inne metody instalacji

Utrzymanie

Hosting i wdrożenie

Zaawansowane

Nix

Instalacja Nix

Szybki start

Co otrzymujesz

Zachowanie środowiska uruchomieniowego w trybie Nix

Ścieżki konfiguracji i stanu

Zachowanie środowiska uruchomieniowego w trybie Nix

Uwaga dotycząca pakowania (macOS)

Powiązane

​Instalacja Nix

​Szybki start

​Co otrzymujesz

​Zachowanie środowiska uruchomieniowego w trybie Nix

​Ścieżki konfiguracji i stanu

​Zachowanie środowiska uruchomieniowego w trybie Nix

​Uwaga dotycząca pakowania (macOS)

​Powiązane

Instalacja Nix

Szybki start

Co otrzymujesz

Zachowanie środowiska uruchomieniowego w trybie Nix

Ścieżki konfiguracji i stanu

Zachowanie środowiska uruchomieniowego w trybie Nix

Uwaga dotycząca pakowania (macOS)

Powiązane