Skip to main content
Установите OpenClaw декларативно с помощью nix-openclaw — официального полнофункционального модуля Home Manager.
Репозиторий nix-openclaw — основной источник сведений об установке через Nix. На этой странице приведён краткий обзор.

​
Что вы получите

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

​
Быстрый старт

1

Установите Determinate Nix

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

Создайте локальный flake

Используйте шаблон с приоритетом агента из репозитория nix-openclaw:
3

Настройте секреты

Укажите токен бота для обмена сообщениями и API-ключ поставщика моделей. Обычные файлы в ~/.secrets/ вполне подходят.
4

Заполните заполнители шаблона и примените конфигурацию

5

Проверьте

Убедитесь, что служба launchd работает, а бот отвечает на сообщения.
Полный список параметров модуля и примеры см. в README nix-openclaw.

​
Поведение среды выполнения в режиме Nix

Когда задано OPENCLAW_NIX_MODE=1 (при использовании nix-openclaw это происходит автоматически), OpenClaw переходит в детерминированный режим для установок под управлением Nix. Другие пакеты Nix также могут включать этот режим; nix-openclaw является официальной эталонной реализацией. Его также можно включить вручную:
В macOS приложение с графическим интерфейсом не наследует переменные окружения оболочки. Вместо этого включите режим Nix с помощью defaults:

​
Что меняется в режиме Nix

  • Механизмы автоматической установки и самоизменения отключены.
  • openclaw.json считается неизменяемым. Значения по умолчанию, определяемые при запуске, применяются только во время выполнения, а средства записи конфигурации (первоначальная настройка, ввод в эксплуатацию, изменяющие операции openclaw update, установка, обновление, удаление и включение плагинов, doctor --fix, doctor --generate-gateway-token, openclaw config set) отказываются изменять файл.
  • Вместо этого измените исходный код Nix. Для nix-openclaw используйте ориентированный на агента раздел «Быстрый старт» и задайте конфигурацию в programs.openclaw.config или instances.<name>.config.
  • При отсутствии зависимостей отображаются специальные сообщения Nix с инструкциями по устранению проблемы.
  • В интерфейсе отображается баннер режима Nix «только для чтения».

​
Пути конфигурации и состояния

OpenClaw считывает конфигурацию JSON5 из OPENCLAW_CONFIG_PATH и хранит изменяемые данные в OPENCLAW_STATE_DIR. При использовании Nix явно задайте для них расположения под управлением Nix, чтобы состояние среды выполнения и конфигурация не попадали в неизменяемое хранилище.

​
Обнаружение PATH для службы

Служба Gateway для launchd/systemd автоматически обнаруживает исполняемые файлы профиля Nix, поэтому плагины и инструменты, запускающие исполняемые файлы, установленные через nix, работают без ручной настройки PATH:
  • Когда задано NIX_PROFILES, каждая запись добавляется в PATH службы с приоритетом справа налево (как в оболочке Nix: побеждает крайняя справа).
  • Если NIX_PROFILES не задано, в качестве резервного варианта добавляется ~/.nix-profile/bin.
Это относится как к окружению службы launchd в macOS, так и к окружению службы systemd в Linux.

​
Связанные материалы

nix-openclaw

Основной модуль Home Manager и полное руководство по настройке.

Мастер настройки

Пошаговая настройка через CLI без использования Nix.

Docker

Контейнерная установка как альтернатива Nix.

Обновление

Обновление установок под управлением Home Manager вместе с пакетом.