Clawdlets

Clawdlets is the hetzner infrastructure companion for clawdbot and nix-clawdbot. It provides the tooling to deploy and manage secure, reproducible bot fleets on Hetzner Cloud using NixOS. The infra template lives in regenrek/clawdlets-template; this repo is the CLI + docs.

🚧 Under construction: Don't use this as it is. Its currently WIP and only for advanced users.

Looking for official AWS Deploy? clawdbot/clawdinators

Features

• Discord bot fleet – deploy multiple bots from one repo.
• Secure by default – WireGuard/Tailscale, lockdown, sops/age secrets.
• Hetzner + NixOS – immutable infra + reproducible deploys.
• CLI-first – bootstrap, deploy, ops, troubleshooting.
• Atomic updates – rollbacks via NixOS generations.

Quickstart

Ready to ship? Check out the Quickstart Guide to get your fleet running in minutes.

Local hooks (recommended)

• Install git hooks: nix run nixpkgs#lefthook -- install -f
• Policy is in .forbidden-paths.regex (blocks committing local runtime + credential files).
• Manual gate before PR/release: pnpm gate

Ask an agent (copy/paste prompt)

clawdlets project init --dir ~/projects/clawdlets-project
cd ~/projects/clawdlets-project

Now start Codex/Claude and tell it
read @AGENT-BOOTSTRAP-SERVER.md and help me setup my own clawdlets hetzner server

Documentation

• Start here: docs/README.md
• Overview – Mental model + lifecycle.
• CLI Cookbook – Common commands and patterns.
• Config Reference – fleet/clawdlets.json reference.
• Installation Guide – Prerequisites and setup.
• Deployment & Updates – How to ship changes.
• Agent Configuration – Routing, skills, and workspaces.
• Secrets Management – Handling keys safely with sops/age.
• Security Model – Threat model + boundaries.
• Operations Manual – Day-to-day maintenance.
• Troubleshooting – Common failures and fixes.
• Going Public – Checklist for OSS-safe publishing.
• Upstream & Tracking – Keeping your fork in sync.

Powered By

Clawdlets is strictly an infrastructure wrapper. All credit for the AI assistant and Nix packaging goes to the core projects:

• nix-clawdbot by joshp123
• clawdbot by steipete

License

MIT

Find me

@kevinkernx