Nix OpenClaw
https://github.com/openclaw/nix-openclaw- Category
- Developer Tools
- Rank
- No. 978Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- openclaw
- GitHub
- 712 stars
- Latest release
- v2026.7.1
- Date
About
OpenClaw packaged for Nix. One-line install for the OpenClaw agent stack on NixOS and any Nix-using system.
What it does
It turns an OpenClaw deployment into declared machine state. Configuration, services, dependencies, workspace bootstrap data, and supported plugins are pinned through Nix, while sessions, caches, pairing, approvals, and memory remain runtime state. Rebuilding applies changes, and Home Manager generations provide rollback.
Why it's ranked here
The project makes a strong case for operators who already trust Nix. It draws a clear line between immutable configuration and mutable agent state, packages plugin dependencies ahead of activation, and includes real gateway smoke checks. Its value drops sharply outside the documented deployment shapes.
What's good
Runtime plugins load from immutable package roots instead of modifying the user directory. Exact package versions and hashes prevent registry drift. Unsupported plugin shapes fail closed. Tool plugins bundle binaries, skills, environment requirements, and state directory needs. The project also validates configuration against OpenClaw and tests that the gateway discovers configured plugins.
Tradeoffs
You need Nix with flakes, plus Home Manager or equivalent host integration. Platform support is limited to Apple Silicon macOS and x86_64 Linux, with Linux described as headless and Windows excluded. Some plugins cannot be packaged unless publishers include bundled dependencies or a shrinkwrap. Git, local, marketplace, and local tarball sources lack a direct high-level runtime plugin input. Unsupported deployment shapes receive little support.
How to use it well
Choose it for a personal Mac agent, laptop experiments, or an always-on Linux gateway connected privately to a Mac node. Keep secrets in external files, pin plugin sources, and rebuild after configuration changes. It does not provide hosted service, non-Nix installation, Windows support, or fully declarative macOS privacy permissions.
Technical notes+
README.md defines Nix mode, runtimePlugins, runtimePluginSources, and the split between runtime plugins and tool plugins. docs/golden-paths.md documents three supported topologies and separates pinned configuration from runtime state. nix/scripts/generate-config-options.ts imports the upstream Zod schema and emits typed Nix options. nix/scripts/gateway-smoke.mjs launches an isolated gateway, polls WebSocket health, and optionally confirms a Nix-managed plugin loaded. nix/scripts/check-config-validity.mjs validates rendered configuration, workspace selection, plugin discovery, dependency status, and the absence of mutable-install hints. nix/scripts/patch-openclaw-npm-dist.mjs patches packaged JavaScript to trust Nix store plugin roots and suppress automatic plugin installation in Nix mode. scripts/select-openclaw-release.test.mjs covers stable release and macOS asset selection.
Observed
- Primary implementation
- Nix packaging and modules, supported by JavaScript and TypeScript maintenance scripts.
- Install surface
- Nix flake with Home Manager configuration and an optional nix-darwin wrapper.
- Runtime interface
- Packages the OpenClaw CLI gateway and, on macOS, the OpenClaw app.
- Platform support
- Apple Silicon macOS and x86_64 Linux; Linux is headless and Windows is excluded.
- Plugin packaging
- Supports generated plugin identifiers plus exact npm, ClawHub, and fixed HTTPS artifact sources with Nix hashes.
- Verification structure
- Includes a Node assertion test, gateway smoke test, and rendered configuration validity check.
Read from README.md, docs/golden-paths.md, docs/plugins-maintainers.md, docs/rfc/2026-01-02-declarative-openclaw-nix.md, docs/rfc/2026-05-28-openclaw-runtime-plugins.md, docs/rfc/2026-06-05-runtime-plugin-artifact-materialization.md, scripts/select-openclaw-release.mjs, scripts/select-openclaw-release.test.mjs, nix/scripts/gateway-smoke.mjs, nix/scripts/check-config-validity.mjs, nix/scripts/generate-config-options.ts, nix/scripts/patch-openclaw-npm-dist.mjs.
What it can do
Install OpenClaw agent stack with single command
Nix command → Installed OpenClaw agent system
Package OpenClaw for Nix distribution
OpenClaw source code → Nix package
Deploy on NixOS systems
NixOS configuration → Running OpenClaw agent stack
Deploy on any Nix-compatible system
System with Nix package manager → Running OpenClaw agent stack
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.