Nix 安裝¶

以 Nix 執行 OpenClaw 的建議方式是透過 nix-openclaw —— 一個內建完整功能的 Home Manager 模組。

快速開始¶

將以下內容貼給你的 AI 代理程式（Claude、Cursor 等）：

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.

📦 完整指南：github.com/openclaw/nix-openclaw

此頁面僅為快速總覽。 This page is just a quick overview.

你將獲得什麼¶

• Gateway + macOS 應用程式 + 工具（whisper、spotify、cameras）— 全部已釘選
• 可在重新開機後持續運作的 Launchd 服務
• 具備宣告式設定的外掛系統
• 即時回滾：home-manager switch --rollback

Nix 模式執行期行為¶

當設定 OPENCLAW_NIX_MODE=1（使用 nix-openclaw 會自動設定）時：

OpenClaw 支援 Nix 模式，可使設定具備決定性，並停用自動安裝流程。 可透過匯出以下設定來啟用： 14. 透過匯出以下內容來啟用：

OPENCLAW_NIX_MODE=1

15. 在 macOS 上，GUI 應用程式不會自動繼承 shell 的環境變數。 設定 + 狀態路徑

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

Config + state paths¶

OpenClaw 會從 OPENCLAW_CONFIG_PATH 讀取 JSON5 設定，並將可變資料儲存在 OPENCLAW_STATE_DIR。 19. 視需要也可以設定 OPENCLAW_HOME，以控制內部路徑解析所使用的基礎家目錄。

• 20. OPENCLAW_HOME（預設優先順序：HOME / USERPROFILE / os.homedir()）
• OPENCLAW_STATE_DIR（預設：~/.openclaw）
• OPENCLAW_CONFIG_PATH（預設：$OPENCLAW_STATE_DIR/openclaw.json）

在 Nix 環境下執行時，請將這些明確設定為由 Nix 管理的位置，讓執行期狀態與設定 保持在不可變 store 之外。

Nix 模式下的執行期行為¶

• 停用自動安裝與自我變更流程
• 缺少相依項目時會顯示 Nix 專屬的修復提示訊息
• 當存在時，UI 會顯示唯讀的 Nix 模式橫幅

封裝注意事項（macOS）¶

macOS 的封裝流程預期在以下位置有一個穩定的 Info.plist 範本：

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

scripts/package-mac-app.sh 會將此範本複製到應用程式套件中，並修補動態欄位 （bundle ID、版本／建置、Git SHA、Sparkle 金鑰）。這能讓 plist 對於 SwiftPM 封裝與 Nix 建置保持決定性（不需仰賴完整的 Xcode 工具鏈）。 相關

Related¶

• nix-openclaw — 完整設定指南
• Wizard — 非 Nix 的 CLI 設定
• Docker — 容器化設定