clawlets

Clawlets

Clawlets is an unofficial clawdbot server provisioner for made for hetzner.

Official Templates

• Looking for official AWS Deploy? clawdbot/clawdinators
• Clawdbot nix-clawdbot

🚨🚨 Use at your own risk! This project is under active development and not production-ready. You absolutely need to know what you're doing before deploying this. Misconfiguration can expose credentials, open security holes, or cause data loss.

Features

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

Quickstart

Read Quickstart Guide to get started.

Documentation

• Start here: docs/README.md
• Overview – Mental model + lifecycle.
• CLI Cookbook – Common commands and patterns.
• Config Reference – fleet/clawlets.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

Clawlets 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