Quick Start

Get AI agents running on your own cloud infrastructure in minutes.

1. Install

npm install -g clawup

2. Check Prerequisites

Make sure you have the required tools installed:

Node.js 18+
Pulumi CLI — Install guide
AWS CLI — if deploying to AWS (Install guide)
Tailscale — installed and connected to your tailnet (Install guide)

Run clawup validate after deployment to verify all agents are healthy.

3. Create or Discover Identities

If you don’t have identities yet, scaffold one with army-create:

npx army-create

Then initialize your deployment:

clawup init

Discovers local identity directories and generates a clawup.yaml manifest and .env.example with sensible defaults (AWS, us-east-1).

4. Edit Your Config

Open clawup.yaml and customize:

stackName — unique deployment name (e.g., dev, prod)
provider — aws or hetzner
region — where to deploy
instanceType — server size
ownerName, timezone, workingHours — your info
agents — add, remove, or modify agents

5. Fill in Secrets

cp .env.example .env

Open .env and fill in your API keys (Anthropic, Tailscale, etc.).

6. Deploy

clawup deploy

Validates all secrets, configures Pulumi, and provisions your agents — dedicated servers, persistent storage, networking, and bootstrap with all integrations. If any secrets are missing, it prints exactly what’s needed.

First deployment takes 3-5 minutes. Subsequent deployments are incremental.

7. Connect

# Check status
clawup status

# SSH to an agent
clawup ssh <agent-name>

# Validate health
clawup validate

What’s Next?

CLI Reference — Full command documentation
Configuration — Customize your manifest
Identities — Understand the identity system
Architecture — How provisioning works
Cost Estimates — Pricing by provider

Getting Started

Agents

Integrations

Configuration

Guides

Community

1. Install

2. Check Prerequisites

3. Create or Discover Identities

4. Edit Your Config

5. Fill in Secrets

6. Deploy

7. Connect

What’s Next?

​1. Install

​2. Check Prerequisites

​3. Create or Discover Identities

​4. Edit Your Config

​5. Fill in Secrets

​6. Deploy

​7. Connect

​What’s Next?

1. Install

2. Check Prerequisites

3. Create or Discover Identities

4. Edit Your Config

5. Fill in Secrets

6. Deploy

7. Connect

What’s Next?