nix-openclaw-tools

Reproducible OpenClaw tool packaging.

Nix packaging for OpenClaw-adjacent tools, with per-tool OpenClaw plugin metadata. Part of the nix-openclaw ecosystem.

Darwin/aarch64 plus Linux (x86_64/aarch64) for tools that ship Linux builds. On Linux, summarize is built from source (Node 22 + pnpm) since upstream only ships a macOS Bun binary.

Why this exists

OpenClaw should have a small default toolchain and explicit optional plugins. Packaging these tools as Nix flakes with OpenClaw plugin metadata means:

• Reproducible: Pinned versions, no Homebrew drift
• Declarative: Add a plugin, home-manager switch, done
• Fresh: CI keeps tools and skills at latest automatically
• Integrated: Skills teach your bot how to use each tool

Pure Nix and Home Manager design

This repo is meant to be consumable directly from Nix flakes, Darwin, and Home Manager configs. Packages should stay pinned and reproducible, and optional Home Manager modules should expose normal programs.<name> options instead of requiring downstream users to hand-write app bundle or launchd glue.

For macOS app bundles, prefer a Nix package plus Home Manager integration. Home Manager can expose app bundles from home.packages through its Darwin app targets, and modules can opt into launchd.agents when Home Manager should own startup. Homebrew casks are still useful, but they belong in a nix-darwin Homebrew configuration, not in these pure Nix package/module definitions.

What's included

Tool	What it does
summarize	Link → clean text → summary
discrawl	Mirror Discord into SQLite and search history locally
wacrawl	Read-only local archive and search for WhatsApp Desktop data
gogcli	Google CLI for Gmail, Calendar, Drive, and Contacts
goplaces	Google Places API (New) CLI
camsnap	Capture snapshots/clips from RTSP/ONVIF cameras
sonoscli	Control Sonos speakers
peekaboo	Lightning-fast macOS screenshots & AI vision analysis
poltergeist	Universal file watcher with auto-rebuild
sag	Command-line ElevenLabs TTS with mac-style flags
imsg	iMessage/SMS CLI

Usage (as openclaw plugins)

Each tool is a subflake under tools/<tool>/ exporting openclawPlugin. Point your nix-openclaw config at the tool you want:

programs.openclaw.plugins = [
  { source = "github:openclaw/nix-openclaw-tools?dir=tools/camsnap"; }
  { source = "github:openclaw/nix-openclaw-tools?dir=tools/discrawl"; }
  { source = "github:openclaw/nix-openclaw-tools?dir=tools/peekaboo"; }
  { source = "github:openclaw/nix-openclaw-tools?dir=tools/summarize"; }
  { source = "github:openclaw/nix-openclaw-tools?dir=tools/wacrawl"; }
];

Each plugin bundles:

• The tool binary (on PATH)
• A skill (SKILL.md) so your bot knows how to use it
• Any required state dirs / env declarations

Usage (packages only)

If you just want the binaries without the plugin wrapper:

inputs.nix-openclaw-tools.url = "github:openclaw/nix-openclaw-tools";

# Then use:
inputs.nix-openclaw-tools.packages.aarch64-darwin.camsnap
inputs.nix-openclaw-tools.packages.aarch64-darwin.discrawl
inputs.nix-openclaw-tools.packages.aarch64-darwin.peekaboo
inputs.nix-openclaw-tools.packages.aarch64-darwin.wacrawl
# etc.

# Linux examples:
inputs.nix-openclaw-tools.packages.x86_64-linux.camsnap
inputs.nix-openclaw-tools.packages.x86_64-linux.discrawl
inputs.nix-openclaw-tools.packages.aarch64-linux.gogcli
inputs.nix-openclaw-tools.packages.x86_64-linux.summarize
inputs.nix-openclaw-tools.packages.x86_64-linux.wacrawl

Skills syncing

Skills are vendored from openclaw/openclaw main branch. No pinning - we track latest.

go run ./cmd/sync-skills

Pulls latest main via sparse checkout, only updates files when contents actually change.

Tool updates

Tools track upstream GitHub releases directly (not Homebrew).

go run ./cmd/update-tools

Fetches latest release versions/URLs/hashes and updates the Nix expressions.

CI

Workflow	Schedule	What it does
sync-skills	Every 30 min	Pulls latest skills from openclaw main
update-tools	Every 10 min	Checks for new tool releases
Garnix	On push	Builds all packages via checks.* (darwin + linux)

Automation commits directly when versions or skills change.

License

Tools are packaged as-is from upstream. See individual tool repos for their licenses.

Nix packaging: MIT