跳转到内容
OpenClaw Docs

Nix

Nix 安装

Section titled “Nix 安装”

使用 nix-openclaw 以声明式方式安装 OpenClaw —— 这是一个功能齐全的 Home Manager 模块。

你将获得

Section titled “你将获得”
  • Gateway(网关) + macOS 应用 + 工具 —— 全部已固定版本
  • 可在重启后存活的 Launchd 服务
  • 具有声明式配置的插件系统
  • 即时回滚：home-manager switch --rollback

快速开始

Section titled “快速开始”

  1. 安装 Determinate Nix

    如果尚未安装 Nix，请按照 Determinate Nix 安装程序 的说明操作。

  2. 创建本地 flake

    使用 nix-openclaw 仓库中的 agent-first 模板： bash mkdir -p ~/code/openclaw-local # Copy templates/agent-first/flake.nix from the nix-openclaw repo

  3. 配置密钥

    设置您的消息机器人令牌和模型提供商 API 密钥。位于 ~/.secrets/ 的普通文件即可。

  4. 填写模板占位符并切换

    bash home-manager switch

  5. 验证

    确认 launchd 服务正在运行，并且您的机器人响应消息。

查看 nix-openclaw README 以获取完整的模块选项和示例。

Nix 模式运行时行为

Section titled “Nix 模式运行时行为”

当设置了 OPENCLAW_NIX_MODE=1 时（使用 nix-openclaw 时自动设置），OpenClaw 将进入禁用自动安装流程的确定性模式。

您也可以手动设置：

Terminal window
export OPENCLAW_NIX_MODE=1

在 macOS 上，GUI 应用不会自动继承 shell 环境变量。请改为通过 defaults 启用 Nix 模式：

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

Nix 模式下的变化

Section titled “Nix 模式下的变化”
  • 自动安装和自变异流程被禁用
  • 缺失的依赖项会显示 Nix 特定的修复消息
  • UI 显示只读 Nix 模式横幅

配置和状态路径

Section titled “配置和状态路径”

OpenClaw 从 OPENCLAW_CONFIG_PATH 读取 JSON5 配置，并将可变数据存储在 OPENCLAW_STATE_DIR 中。在 Nix 下运行时，请将这些显式设置为 Nix 管理的位置，以便运行时状态和配置不会保留在不可变存储中。

变量默认值
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

相关

Section titled “相关”