> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

> Home Manager ベースで OpenClaw を宣言的に導入する nix-openclaw の使い方を案内します。

# Nix

Nix で OpenClaw を使う場合の推奨手段は、**[nix-openclaw](https://github.com/openclaw/nix-openclaw)** を利用する方法です。必要なものが一通り揃った Home Manager モジュールとして提供されています。

## クイックスタート

次の内容を AI エージェント (Claude、Cursor など) に貼り付けてください。

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
I want to set up nix-openclaw on my Mac.
Repository: github:openclaw/nix-openclaw

What I need you to do:
1. Check if Determinate Nix is installed (if not, install it)
2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
4. Set up secrets (bot token, model provider API key) - plain files at ~/.secrets/ is fine
5. Fill in the template placeholders and run home-manager switch
6. Verify: launchd running, bot responds to messages

Reference the nix-openclaw README for module options.
```

> **📦 完全なガイド: [github.com/openclaw/nix-openclaw](https://github.com/openclaw/nix-openclaw)**
>
> nix-openclaw リポジトリは、Nix インストールの信頼できる情報源です。このページは単なる概要です。

## 得られるもの

* Gateway + macOS アプリ + ツール (whisper, spotify, cameras) — すべて固定
* 再起動後も残る Launchd サービス
* 宣言的設定を備えたプラグインシステム
* インスタントロールバック: `home-manager switch --rollback`

***

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

`OPENCLAW_NIX_MODE=1` が設定されている場合 (nix-openclaw では自動):

OpenClaw には、設定を決定論的に保ち、自動インストール系のフローを無効にする **Nix モード** があります。次を export して有効にします。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_NIX_MODE=1
```

macOS では、GUI アプリは自動的にシェルの環境変数を継承しません。
defaults 経由で Nix モードを有効にすることもできます:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
defaults write ai.openclaw.mac openclaw.nixMode -bool true
```

### Config + 状態のパス

OpenClaw は `OPENCLAW_CONFIG_PATH` から JSON5 設定を読み取り、`OPENCLAW_STATE_DIR` にミュータブルなデータを保存します。
必要に応じて、`OPENCLAW_HOME` を設定して、内部パス解決に使用されるベースのホームディレクトリを制御することもできます。

* `OPENCLAW_HOME` (優先順位のデフォルト: `HOME` / `USERPROFILE` / `os.homedir()`)
* `OPENCLAW_STATE_DIR` (デフォルト: `~/.openclaw`)
* `OPENCLAW_CONFIG_PATH` (デフォルト: `$OPENCLAW_STATE_DIR/openclaw.json`)

Nix 環境で実行する場合は、ランタイム状態や設定が不変ストアの外に出るよう、これらのパスを Nix 管理下の適切な場所へ明示的に向けてください。

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

* 自動インストールや自己変更系フローは無効になります
* 依存関係が不足している場合、Nix 固有の修復メッセージが表示されます
* 対応 UI では、読み取り専用の Nix モードバナーが表示されます

## パッケージングに関する注意 (macOS)

macOS のパッケージングフローは、以下にある安定した Info.plist テンプレートを想定しています:

```
apps/macos/Sources/OpenClaw/Resources/Info.plist
```

[`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh) は、このテンプレートをアプリバンドルにコピーし、動的フィールド (バンドル ID、バージョン/ビルド、Git SHA、Sparkle キー) にパッチを当てます。これにより、SwiftPM パッケージングと Nix ビルド (完全な Xcode ツールチェーンに依存しない) で plist が決定論的に保たれます。

## 関連

* [nix-openclaw](https://github.com/openclaw/nix-openclaw) — 完全なセットアップガイド
* [ウィザード](/start/wizard) — Nix 以外の CLI セットアップ
* [Docker](/install/docker) — コンテナ化されたセットアップ