Files
openclaw/docs/zh-CN/install/nix.md
Josh Palmer a3ec2d0734 Docs: update zh-CN translations and pipeline
What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
2026-02-03 13:23:00 -08:00

3.4 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你想要可复现、可回滚的安装
你已经在使用 Nix/NixOS/Home Manager
你想要所有内容都固定并以声明式管理
使用 Nix 声明式安装 OpenClaw Nix
generated_at model provider source_hash source_path workflow
2026-02-03T07:49:51Z claude-opus-4-5 pi f1452194cfdd74613b5b3ab90b0d506eaea2d16b147497987710d6ad658312ba install/nix.md 15

Nix 安装

使用 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-openclaw

nix-openclaw 仓库是 Nix 安装的权威来源。本页只是一个快速概述。

你将获得

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

Nix 模式运行时行为

当设置 OPENCLAW_NIX_MODE=1nix-openclaw 会自动设置):

OpenClaw 支持 Nix 模式,使配置确定性并禁用自动安装流程。 通过导出以下环境变量启用:

OPENCLAW_NIX_MODE=1

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

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

配置 + 状态路径

OpenClaw 从 OPENCLAW_CONFIG_PATH 读取 JSON5 配置,并将可变数据存储在 OPENCLAW_STATE_DIR 中。

  • 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 工具链)。

相关内容