nix-openclaw リポジトリは、Nix インストールに関する信頼できる情報源です。このページはクイック概要です。
得られるもの
- Gateway + macOS アプリ + ツール（whisper、spotify、cameras）。すべてピン留め済み
- 再起動後も継続する launchd サービス
- 宣言的設定を備えた Plugin システム
- 即時ロールバック:
home-manager switch --rollback
クイックスタート
Install Determinate Nix
Nix がまだインストールされていない場合は、Determinate Nix installer の手順に従ってください。
Nix モードのランタイム動作
OPENCLAW_NIX_MODE=1 が設定されている場合（nix-openclaw では自動）、OpenClaw は Nix 管理のインストール向けの決定論的モードに入ります。他の Nix パッケージも同じモードを設定できます。nix-openclaw はファーストパーティのリファレンスです。
手動で設定することもできます。
defaults で Nix モードを有効にしてください。
Nix モードで変わること
- 自動インストールと自己変更フローは無効化されます。
openclaw.jsonは不変として扱われます。起動時に導出されるデフォルトはランタイム内にのみ留まり、設定ライター（setup、オンボーディング、変更を伴うopenclaw update、Plugin の install/update/uninstall/enable、doctor --fix、doctor --generate-gateway-token、openclaw config set）はファイルの編集を拒否します。- 代わりに Nix ソースを編集してください。nix-openclaw では、agent-first のクイックスタートを使用し、
programs.openclaw.configまたはinstances.<name>.configの下に設定を置きます。 - 不足している依存関係は、Nix 固有の修復メッセージとして表示されます。
- UI には読み取り専用の Nix モードバナーが表示されます。
設定と状態のパス
OpenClaw はOPENCLAW_CONFIG_PATH から JSON5 設定を読み取り、OPENCLAW_STATE_DIR に可変データを保存します。Nix では、ランタイム状態と設定が不変ストアの外に留まるよう、これらを Nix 管理の場所に明示的に設定してください。
| 変数 | デフォルト |
|---|---|
OPENCLAW_HOME | HOME / USERPROFILE / os.homedir() |
OPENCLAW_STATE_DIR | ~/.openclaw |
OPENCLAW_CONFIG_PATH | $OPENCLAW_STATE_DIR/openclaw.json |
サービス PATH の検出
launchd/systemd の Gateway サービスは Nix プロファイルのバイナリを自動検出するため、nix でインストールされた実行可能ファイルをシェルから呼び出す Plugin やツールは、手動で PATH を設定しなくても動作します。
NIX_PROFILESが設定されている場合、すべてのエントリが右から左の優先順位でサービス PATH に追加されます（Nix シェルの優先順位と一致し、最も右が優先されます）。NIX_PROFILESが未設定の場合、フォールバックとして~/.nix-profile/binが追加されます。
関連
nix-openclaw
信頼できる情報源である Home Manager モジュールと完全なセットアップガイド。
Setup wizard
Nix 以外の CLI セットアップ手順。
Docker
Nix 以外の代替手段としてのコンテナ化セットアップ。
Updating
パッケージとともに Home Manager 管理のインストールを更新する方法。