Providers

ElasticClaw supports pluggable VM providers. The primary supported provider is Replicated CMX.

Supported Providers

Replicated CMXSupported

Cloud-hosted VM infrastructure via Replicated's Compatibility Matrix (CMX). Recommended for production.

Local (Docker)Experimental

Run agent containers locally using Docker. Good for development and testing.

CustomPlanned

Bring your own VM provider via the provider interface. AWS, GCP, Hetzner, etc.

Replicated CMX Setup

  1. Sign up at vendor.replicated.com
  2. Create an application and navigate to Compatibility Matrix
  3. Generate a CMX API token from your account settings
  4. Note your cluster/app slug
bash
export REPLICATED_API_TOKEN=your-token-here

Configure in hub.yaml:

yaml
provider:
  type: replicated-cmx
  endpoint: https://api.replicated.com
  token: ${REPLICATED_API_TOKEN}
  app_slug: my-elasticclaw-app   # your Replicated app slug

defaults:
  instance_type: r1.small        # CMX instance type
  region: us-east-1
  ttl: 24h                       # auto-destroy after 24 hours

Instance Types (CMX)

TypeCPURAMUse case
r1.nano12GBLightweight agents
r1.small24GBGeneral purpose
r1.medium48GBBuild-heavy workloads
r1.large816GBData-intensive agents
TTL-based auto-destroy helps control costs. Set a reasonable TTL in your defaults and override per-agent with elasticclaw create --ttl 4h.