nix-openclaw 仓库是 Nix 安装的唯一事实来源。本页仅作快速概览。
你将获得什么
- Gateway + macOS 应用 + 工具（whisper、spotify、cameras）——全部已固定版本
- 可在重启后继续运行的 launchd 服务
- 具有声明式配置的插件系统
- 立即回滚：
home-manager switch --rollback
快速开始
安装 Determinate Nix
如果尚未安装 Nix，请按照 Determinate Nix installer 的说明进行操作。
Nix 模式运行时行为
当设置了OPENCLAW_NIX_MODE=1（在使用 nix-openclaw 时会自动设置）时，OpenClaw 会进入适用于 Nix 管理安装的确定性模式。其他 Nix 包也可以设置相同模式；nix-openclaw 是首选参考实现。
你也可以手动设置：
Nix 模式下会有什么变化
- 自动安装和自我修改流程被禁用
openclaw.json会被视为不可变。启动时生成的默认值仍仅限于运行时，且诸如 setup、onboarding、会修改配置的openclaw update、plugin install/update/uninstall/enable、doctor --fix、doctor --generate-gateway-token和openclaw config set等配置写入器都会拒绝编辑该文件。- 应由代理直接编辑 Nix 源代码。对于 nix-openclaw，请使用 agent-first Quick Start，并在
programs.openclaw.config或instances.<name>.config下设置配置。 - 缺失依赖会显示 Nix 特定的修复建议消息
- UI 会显示只读的 Nix 模式横幅
配置和状态路径
OpenClaw 会从OPENCLAW_CONFIG_PATH 读取 JSON5 配置，并将可变数据存储在 OPENCLAW_STATE_DIR 中。在 Nix 下运行时，请将这些路径显式设置为由 Nix 管理的位置，以便运行时状态和配置都不会进入不可变的 store。
| Variable | Default |
|---|---|
OPENCLAW_HOME | HOME / USERPROFILE / os.homedir() |
OPENCLAW_STATE_DIR | ~/.openclaw |
OPENCLAW_CONFIG_PATH | $OPENCLAW_STATE_DIR/openclaw.json |
服务 PATH 发现
launchd/systemd 网关服务会自动发现 Nix-profile 二进制文件，因此通过 shell 调用nix 安装的可执行文件的插件和工具无需手动设置 PATH：
- 当设置了
NIX_PROFILES时，每个条目都会按从右到左的优先级添加到服务 PATH 中（与 Nix shell 的优先级一致——最右侧获胜）。 - 当未设置
NIX_PROFILES时，会将~/.nix-profile/bin作为回退路径添加。
相关内容
nix-openclaw
事实来源的 Home Manager 模块和完整设置指南。
Setup wizard
非 Nix CLI 设置流程。
Docker
容器化安装，作为非 Nix 替代方案。
Updating
将 Home Manager 管理的安装与包一起更新。