当前位置：首页 > news >正文

OpenClaw从入门到应用——安装：Nix

news 2026/5/12 4:58:08

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

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 机器人（@BotFather）并获取我的聊天 ID（@userinfobot） 4. 设置密钥（机器人令牌、模型提供商 API 密钥）- 使用 ~/.secrets/ 下的纯文本文件即可 5. 填写模板中的占位符并运行 home-manager switch 6. 验证：launchd 正在运行，机器人能响应消息 参考 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 环境变量。你也可以通过以下默认设置命令来启用 Nix 模式：

defaultswriteai.openclaw.mac openclaw.nixMode-booltrue

配置与状态路径

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 环境的修复提示信息
用户界面在启用 Nix 模式时会显示一个只读模式的横幅提示

打包说明（macOS）

macOS 打包流程需要以下路径存在一个稳定的Info.plist模板文件：

apps/macos/Sources/OpenClaw/Resources/Info.plist

scripts/package-mac-app.sh脚本会将该模板复制到应用包中，并填充动态字段（如包标识符、版本/构建号、Git 提交哈希、Sparkle 更新密钥）。这使得Info.plist文件对于 SwiftPM 打包和 Nix 构建（不依赖完整的 Xcode 工具链）保持确定性。