跳轉到主要內容

​
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 服務
  • Plugin system with declarative config
  • 即時回滾：home-manager switch --rollback

​
Nix 模式執行期行為

當設定 OPENCLAW_NIX_MODE=1（使用 nix-openclaw 會自動設定）時： OpenClaw 支援 Nix 模式，可使設定具備決定性，並停用自動安裝流程。 可透過匯出以下設定來啟用： 14. 透過匯出以下內容來啟用： 
OPENCLAW_NIX_MODE=1
  1. 在 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，以控制內部路徑解析所使用的基礎家目錄。
  • 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 工具鏈）。 相關 相關