Nix Packaging

Batteries-included nixified OpenClaw configuration for reproducible deployments.

Nix-OpenClaw is the official Nix packaging for OpenClaw, maintained by the core team. It provides fully declarative, reproducible OpenClaw deployments on macOS and Linux (headless). Instead of managing OpenClaw through npm and manual configuration, you declare your entire setup — gateway config, skills, channels, environment variables — in a Nix flake, and `nixos-rebuild switch` gives you exactly the deployment you described. The project follows the 'Golden Paths' philosophy: opinionated, well-tested deployment configurations that just work. It handles dependency management, service supervision, automatic restarts, and configuration validation — all the operational concerns that manual installations leave to the user. For NixOS users, this is the recommended deployment method, providing the same reproducibility guarantees they expect from the rest of their system. The Nix packaging is actively developed but not accepting PRs in the traditional sense. The team requires human-to-human discussion on Discord before any changes, reflecting the project's position as critical infrastructure that needs careful coordination. For users who value reproducibility, rollback capability, and declarative configuration, this is the most robust way to run OpenClaw.

Tags: nix, packaging, deployment, reproducible

Category: infrastructure

Tips

  • Join the OpenClaw Discord #golden-path-deployments channel before starting — the maintainers are responsive and can save you hours of trial and error
  • Start with an existing Golden Path configuration and modify it rather than building from scratch — the opinionated defaults are well-tested
  • Use `nixos-rebuild --rollback` liberally during setup — Nix's rollback capability makes experimentation safe
  • Pin your flake inputs to specific commits for production deployments to avoid unexpected updates breaking your setup
  • Combine with NixOS system configuration to manage OpenClaw alongside the rest of your server's services declaratively

Community Feedback

Declarative OpenClaw. Bulletproof by default. macOS + Linux (headless). Questions? Join the OpenClaw Discord and ask in #golden-path-deployments.

— GitHub

Nix packaging means I can describe my entire OpenClaw setup in one file, version it, and rebuild identical deployments on any machine. No more 'works on my box' issues.

— OpenClaw Community

Frequently Asked Questions

Do I need to run NixOS to use this?

No. The Nix flake works on any system with Nix installed — including macOS and non-NixOS Linux. However, you get the most benefits (service management, system integration) on NixOS.

Why aren't they accepting PRs?

The project is critical infrastructure that's still stabilizing. The team prefers synchronous discussion on Discord over async PR review to maintain quality and coordination. Describe your problem on Discord first, then work with a maintainer.

How does this compare to Docker deployment?

Nix provides stronger reproducibility guarantees than Docker — exact dependency versions, rollback capability, and integration with system-level configuration. Docker is simpler for quick setups; Nix is better for long-term, production-grade deployments.

Does it support Windows?

No. Windows is explicitly out of scope. The project supports macOS and Linux (headless). Windows users should use WSL2 with a Linux Nix setup or choose Docker deployment instead.