Installation

Install the elasticclaw CLI on macOS, Linux, or via direct binary download.

Homebrew (macOS & Linux)

The recommended install method:

bash

brew tap elasticclaw/elasticclaw
brew install elasticclaw

Upgrade to the latest version:

bash

brew upgrade elasticclaw

Binary Download

Download a pre-built binary from the GitHub Releases page.

bash

# macOS (arm64)
curl -L https://github.com/elasticclaw/elasticclaw/releases/latest/download/elasticclaw_darwin_arm64.tar.gz | tar xz
sudo mv elasticclaw /usr/local/bin/

# Linux (amd64)
curl -L https://github.com/elasticclaw/elasticclaw/releases/latest/download/elasticclaw_linux_amd64.tar.gz | tar xz
sudo mv elasticclaw /usr/local/bin/

Verify Installation

bash

elasticclaw --version
# elasticclaw v0.1.0

Initial Setup

After installing, initialize your hub config:

bash

elasticclaw init

This creates a hub.yaml in your current directory. See Hub Config for details.

You'll need a provider account (e.g., Replicated CMX) to actually provision VMs. See Providers for setup.

Agent & Script Install (Linux)

For non-interactive environments — agents, CI, remote servers:

bash

curl -fsSL https://elasticclaw.ai/install | bash

With options via environment variables:

bash

ELASTICCLAW_PUBLIC_URL=https://my-server.example.com   curl -fsSL https://elasticclaw.ai/install | bash

The install script downloads the right binary, writes ~/.elasticclaw/hub.yaml, and prints connection details. No interactive prompts — fully scriptable.

Supported environment variables:

bash

ELASTICCLAW_PUBLIC_URL   # Public URL for this hub
ELASTICCLAW_TOKEN        # User API token (auto-generated if unset)
ELASTICCLAW_CLAW_TOKEN   # Claw auth token (auto-generated if unset)
ELASTICCLAW_VERSION      # Pin a release version (default: latest)

Initialize Hub Config Only

Generate a hub.yaml without running the full install script:

bash

elasticclaw hub init

With a public URL:

bash

elasticclaw hub init --public-url https://my-server.example.com

Print to stdout without writing (useful for piping or inspection):

bash

elasticclaw hub init --print