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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Встановіть OpenClaw декларативно за допомогою nix-openclaw - офіційного, повністю укомплектованого модуля Home Manager.
Репозиторій nix-openclaw є джерелом істини для встановлення Nix. Ця сторінка - короткий огляд.

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

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

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

1

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

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

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

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

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

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

Заповніть заповнювачі шаблону й перемкніться

home-manager switch
5

Перевірте

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

​
Поведінка середовища виконання в режимі Nix

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

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

  • Потоки автоматичного встановлення та самомодифікації вимкнено
  • openclaw.json вважається незмінним. Типові значення, отримані під час запуску, залишаються лише в середовищі виконання, а засоби запису конфігурації, як-от setup, onboarding, мутаційний openclaw update, встановлення/оновлення/видалення/увімкнення Plugin, doctor --fix, doctor --generate-gateway-token і openclaw config set, відмовляються редагувати файл.
  • Натомість агенти мають редагувати джерело Nix. Для nix-openclaw скористайтеся agent-first Швидким стартом і задайте конфігурацію в programs.openclaw.config або instances.<name>.config.
  • Відсутні залежності показують повідомлення з інструкціями для Nix
  • UI показує банер режиму Nix лише для читання

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

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

​
Виявлення PATH сервісу

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

​
Пов’язане

nix-openclaw

Джерело істини для модуля Home Manager і повний посібник із налаштування.

Майстер налаштування

Покрокове налаштування CLI без Nix.

Docker

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

Оновлення

Оновлення встановлень, керованих Home Manager, разом із пакетом.