Containers
Nix
使用 nix-openclaw，以宣告式方式安裝 OpenClaw；這是官方提供、功能齊備的 Home Manager 模組。
你將獲得的功能
- 閘道 + macOS 應用程式 + 工具（whisper、spotify、攝影機），全部鎖定版本
- 重新啟動後仍會持續運作的 launchd 服務
- 支援宣告式設定的外掛系統
- 即時復原：
home-manager switch --rollback
快速開始
安裝 Determinate Nix
如果尚未安裝 Nix，請依照 Determinate Nix 安裝程式的說明操作。
建立本機 flake
使用 nix-openclaw 儲存庫中以代理程式為優先的範本：
mkdir -p ~/code/openclaw-local# 從 nix-openclaw 儲存庫複製 templates/agent-first/flake.nix設定密鑰
設定訊息機器人的權杖和模型供應商 API 金鑰。使用 ~/.secrets/ 中的純文字檔案即可。
填入範本預留位置並切換
home-manager switch驗證
確認 launchd 服務正在執行，且機器人會回應訊息。
如需完整的模組選項與範例，請參閱 nix-openclaw README。
Nix 模式的執行階段行為
設定 OPENCLAW_NIX_MODE=1 時（使用 nix-openclaw 時會自動設定），OpenClaw 會針對由 Nix 管理的安裝進入確定性模式。其他 Nix 套件也可以設定相同模式；nix-openclaw 是官方參考實作。
你也可以手動設定：
export OPENCLAW_NIX_MODE=1在 macOS 上，圖形介面應用程式不會繼承 shell 環境變數。請改用 defaults 啟用 Nix 模式：
defaults write ai.openclaw.mac openclaw.nixMode -bool trueNix 模式中的變更
- 自動安裝和自我修改流程會停用。
openclaw.json會被視為不可變更。啟動時衍生的預設值只會保留在執行階段，而設定寫入工具（設定、初始設定、會修改內容的openclaw update、外掛安裝／更新／解除安裝／啟用、doctor --fix、doctor --generate-gateway-token、openclaw config set）會拒絕編輯該檔案。- 請改為編輯 Nix 原始碼。若使用 nix-openclaw，請參閱以代理程式為優先的快速開始，並在
programs.openclaw.config或instances.<name>.config下設定。 - 缺少相依項目時，會顯示 Nix 專用的修復訊息。
- 使用者介面會顯示唯讀的 Nix 模式橫幅。
設定與狀態路徑
OpenClaw 會從 OPENCLAW_CONFIG_PATH 讀取 JSON5 設定，並將可變資料儲存在 OPENCLAW_STATE_DIR。在 Nix 環境下，請明確將這些項目設為由 Nix 管理的位置，讓執行階段狀態與設定不會進入不可變更的儲存區。
| 變數 | 預設值 |
|---|---|
OPENCLAW_HOME |
HOME / USERPROFILE / os.homedir() |
OPENCLAW_STATE_DIR |
~/.openclaw |
OPENCLAW_CONFIG_PATH |
$OPENCLAW_STATE_DIR/openclaw.json |
服務 PATH 探索
launchd/systemd 閘道服務會自動探索 Nix 設定檔中的二進位檔，讓會透過 shell 呼叫由 nix 安裝之可執行檔的外掛和工具，無須手動設定 PATH 即可運作：
- 設定
NIX_PROFILES時，每個項目都會依由右至左的優先順序加入服務 PATH（符合 Nix shell 的優先順序：最右側優先）。 - 未設定
NIX_PROFILES時，會加入~/.nix-profile/bin作為備援。
這適用於 macOS launchd 和 Linux systemd 的服務環境。
相關內容
Was this useful?
