Nix 安装

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

快速开�?

将此粘贴给你�?AI 代理（Claude、Cursor 等）�?

我想在我�?Mac 上设�?nix-openclaw�?
仓库：github:openclaw/nix-openclaw

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

参�?nix-openclaw README 获取模块选项�?

完整指南：github.com/openclaw/nix-openclaw

nix-openclaw 仓库�?Nix 安装的真实来源。本页面只是一个快速概览�?

你得到的

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

Nix 模式运行时行�?

当设�?OPENCLAW_NIX_MODE=1 时（nix-openclaw 自动设置）：

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

OPENCLAW_NIX_MODE=1

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

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

配置 + 状态路�?

OpenClaw �?OPENCLAW_CONFIG_PATH 读取 JSON5 配置，并�?OPENCLAW_STATE_DIR 中存储可变数据�? 如需要，你也可以设置 OPENCLAW_HOME 来控制用于内部路径解析的基本主目录�?

OPENCLAW_HOME（默认优先级：HOME / USERPROFILE / os.homedir()�?
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 密钥）。这�?plist �?SwiftPM 打包�?Nix 构建具有确定性（不依赖于完整�?Xcode 工具链）�?