Nix 安装

使用 Nix 运行 OpenClaw 的推荐方式是通过 nix-openclaw — 一个功能齐全的 Home Manager 模块。

快速开始

将以下内容粘贴给您的 AI 代理（Claude、Cursor 等）：

text

我想在我的 Mac 上设置 nix-openclaw。
仓库：github:openclaw/nix-openclaw

我需要您做的事情：
1. 检查是否安装了 Determinate Nix（如果没有，安装它）
2. 使用 templates/agent-first/flake.nix 在 ~/code/openclaw-local 创建本地 flake
3. 帮我创建 Telegram 机器人（@BotFather）并获取我的 chat ID（@userinfobot）
4. 设置 secrets（机器人令牌、Anthropic key）- 放在 ~/.secrets/ 的纯文件即可
5. 填写模板占位符并运行 home-manager switch
6. 验证：launchd 正在运行，机器人响应消息

参考 nix-openclaw README 了解模块选项。

📦 完整指南：github.com/openclaw/nix-openclaw
nix-openclaw 仓库是 Nix 安装的权威来源。本页面只是快速概述。

您将获得

网关 + macOS 应用 + 工具（whisper、spotify、cameras）— 全部固定版本
重启后仍存在的 Launchd 服务
带有声明式配置的插件系统
即时回滚：home-manager switch --rollback

Nix 模式运行时行为

当设置 OPENCLAW_NIX_MODE=1 时（使用 nix-openclaw 会自动设置）：

OpenClaw 支持一种 Nix 模式，使配置具有确定性并禁用自动安装流程。通过导出来启用：

bash

OPENCLAW_NIX_MODE=1

在 macOS 上，GUI 应用不会自动继承 shell 环境变量。您也可以通过 defaults 启用 Nix 模式：

bash

defaults write com.openclaw.mac openclaw.nixMode -bool true

配置和状态路径

OpenClaw 从 OPENCLAW_CONFIG_PATH 读取 JSON5 配置，并在 OPENCLAW_STATE_DIR 中存储可变数据。

OPENCLAW_STATE_DIR（默认：~/.openclaw）
OPENCLAW_CONFIG_PATH（默认：$OPENCLAW_STATE_DIR/openclaw.json）

在 Nix 下运行时，将这些明确设置为 Nix 管理的位置，以便运行时状态和配置保持在不可变存储之外。

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 keys）。这使 plist 对于 SwiftPM 打包和 Nix 构建（不依赖完整 Xcode 工具链）保持确定性。

Nix 安装 ​

快速开始 ​

您将获得 ​

Nix 模式运行时行为 ​

配置和状态路径 ​

Nix 模式下的运行时行为 ​

打包说明（macOS） ​

相关 ​