OpenClawNix安装流程

使用 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-openclawnix-openclaw 仓库是 Nix 安装的权威来源。本页只是一个快速概述。

你将获得

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

Nix 模式运行时行为

当设置OPENCLAWNIXMODE=1时（nix-openclaw 会自动设置）： OpenClaw 支持Nix 模式，使配置确定性并禁用自动安装流程。 通过导出以下环境变量启用：

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

defaults write bot.molt.mac openclaw.nixMode -bool true

配置 + 状态路径

OpenClaw 从OPENCLAWCONFIGPATH读取 JSON5 配置，并将可变数据存储在OPENCLAWSTATEDIR中。

• OPENCLAWSTATEDIR（默认：~/.openclaw）
• OPENCLAWCONFIGPATH（默认：$OPENCLAWSTATEDIR/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 工具链）。

相关内容

• nix-openclaw— 完整设置指南
• 向导— 非 Nix CLI 设置
• Docker— 容器化设置