Перейти до основного вмісту

​
Встановлення через Nix

Установіть OpenClaw декларативно за допомогою nix-openclaw — Home Manager module з усім необхідним у комплекті.
Репозиторій nix-openclaw є джерелом істини для встановлення через Nix. Ця сторінка — короткий огляд.

​
Що ви отримаєте

  • Gateway + застосунок macOS + інструменти (whisper, spotify, cameras) — усе зафіксовано
  • Сервіс launchd, який переживає перезавантаження
  • Система plugins з декларативною конфігурацією
  • Миттєвий rollback: home-manager switch --rollback

​
Швидкий старт

1

Установіть Determinate Nix

Якщо Nix ще не встановлено, дотримуйтеся інструкцій інсталятора Determinate Nix.
2

Створіть локальний flake

Використовуйте шаблон agent-first з репозиторію nix-openclaw:
mkdir -p ~/code/openclaw-local
# Скопіюйте templates/agent-first/flake.nix з репозиторію nix-openclaw
3

Налаштуйте секрети

Налаштуйте токен вашого бота повідомлень і API-ключ провайдера моделей. Звичайні файли в ~/.secrets/ цілком підходять.
4

Заповніть шаблонні placeholder і застосуйте конфігурацію

home-manager switch
5

Перевірте

Переконайтеся, що сервіс launchd працює і ваш бот відповідає на повідомлення.
Повні параметри module і приклади див. в README nix-openclaw.

​
Поведінка runtime в режимі Nix

Коли задано OPENCLAW_NIX_MODE=1 (автоматично з nix-openclaw), OpenClaw переходить у детермінований режим, який вимикає сценарії auto-install. Ви також можете задати це вручну: 
export OPENCLAW_NIX_MODE=1
У macOS GUI-застосунок не успадковує змінні середовища shell автоматично. Натомість увімкніть режим Nix через defaults: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Що змінюється в режимі Nix

  • Сценарії auto-install і self-mutation вимкнені
  • Відсутні залежності показують повідомлення про виправлення, специфічні для Nix
  • UI показує банер режиму Nix лише для читання

​
Шляхи до конфігурації та state

OpenClaw читає конфігурацію JSON5 з OPENCLAW_CONFIG_PATH і зберігає змінні дані в OPENCLAW_STATE_DIR. Під час роботи під Nix задавайте їх явно на розташування, якими керує Nix, щоб runtime state і конфігурація не потрапляли до незмінного store.
ЗміннаТипове значення
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Пов’язане

  • nix-openclaw — повний посібник із налаштування
  • Wizard — налаштування CLI без Nix
  • Docker — налаштування в контейнері