CLI Reference
ZeptoClaw uses a subcommand-based CLI built with clap.
Global options
Section titled “Global options”zeptoclaw [OPTIONS] <COMMAND>| Option | Description |
|---|---|
--help | Show help message |
--version | Show version |
Run a single agent interaction.
zeptoclaw agent [OPTIONS] -m <MESSAGE>| Option | Description |
|---|---|
-m, --message <TEXT> | Message to send to the agent |
--stream | Enable streaming (token-by-token output) |
--template <NAME> | Use an agent template (coder, researcher, writer, analyst) |
--workspace <PATH> | Set workspace directory |
Examples
Section titled “Examples”# Simple messagezeptoclaw agent -m "Hello"
# With streamingzeptoclaw agent --stream -m "Explain async Rust"
# With templatezeptoclaw agent --template coder -m "Write a CSV parser"gateway
Section titled “gateway”Start the multi-channel gateway.
zeptoclaw gateway [OPTIONS]| Option | Description |
|---|---|
--containerized [RUNTIME] | Enable container isolation (auto, docker, apple) |
--tunnel [PROVIDER] | Enable tunnel (auto, cloudflare, ngrok, tailscale) |
Examples
Section titled “Examples”# Start gatewayzeptoclaw gateway
# With container isolationzeptoclaw gateway --containerized dockerProcess multiple prompts from a file.
zeptoclaw batch [OPTIONS] --input <FILE>| Option | Description |
|---|---|
--input <FILE> | Input file (text or JSONL) |
--output <FILE> | Output file (default: stdout) |
--format <FORMAT> | Output format: text, jsonl |
--template <NAME> | Agent template to use |
--stream | Enable streaming per prompt |
--stop-on-error | Stop on first error |
Examples
Section titled “Examples”# Process text filezeptoclaw batch --input prompts.txt
# JSONL outputzeptoclaw batch --input prompts.txt --format jsonl --output results.jsonl
# With template and error handlingzeptoclaw batch --input prompts.jsonl --template researcher --stop-on-errorconfig check
Section titled “config check”Validate configuration file.
zeptoclaw config checkReports unknown fields, missing required values, and type errors.
history
Section titled “history”Manage conversation history.
zeptoclaw history <SUBCOMMAND>history list
Section titled “history list”zeptoclaw history list [--limit <N>]List recent sessions with timestamps and titles.
history show
Section titled “history show”zeptoclaw history show <QUERY>Show a session by fuzzy-matching the query against session titles and keys.
history cleanup
Section titled “history cleanup”zeptoclaw history cleanup [--keep <N>]Remove old sessions, keeping the most recent N (default: 50).
template
Section titled “template”Manage agent templates.
zeptoclaw template <SUBCOMMAND>template list
Section titled “template list”List all available templates (built-in and custom).
template show
Section titled “template show”zeptoclaw template show <NAME>Show template details including system prompt, model, and overrides.
onboard
Section titled “onboard”Run the interactive setup wizard.
zeptoclaw onboard [OPTIONS]| Option | Description |
|---|---|
--full | Run the full 10-step wizard instead of express setup |
Walks through provider key setup, channel configuration, and workspace initialization.
heartbeat
Section titled “heartbeat”View heartbeat service status.
zeptoclaw heartbeat --showskills
Section titled “skills”Manage agent skills.
zeptoclaw skills listList available skills from ~/.zeptoclaw/skills/.
secrets
Section titled “secrets”Manage secret encryption at rest.
zeptoclaw secrets <SUBCOMMAND>secrets encrypt
Section titled “secrets encrypt”Encrypt plaintext API keys and tokens in your config file using XChaCha20-Poly1305.
zeptoclaw secrets encryptsecrets decrypt
Section titled “secrets decrypt”Decrypt secrets for editing.
zeptoclaw secrets decryptsecrets rotate
Section titled “secrets rotate”Re-encrypt with a new master key.
zeptoclaw secrets rotatememory
Section titled “memory”Manage long-term memory from the CLI.
zeptoclaw memory <SUBCOMMAND>memory list
Section titled “memory list”zeptoclaw memory list [--category <CATEGORY>]memory search
Section titled “memory search”zeptoclaw memory search <QUERY>memory set
Section titled “memory set”zeptoclaw memory set <KEY> <VALUE> [--category <CATEGORY>] [--tags <TAGS>]memory delete
Section titled “memory delete”zeptoclaw memory delete <KEY>memory stats
Section titled “memory stats”zeptoclaw memory statsDiscover available tools.
zeptoclaw tools <SUBCOMMAND>tools list
Section titled “tools list”List all available tools and their status.
zeptoclaw tools listtools info
Section titled “tools info”Show detailed info about a specific tool.
zeptoclaw tools info <NAME>Monitor a URL for changes.
zeptoclaw watch <URL> [OPTIONS]| Option | Description |
|---|---|
--interval <DURATION> | Check interval (e.g., 1h, 30m) |
--notify <CHANNEL> | Channel for notifications |
channel
Section titled “channel”Manage channels.
zeptoclaw channel <SUBCOMMAND>channel list
Section titled “channel list”zeptoclaw channel listchannel setup
Section titled “channel setup”zeptoclaw channel setup <NAME>channel test
Section titled “channel test”zeptoclaw channel test <NAME>migrate
Section titled “migrate”Import config and skills from an OpenClaw installation.
zeptoclaw migrate [OPTIONS]| Option | Description |
|---|---|
--from <PATH> | Path to OpenClaw installation |
--dry-run | Preview migration without writing files |
--yes | Non-interactive (skip prompts) |