Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

CLI

Commands

Initialize configuration

Set up clawzero interactively — select providers, configure API keys, choose a default model, and optionally set up gateways. Generates ~/.config/clawzero/config.toml:

clawzero init

The interactive wizard guides you through:

  1. Provider selection — Choose from Anthropic, OpenAI, OpenRouter, Ollama (local), Vertex AI (Google Cloud), and Bedrock (AWS)
  2. Per-provider configuration — API keys (masked input), base URLs, regions, and project IDs as needed
  3. Default model selection — Pick from models available in your selected providers
  4. Gateway configuration (optional) — Set up Slack, Discord, or WebUI bot gateways

If an API key is left empty, the config will reference the corresponding environment variable (e.g. ANTHROPIC_API_KEY) instead.

One-shot mode

Send a prompt, get a response, and exit:

clawzero "Write a fibonacci function in Rust"

Interactive chat

Start an interactive REPL session:

clawzero chat

Model selection

Override the default model with --model:

clawzero --model openai/gpt-4o "Hello"
clawzero --model ollama/llama3 chat

The model format is provider/model-name. You can also set the default via the CLAWZERO_MODEL environment variable or in your config file.

Show config

Display the current configuration:

clawzero config

Session management

# List all sessions
clawzero sessions list

# Resume a session (subcommand)
clawzero sessions resume <session-id>

# Resume a session (flag — works with any command)
clawzero --resume <session-id> "Continue from where we left off"

See Session Management for details.

Gateway

Start platform bots:

# Start all configured gateways
clawzero gateway

# Start a specific platform
clawzero gateway slack
clawzero gateway discord
clawzero gateway webui

See Gateway Overview for details.

Global flags

FlagDescription
--model <provider/model>Override default model
--resume <session-id>Resume an existing session
--no-tuiDisable TUI, use plain text mode
--versionShow version
--helpShow help