null·clw v2026.6.1
Menu
Browse documentation

Start

Install

verified · v2026.6.1 edit on github
On this page 6 sections

nllclw ships as one standalone binary — no Node, Python, curl, or provider SDKs at runtime. Pick a release asset, build from source, or pull the container image.

Release binary

Prebuilt binaries are attached to GitHub Releases. Assets are built for Linux, macOS, Windows, and Android. Linux, macOS, and Android assets use .bin; Windows assets use .zip.

Download the asset for your OS and CPU, make it executable on Unix-like systems, then run:

chmod +x nllclw
./nllclw --help

If --help prints, you are done. Continue with the quickstart.

Build from source

You need Zig 0.16.0 exactly — the package metadata pins the minimum compiler in build.zig.zon. Get it from the official Zig downloads page, then:

git clone https://github.com/nullclaw/nllclw.git
cd nllclw
zig build --release=small
./zig-out/bin/nllclw --help

The ReleaseSmall binary comes out at 899,784 bytes; stripped, 813,760 bytes — measured by the project, with reproduction commands in the repo's docs/en/benchmarks.md.

To run the test suite:

zig build test --summary all

The full test suite passes on the default build; a few extra tests compile in with -Dshell-tool=true.

Container image

A container image is published to GitHub Container Registry:

docker run --rm ghcr.io/nullclaw/nllclw:v2026.6.1 --help

Where files go

The binary itself can live anywhere. Everything else is kept out of your project directory:

  • config: ~/.config/nllclw/config.json (or $XDG_CONFIG_HOME/nllclw/; on Windows, %APPDATA%\nllclw\)
  • state (memory, facts, schedules): ~/.local/state/nllclw (or $XDG_STATE_HOME/nllclw; on Windows, %LOCALAPPDATA%\nllclw)

Uninstall

./nllclw uninstall

This removes the nllclw user config and state directories. Delete the binary itself by hand.

Next

Run the setup wizard — see the quickstart. If you need ~60 providers and 26 chat channels, the larger runtime is NullClaw.