19
top-level CLI commands
NULLCLAW RUNTIME
The High-Performance Autonomous AI Agent Runtime
Zero-dependency, single-binary execution engine for autonomous AI agents. Features integrated providers, tools, memory, and a multi-channel gateway — everything you need to run agents locally or deploy them to production. Part of the NullHub ecosystem.
0
external dependencies
Zig
single-binary, zero GC
Terminal + Web
dual operator surface
Core Capabilities
CORE Providers
Universal Model Multiplexer
High-throughput model abstraction layer supporting OpenRouter, OpenAI-compatible APIs, and custom local or remote endpoints.
- Automatic model discovery and selection
- Streaming and non-streaming completions
- Key rotation and rate limit handling
CORE Tools
Tool Execution Engine
Securely execute shell commands, file operations, and custom scripts with robust approval policies and strict sandboxing constraints.
- Built-in file, shell, and search tools
- Configurable auto-approve and deny lists
- Execution timeout and resource controls
CORE Channels
Communication Channels
Terminal, WebSocket, and headless gateway modes for seamless integration into any operational context or external infrastructure.
- Terminal mode for local interactive sessions
- WebChannel v1 protocol for browser clients
- Gateway mode for headless worker execution
CORE Memory
Context & Memory
Advanced conversation history, state persistence, and automatic context window optimization for long-running, multi-turn agent threads.
- Auto-compacting context windows
- Session save/restore across restarts
- Structured memory for tool outputs
When To Use NullClaw
Interactive Agent Sessions
Ideal for single-agent workflows where a dedicated assistant handles complex, multi-step tasks end-to-end.
Launch NullClaw in terminal mode to refactor code, execute tests, and open PRs interactively with human-in-the-loop oversight.
Headless Worker Execution
Ideal for automated background pipelines where agents execute autonomously without human supervision.
Deploy NullClaw in gateway mode and dispatch automated task assignments directly from an orchestrator like NullBoiler.
Browser-Based Operation
Ideal for teams requiring a comprehensive visual operator dashboard.
Pair NullClaw with the NullHub Ecosystem for real-time streaming, tool execution timelines, and visual human-in-the-loop approvals.
Quick Start
# Clone and build
git clone https://github.com/nullclaw/nullclaw.git
cd nullclaw
zig build -Doptimize=ReleaseSmall
# Onboard a provider
./zig-out/bin/nullclaw onboard --provider openrouter --api-key <YOUR_KEY>
# Start an interactive agent session
./zig-out/bin/nullclaw agent -m "hello from nullclaw"
# Or use NullHub to install everything at once:
# https://nullhub.io