Przejdź do głównej treści

​
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