Nix Installation
The recommended way to run WednesdayAI with Nix is via nix-openclaw — a batteries-included Home Manager module.Quick Start
Paste this to your AI agent (Claude, Cursor, etc.):📦 Full guide: github.com/openclaw/nix-openclaw The nix-wednesdayai repo is the source of truth for Nix installation. This page is just a quick overview.
What you get
- Gateway + macOS app + tools (whisper, spotify, cameras) — all pinned
- Launchd service that survives reboots
- Plugin system with declarative config
- Instant rollback:
home-manager switch --rollback
Nix Mode Runtime Behavior
WhenOPENCLAW_NIX_MODE=1 is set (automatic with nix-openclaw):
WednesdayAI supports a Nix mode that makes configuration deterministic and disables auto-install flows.
Enable it by exporting:
Config + state paths
WednesdayAI reads JSON5 config fromOPENCLAW_CONFIG_PATH and stores mutable data in OPENCLAW_STATE_DIR.
When needed, you can also set OPENCLAW_HOME to control the base home directory used for internal path resolution.
OPENCLAW_HOME(default precedence:HOME/USERPROFILE/os.homedir())OPENCLAW_STATE_DIR(default:~/.openclaw)OPENCLAW_CONFIG_PATH(default:$OPENCLAW_STATE_DIR/openclaw.json)
Runtime behavior in Nix mode
- Auto-install and self-mutation flows are disabled
- Missing dependencies surface Nix-specific remediation messages
- UI surfaces a read-only Nix mode banner when present
- Retired config keys never block startup. A Nix-managed config is immutable, so the gateway cannot rewrite it; instead it drops retired keys in memory and logs one warning naming them, so an upgrade that retires a key your config still carries still boots. Remove the named keys from your Nix configuration to clear the warning.
- Legacy keys that need a real migration still refuse startup, because the gateway cannot apply
the migration for you. Run
wednesdayai doctor --fixagainst a writable copy of the config to see the rewrite, then port it into your Nix configuration.
Packaging note (macOS)
The macOS app lives in the WednesdayAI-apps repository. Its packaging flow expects a stable Info.plist template atapps/macos/Sources/OpenClaw/Resources/Info.plist in that WednesdayAI-apps checkout;
scripts/package-mac-app.sh copies this template into the app bundle and patches dynamic fields
(bundle ID, version/build, Git SHA, Sparkle keys). This keeps the plist deterministic for SwiftPM
packaging and Nix builds (which do not rely on a full Xcode toolchain).
Related
- nix-openclaw — full setup guide
- Wizard — non-Nix CLI setup
- Docker — containerized setup