Installation

Clawdius can be installed in several ways depending on your platform and preferences.

Quick Install

Linux and macOS

curl -fsSL https://clawdius.dev/install.sh | sh

Windows (PowerShell)

irm https://clawdius.dev/install.ps1 | iex

Package Managers

Homebrew (macOS/Linux)

brew tap clawdius/tap
brew install clawdius

Cargo (All Platforms)

cargo install clawdius

Arch Linux (AUR)

yay -S clawdius-bin
# Or build from source:
yay -S clawdius-git

Nix

# Using nixpkgs
nix-env -iA nixpkgs.clawdius

# Using flake
nix profile install github:WyattAu/clawdius

Pre-built Binaries

Download pre-built binaries from GitHub Releases:

PlatformArchitectureDownload
Linuxx86_64clawdius-linux-x86_64.tar.gz
Linuxaarch64clawdius-linux-aarch64.tar.gz
macOSx86_64clawdius-darwin-x86_64.tar.gz
macOSaarch64clawdius-darwin-aarch64.tar.gz
Windowsx86_64clawdius-windows-x86_64.zip

Manual Installation

# Download and extract
curl -LO https://github.com/WyattAu/clawdius/releases/download/v1.0.0/clawdius-linux-x86_64.tar.gz
tar xzf clawdius-linux-x86_64.tar.gz

# Move to PATH
sudo mv clawdius /usr/local/bin/

# Verify installation
clawdius --version

Build from Source

Prerequisites

  • Rust 1.75+ (recommended: latest stable)
  • C compiler (gcc, clang, or MSVC)
  • pkg-config (Linux)

Build Steps

# Clone the repository
git clone https://github.com/WyattAu/clawdius.git
cd clawdius

# Build release binary
cargo build --release

# Install locally
cargo install --path crates/clawdius

# Or copy binary manually
cp target/release/clawdius /usr/local/bin/

Build Features

Clawdius supports optional features:

# Enable all features
cargo build --release --all-features

# Enable only enterprise features
cargo build --release --features enterprise

# Minimal build (no plugins, basic sandbox)
cargo build --release --no-default-features
FeatureDescription
defaultCore features, WASM sandbox, basic tools
enterpriseSSO, audit logging, compliance
pluginsPlugin system with WASM runtime
all-sandboxesAll 7 sandbox backends
self-hostedSelf-hosted LLM support

Docker

# Pull official image
docker pull clawdius/clawdius:latest

# Run with current directory mounted
docker run -it --rm \
  -v $(pwd):/workspace \
  -v ~/.config/clawdius:/root/.config/clawdius \
  clawdius/clawdius:latest chat

Docker Compose

version: '3.8'
services:
  clawdius:
    image: clawdius/clawdius:latest
    volumes:
      - ./:/workspace
      - clawdius-config:/root/.config/clawdius
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
volumes:
  clawdius-config:

Verification

After installation, verify everything works:

# Check version
clawdius --version

# Run the interactive setup wizard (recommended for first-time users)
clawdius setup

# Or run diagnostics
clawdius doctor

# Quick test (requires API key)
clawdius chat --message "Hello, Clawdius!"

First-Time Setup

New in v1.2.0: Use the interactive setup wizard to configure Clawdius:

clawdius setup

The wizard will guide you through:

  1. Provider Selection - Choose your LLM provider (Anthropic, OpenAI, Ollama, Zhipu AI)
  2. API Key Configuration - Enter and securely store your API key
  3. Settings Preset - Choose a configuration preset:
    • Balanced: Good defaults for most users
    • Security: Maximum sandboxing and audit logging
    • Performance: Optimized for speed
    • Development: Verbose logging and debugging features

Quick Setup Options

# Skip welcome screen
clawdius setup --quick

# Pre-select provider
clawdius setup --provider anthropic
clawdius setup --provider ollama  # For local LLMs

Shell Completion

Enable shell completion for your shell:

Bash

clawdius completion bash > /etc/bash_completion.d/clawdius
# Or for user-only:
clawdius completion bash > ~/.local/share/bash-completion/completions/clawdius

Zsh

clawdius completion zsh > "${fpath[1]}/_clawdius"

Fish

clawdius completion fish > ~/.config/fish/completions/clawdius.fish

PowerShell

clawdius completion powershell | Out-String | Invoke-Expression

Next Steps