claw — NanoClaw CLI

claw is a Python CLI that sends prompts directly to a NanoClaw agent container from the terminal. It reads registered groups from the NanoClaw database, picks up secrets from .env, and pipes a JSON payload into a container run — no chat app required.

What it does

• Send a prompt to any registered group by name, folder, or JID
• Default target is the main group (no -g needed for most use)
• Resume a previous session with -s <session-id>
• Read prompts from stdin (--pipe) for scripting and piping
• List all registered groups with --list-groups
• Auto-detects container or docker runtime (or override with --runtime)
• Prints the agent's response to stdout; session ID to stderr
• Verbose mode (-v) shows the command, redacted payload, and exit code

Prerequisites

• Python 3.8 or later
• NanoClaw installed with a built and tagged container image (nanoclaw-agent:latest)