nix-openclaw repo 是 Nix 安裝的真實來源。本頁是快速概覽。
你會取得的內容
- 閘道 + macOS app + 工具（whisper、spotify、cameras），全部固定版本
- 可在重新開機後繼續存活的 launchd 服務
- 具備聲明式設定的外掛系統
- 即時回復：
home-manager switch --rollback
快速開始
安裝 Determinate Nix
如果尚未安裝 Nix，請依照 Determinate Nix installer 的指示操作。
Nix 模式執行階段行為
設定OPENCLAW_NIX_MODE=1 後（使用 nix-openclaw 時會自動設定），OpenClaw 會進入適用於 Nix 管理安裝的確定性模式。其他 Nix 套件也可以設定相同模式；nix-openclaw 是第一方參考實作。
你也可以手動設定：
defaults 啟用 Nix 模式：
Nix 模式中的變更
- 自動安裝與自我變更流程會停用。
openclaw.json會被視為不可變。啟動時衍生的預設值只會保留在執行階段，而設定寫入器（setup、onboarding、會變更內容的openclaw update、外掛 install/update/uninstall/enable、doctor --fix、doctor --generate-gateway-token、openclaw config set）會拒絕編輯該檔案。- 請改為編輯 Nix 來源。若使用 nix-openclaw，請使用 agent-first 快速開始，並在
programs.openclaw.config或instances.<name>.config下設定 config。 - 缺少相依項目時會顯示 Nix 專用的修復訊息。
- UI 會顯示唯讀的 Nix 模式橫幅。
Config 與狀態路徑
OpenClaw 會從OPENCLAW_CONFIG_PATH 讀取 JSON5 config，並將可變資料儲存在 OPENCLAW_STATE_DIR。在 Nix 下，請明確將這些設定為由 Nix 管理的位置，讓執行階段狀態與 config 保持在不可變 store 之外。
| 變數 | 預設值 |
|---|---|
OPENCLAW_HOME | HOME / USERPROFILE / os.homedir() |
OPENCLAW_STATE_DIR | ~/.openclaw |
OPENCLAW_CONFIG_PATH | $OPENCLAW_STATE_DIR/openclaw.json |
服務 PATH 探索
launchd/systemd 閘道服務會自動探索 Nix profile 二進位檔，因此會 shell out 到nix 安裝可執行檔的外掛與工具，不需要手動設定 PATH 也能運作：
- 設定
NIX_PROFILES時，每個項目都會加入服務 PATH，優先順序由右至左（符合 Nix shell 優先順序：最右側勝出）。 - 未設定
NIX_PROFILES時，~/.nix-profile/bin會作為備援加入。
相關
nix-openclaw
真實來源 Home Manager 模組與完整設定指南。
設定精靈
非 Nix 的命令列介面設定逐步解說。
Docker
作為非 Nix 替代方案的容器化設定。
更新
與套件一併更新由 Home Manager 管理的安裝。