Nix

nix-openclaw を使用して、OpenClaw を宣言的にインストールします。これは、必要な機能をすべて備えた公式の Home Manager モジュールです。

導入されるもの

• Gateway + macOS アプリ + ツール（whisper、spotify、カメラ）。すべてバージョン固定
• 再起動後も稼働する launchd サービス
• 宣言的な設定に対応した Plugin システム
• 即時ロールバック: home-manager switch --rollback

クイックスタート

mkdir -p ~/code/openclaw-local# nix-openclaw リポジトリから templates/agent-first/flake.nix をコピー

home-manager switch

モジュールの全オプションと例については、nix-openclaw README を参照してください。

Nix モードのランタイム動作

OPENCLAW_NIX_MODE=1 が設定されている場合（nix-openclaw では自動設定）、OpenClaw は Nix 管理のインストール向けの決定論的モードに移行します。他の Nix パッケージでも同じモードを設定できます。nix-openclaw が公式リファレンスです。

手動で設定することもできます。

export OPENCLAW_NIX_MODE=1

macOS では、GUI アプリはシェルの環境変数を継承しません。代わりに defaults で Nix モードを有効にします。

defaults write ai.openclaw.mac openclaw.nixMode -bool true

Nix モードで変わること

• 自動インストールと自己変更のフローが無効になります。
• openclaw.json は不変として扱われます。起動時に導出されるデフォルト値はランタイム内だけに保持され、設定を書き込む機能（セットアップ、オンボーディング、変更を伴う openclaw update、Plugin のインストール／更新／アンインストール／有効化、doctor --fix、doctor --generate-gateway-token、openclaw config set）はファイルの編集を拒否します。
• 代わりに Nix ソースを編集します。nix-openclaw では、エージェント優先のクイックスタートを使用し、programs.openclaw.config または instances.<name>.config に設定を記述します。
• 依存関係が不足している場合は、Nix 固有の修正方法を示すメッセージが表示されます。
• UI に読み取り専用の Nix モードバナーが表示されます。

設定と状態のパス

OpenClaw は OPENCLAW_CONFIG_PATH から JSON5 設定を読み取り、変更可能なデータを OPENCLAW_STATE_DIR に保存します。Nix では、ランタイム状態と設定が不変ストアに入らないよう、これらを Nix 管理の場所に明示的に設定してください。

サービスの PATH 検出

launchd/systemd の Gateway サービスは Nix プロファイルのバイナリを自動検出するため、nix でインストールされた実行ファイルを呼び出す Plugin やツールは、PATH を手動設定しなくても動作します。

• NIX_PROFILES が設定されている場合、すべてのエントリが右から左の優先順位でサービスの PATH に追加されます（Nix シェルの優先順位と一致し、右端が優先されます）。
• NIX_PROFILES が未設定の場合、フォールバックとして ~/.nix-profile/bin が追加されます。

これは、macOS の launchd と Linux の systemd の両方のサービス環境に適用されます。

関連項目