使用 Nix 安裝 OpenClaw

每次換新電腦或重裝系統，最煩的就是要把那些開發環境、API 密鑰和各種依賴項重新設定一遍。如果你也受夠了「在我電腦上明明可以執行」的混亂，或者擔心手動安裝的工具會弄亂系統路徑，那麼使用 Nix 來管理 OpenClaw 是最穩定的方案。

透過 Nix，你可以把整個 OpenClaw 環境（包含 Gateway、各種工具和 macOS App）定義成程式碼。這意味著你的配置是可預測的，而且隨時可以回滾到之前的版本。

需要準備的東西

在開始之前，請確保你已經準備好以下項目（僅限源文件提到的內容）：

• 一台 Mac 電腦
• nix-openclaw：這是官方推薦的 Home Manager module
• Telegram 帳號：用於向 @BotFather 申請機器人，以及向 @userinfobot 取得你的 chat ID
• API Keys：例如 Anthropic 的金鑰
• 基礎的 Nix 環境

快速開始

如果你正在使用 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.

設定完成後，你會獲得：

• 自動釘選版本的 Gateway、macOS App 與相關工具（Whisper, Spotify, 相機等）
• 重啟電腦後會自動執行的 launchd 服務
• 聲明式的 Plugin 系統配置
• 支援快速回滾：home-manager switch --rollback

Nix Mode 運行機制

當系統偵測到 OPENCLAW_NIX_MODE=1 時（在 nix-openclaw 中會自動設定），OpenClaw 會進入確定性模式。在這個模式下，所有的自動安裝流程都會被禁用，以確保環境不會被非預期地更動。

環境變數設定

如果你是手動設定，可以透過以下方式開啟 Nix 模式：

export OPENCLAW_NIX_MODE=1

在 macOS 上，GUI App 通常不會繼承 Shell 的環境變數。你可以透過 defaults 指令來開啟：

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

設定檔與路徑

在 Nix 模式下，建議明確設定以下路徑，讓運行時的狀態資料與唯讀的 Nix Store 分開：

• OPENCLAW_HOME：內部路徑解析的基準目錄（預設優先順序：HOME / USERPROFILE / os.homedir()）
• OPENCLAW_STATE_DIR：存放可變動資料的地方（預設：~/.openclaw）
• OPENCLAW_CONFIG_PATH：讀取 JSON5 設定檔的位置（預設：$OPENCLAW_STATE_DIR/openclaw.json）

疑難排解

macOS GUI 無法讀取 Nix 配置

問題： 在終端機執行正常，但啟動 macOS App 後 Nix 模式沒有生效。 方案： 由於 macOS GUI App 不會自動繼承 Shell 環境變數，請執行以下指令強制開啟： defaults write bot.molt.mac openclaw.nixMode -bool true

缺少依賴組件

問題： 運行時提示缺少某些工具。 方案： 在 Nix 模式下，OpenClaw 會停用自動安裝功能。如果缺少依賴，UI 會顯示針對 Nix 的修復建議訊息。請檢查你的 Home Manager 配置是否完整包含了所需的 plugin 依賴。

---

想要更聰明地完成安裝嗎？試試我們的 AI Setup Assistant。

下一步

• nix-openclaw 完整指南 — 深入了解所有 module 選項
• Wizard 設定 — 如果你想嘗試非 Nix 的 CLI 安裝方式
• Docker 部署 — 在容器環境中執行 OpenClaw