Nix を使用した OpenClaw のセットアップ

開発環境を構築する際、OS のアップデートや依存ライブラリの更新によって、昨日まで動いていたものが突然動かなくなることはよくあります。設定ファイルを各マシンで手動で同期させたり、環境ごとの差異に悩まされたりするのは、本来の作業時間を奪う大きなストレスです。

OpenClaw を Nix で管理すれば、こうした環境の不整合から解放されます。構成を宣言的に記述し、いつでも元の状態にロールバックできる環境を手に入れましょう。

必要なもの

セットアップを始める前に、源文書で指定されている以下の準備を確認してください。

• Determinate Nix: Nix 本体のインストールが必要です
• nix-openclaw リポジトリ: github:openclaw/nix-openclaw を使用します
• Telegram アカウント: @BotFather でのボット作成と @userinfobot での chat ID 取得が必要です
• API キー: Anthropic key などのシークレット情報
• macOS 環境: macOS アプリや launchd サービスを利用する場合

クイックスタート

AI エージェント（Claude や Cursor など）を使って、5分でセットアップを完了させるのが最も効率的です。以下のテキストをコピーして貼り付けてください。

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, Anthropic 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.

セットアップが完了すると、Gateway、macOS アプリ、各種ツール（whisper, spotify, cameras）がすべて固定されたバージョンでインストールされます。また、再起動後も自動で立ち上がる launchd サービスや、home-manager switch --rollback による即時ロールバック機能が利用可能になります。

Nix Mode の動作

OPENCLAW_NIX_MODE=1 を設定すると（nix-openclaw では自動設定されます）、OpenClaw は Nix モードで動作します。このモードでは、自動インストール機能が無効化され、環境の決定論的な状態が維持されます。

macOS の GUI アプリでこのモードを有効にするには、以下のコマンドを実行してください。

defaults write bot.molt.mac openclaw.nixMode -bool true

また、設定ファイルや状態保存先のパスを Nix 管理下に置くため、以下の環境変数を明示的に設定することを推奨します。

• OPENCLAW_HOME: 内部パス解決のベースディレクトリ
• OPENCLAW_STATE_DIR: デフォルトは ~/.openclaw
• OPENCLAW_CONFIG_PATH: デフォルトは $OPENCLAW_STATE_DIR/openclaw.json

トラブルシューティング

Nix 環境で問題が発生した場合は、以下の点を確認してください。

• 依存関係の不足: Nix モードでは、必要な依存関係が不足している場合、Nix 専用の修復メッセージが画面に表示されます。その指示に従って構成を修正してください。
• 設定の変更: Nix モード実行中は UI に「読み取り専用」のバナーが表示されます。設定の変更は UI からではなく、Nix の設定ファイルを通じて行う必要があります。

詳細な設定オプションについては、nix-openclaw の README を参照してください。

不明な点がある場合は、AI Setup Assistant に質問してください。

次のステップ

• nix-openclaw — フルセットアップガイド
• Wizard — Nix を使用しない CLI セットアップ
• Docker — コンテナ環境でのセットアップ