NanoClaw Templates

Prebuilt agent templates for NanoClaw, an AI assistant that runs agents securely in their own containers.

A template is an Agent Plugins directory you can stamp into a working NanoClaw agent. It carries the agent’s standing instructions, its MCP tool servers, its skills, and optional recurring tasks, but no secrets and no provider. Templates are provider-neutral; you pick the runtime separately, so one template works on any provider. Point ncl at one and you get a configured agent group in seconds — and because the format is the vendor-neutral plugin standard, the portable parts load in any other spec-compatible client too.

New to NanoClaw? Start at the main repo or docs.nanoclaw.dev.

Using a template

There are two ways to stamp an agent from a template.

1. During install. Running the NanoClaw installer (bash nanoclaw.sh) opens a setup wizard with two template choices: NanoClaw template library clones this repo and copies the template you pick into your local templates/, and Local templates lists what is already in templates/. It then stamps and wires your first agent.

2. Anytime, via the CLI:

ncl groups create --template sales/sdr --name "SDR Agent"

--template is a path relative to your local templates directory (templates/ by default, or NANOCLAW_TEMPLATES_DIR, a local path only). Refs are multi-segment, e.g. sales/sdr resolves to templates/sales/sdr. For safety, absolute paths, a leading ~, and ../ escapes are rejected.

To use a template from this repo, get it into your local templates/ first. The install wizard’s NanoClaw template library option clones this repo and copies the template you pick into templates/ for you; or copy the folder by hand. Then stamp it with its bare ref.

--name is optional; without it the agent group is named after the template folder.

Repository layout

Templates live under a category folder, one folder per template:

//

For example:

sales/
└── sdr/        # Sales Development Representative agent

That sales/sdr path is exactly what you pass to --template.

Anatomy of a template

A template is an Agent Plugins 1.0.0 directory. The portable surface (skills, MCP servers) follows the spec exactly, and everything NanoClaw-specific rides in the ai.nanoco.nanoclaw/ extension directory and manifest key, which other plugin clients skip by rule. A template from this registry is a fully conformant plugin: dropped into another spec-compatible client, its skills and MCP servers load, and the NanoClaw extras are ignored. The reverse also holds: NanoClaw stamps any conformant plugin, with the NanoClaw-only slots simply left empty.

/