> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Nix

# Nix 安裝

以 Nix 執行 OpenClaw 的建議方式是透過 **[nix-openclaw](https://github.com/openclaw/nix-openclaw)** —— 一個內建完整功能的 Home Manager 模組。

## 快速開始

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](https://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\.
透過匯出以下內容來啟用：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_NIX_MODE=1
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh) 會將此範本複製到應用程式套件中，並修補動態欄位
（bundle ID、版本／建置、Git SHA、Sparkle 金鑰）。這能讓 plist 對於 SwiftPM
封裝與 Nix 建置保持決定性（不需仰賴完整的 Xcode 工具鏈）。 相關 相關

## Related

* [nix-openclaw](https://github.com/openclaw/nix-openclaw) — 完整設定指南
* [Wizard](/start/wizard) — 非 Nix 的 CLI 設定
* [Docker](/install/docker) — 容器化設定