diff --git a/README.md b/README.md
index b1826c3d..b36faa61 100644
--- a/README.md
+++ b/README.md
@@ -180,3 +180,57 @@ OPENROUTER_API_KEY=sk-or-v1-xxxxx \
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
- `DO_DROPLET_SIZE` - Droplet size (default: `s-2vcpu-2gb`)
- `DO_REGION` - Datacenter region (default: `nyc3`)
+
+---
+
+## Vultr
+
+Spawn agents on [Vultr](https://www.vultr.com/) Cloud Compute instances via REST API.
+
+### Usage
+
+#### Claude Code
+
+```bash
+bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/claude.sh)
+```
+
+#### OpenClaw
+
+```bash
+bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/openclaw.sh)
+```
+
+#### NanoClaw
+
+```bash
+bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/nanoclaw.sh)
+```
+
+#### Aider
+
+```bash
+bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/aider.sh)
+```
+
+#### Goose
+
+```bash
+bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/goose.sh)
+```
+
+### Non-Interactive Mode
+
+```bash
+VULTR_SERVER_NAME=dev-mk1 \
+VULTR_API_KEY=your-vultr-api-key \
+OPENROUTER_API_KEY=sk-or-v1-xxxxx \
+ bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/claude.sh)
+```
+
+**Environment Variables:**
+- `VULTR_SERVER_NAME` - Name for the instance (skips prompt)
+- `VULTR_API_KEY` - Vultr API key (skips prompt, saved to `~/.config/spawn/vultr.json`)
+- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
+- `VULTR_PLAN` - Instance plan (default: `vc2-1c-2gb`)
+- `VULTR_REGION` - Datacenter region (default: `ewr`)
diff --git a/manifest.json b/manifest.json
index 001ec34b..ac1e3fa2 100644
--- a/manifest.json
+++ b/manifest.json
@@ -136,6 +136,21 @@
"region": "nyc3",
"image": "ubuntu-24-04-x64"
}
+ },
+ "vultr": {
+ "name": "Vultr",
+ "description": "Vultr Cloud Compute instances via REST API",
+ "url": "https://www.vultr.com/",
+ "type": "api",
+ "auth": "VULTR_API_KEY",
+ "provision_method": "POST /v2/instances with user_data (base64)",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "plan": "vc2-1c-2gb",
+ "region": "ewr",
+ "os_id": 2284
+ }
}
},
"matrix": {
@@ -153,6 +168,11 @@
"digitalocean/aider": "implemented",
"sprite/goose": "implemented",
"hetzner/goose": "implemented",
- "digitalocean/goose": "implemented"
+ "digitalocean/goose": "implemented",
+ "vultr/claude": "implemented",
+ "vultr/openclaw": "implemented",
+ "vultr/nanoclaw": "implemented",
+ "vultr/aider": "implemented",
+ "vultr/goose": "implemented"
}
}
diff --git a/vultr/aider.sh b/vultr/aider.sh
new file mode 100755
index 00000000..372489e0
--- /dev/null
+++ b/vultr/aider.sh
@@ -0,0 +1,57 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+if [[ -f "$SCRIPT_DIR/lib/common.sh" ]]; then
+ source "$SCRIPT_DIR/lib/common.sh"
+else
+ source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/vultr/lib/common.sh)
+fi
+
+log_info "Aider on Vultr"
+echo ""
+
+ensure_vultr_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "$SERVER_NAME"
+verify_server_connectivity "$VULTR_SERVER_IP"
+wait_for_cloud_init "$VULTR_SERVER_IP"
+
+log_warn "Installing Aider..."
+run_server "$VULTR_SERVER_IP" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "$OPENROUTER_API_KEY" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+echo ""
+log_warn "Browse models at: https://openrouter.ai/models"
+MODEL_ID=$(safe_read "Enter model ID [openrouter/auto]: ") || MODEL_ID=""
+MODEL_ID="${MODEL_ID:-openrouter/auto}"
+
+log_warn "Setting up environment variables..."
+ENV_TEMP=$(mktemp)
+cat > "$ENV_TEMP" << EOF
+
+# [spawn:env]
+export OPENROUTER_API_KEY="${OPENROUTER_API_KEY}"
+EOF
+upload_file "$VULTR_SERVER_IP" "$ENV_TEMP" "/tmp/env_config"
+run_server "$VULTR_SERVER_IP" "cat /tmp/env_config >> ~/.zshrc && rm /tmp/env_config"
+rm "$ENV_TEMP"
+
+echo ""
+log_info "Vultr instance setup completed successfully!"
+log_info "Server: $SERVER_NAME (ID: $VULTR_SERVER_ID, IP: $VULTR_SERVER_IP)"
+echo ""
+
+log_warn "Starting Aider..."
+sleep 1
+clear
+interactive_session "$VULTR_SERVER_IP" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"
diff --git a/vultr/claude.sh b/vultr/claude.sh
new file mode 100755
index 00000000..9ea22e47
--- /dev/null
+++ b/vultr/claude.sh
@@ -0,0 +1,94 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+if [[ -f "$SCRIPT_DIR/lib/common.sh" ]]; then
+ source "$SCRIPT_DIR/lib/common.sh"
+else
+ source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/vultr/lib/common.sh)
+fi
+
+log_info "Claude Code on Vultr"
+echo ""
+
+ensure_vultr_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "$SERVER_NAME"
+verify_server_connectivity "$VULTR_SERVER_IP"
+wait_for_cloud_init "$VULTR_SERVER_IP"
+
+log_warn "Verifying Claude Code installation..."
+if ! run_server "$VULTR_SERVER_IP" "command -v claude" >/dev/null 2>&1; then
+ log_warn "Claude Code not found, installing manually..."
+ run_server "$VULTR_SERVER_IP" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "$OPENROUTER_API_KEY" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_warn "Setting up environment variables..."
+ENV_TEMP=$(mktemp)
+cat > "$ENV_TEMP" << EOF
+
+# [spawn:env]
+export OPENROUTER_API_KEY="${OPENROUTER_API_KEY}"
+export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
+export ANTHROPIC_AUTH_TOKEN="${OPENROUTER_API_KEY}"
+export ANTHROPIC_API_KEY=""
+export CLAUDE_CODE_SKIP_ONBOARDING="1"
+export CLAUDE_CODE_ENABLE_TELEMETRY="0"
+EOF
+upload_file "$VULTR_SERVER_IP" "$ENV_TEMP" "/tmp/env_config"
+run_server "$VULTR_SERVER_IP" "cat /tmp/env_config >> ~/.zshrc && rm /tmp/env_config"
+rm "$ENV_TEMP"
+
+log_warn "Configuring Claude Code..."
+run_server "$VULTR_SERVER_IP" "mkdir -p ~/.claude"
+
+SETTINGS_TEMP=$(mktemp)
+cat > "$SETTINGS_TEMP" << EOF
+{
+ "theme": "dark",
+ "editor": "vim",
+ "env": {
+ "CLAUDE_CODE_ENABLE_TELEMETRY": "0",
+ "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
+ "ANTHROPIC_AUTH_TOKEN": "${OPENROUTER_API_KEY}"
+ },
+ "permissions": {
+ "defaultMode": "bypassPermissions",
+ "dangerouslySkipPermissions": true
+ }
+}
+EOF
+upload_file "$VULTR_SERVER_IP" "$SETTINGS_TEMP" "/root/.claude/settings.json"
+rm "$SETTINGS_TEMP"
+
+GLOBAL_STATE_TEMP=$(mktemp)
+cat > "$GLOBAL_STATE_TEMP" << EOF
+{
+ "hasCompletedOnboarding": true,
+ "bypassPermissionsModeAccepted": true
+}
+EOF
+upload_file "$VULTR_SERVER_IP" "$GLOBAL_STATE_TEMP" "/root/.claude.json"
+rm "$GLOBAL_STATE_TEMP"
+
+run_server "$VULTR_SERVER_IP" "touch ~/.claude/CLAUDE.md"
+
+echo ""
+log_info "Vultr instance setup completed successfully!"
+log_info "Server: $SERVER_NAME (ID: $VULTR_SERVER_ID, IP: $VULTR_SERVER_IP)"
+echo ""
+
+log_warn "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "$VULTR_SERVER_IP" "source ~/.zshrc && claude"
diff --git a/vultr/goose.sh b/vultr/goose.sh
new file mode 100755
index 00000000..189ff1ec
--- /dev/null
+++ b/vultr/goose.sh
@@ -0,0 +1,53 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+if [[ -f "$SCRIPT_DIR/lib/common.sh" ]]; then
+ source "$SCRIPT_DIR/lib/common.sh"
+else
+ source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/vultr/lib/common.sh)
+fi
+
+log_info "Goose on Vultr"
+echo ""
+
+ensure_vultr_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "$SERVER_NAME"
+verify_server_connectivity "$VULTR_SERVER_IP"
+wait_for_cloud_init "$VULTR_SERVER_IP"
+
+log_warn "Installing Goose..."
+run_server "$VULTR_SERVER_IP" "CONFIGURE=false curl -fsSL https://github.com/block/goose/releases/latest/download/download_cli.sh | bash"
+log_info "Goose installed"
+
+echo ""
+if [[ -n "$OPENROUTER_API_KEY" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_warn "Setting up environment variables..."
+ENV_TEMP=$(mktemp)
+cat > "$ENV_TEMP" << EOF
+
+# [spawn:env]
+export GOOSE_PROVIDER=openrouter
+export OPENROUTER_API_KEY="${OPENROUTER_API_KEY}"
+EOF
+upload_file "$VULTR_SERVER_IP" "$ENV_TEMP" "/tmp/env_config"
+run_server "$VULTR_SERVER_IP" "cat /tmp/env_config >> ~/.zshrc && rm /tmp/env_config"
+rm "$ENV_TEMP"
+
+echo ""
+log_info "Vultr instance setup completed successfully!"
+log_info "Server: $SERVER_NAME (ID: $VULTR_SERVER_ID, IP: $VULTR_SERVER_IP)"
+echo ""
+
+log_warn "Starting Goose..."
+sleep 1
+clear
+interactive_session "$VULTR_SERVER_IP" "source ~/.zshrc && goose"
diff --git a/vultr/lib/common.sh b/vultr/lib/common.sh
new file mode 100755
index 00000000..5d592234
--- /dev/null
+++ b/vultr/lib/common.sh
@@ -0,0 +1,421 @@
+#!/bin/bash
+# Common bash functions for Vultr spawn scripts
+
+# ============================================================
+# Provider-agnostic functions (shared with sprite/lib/common.sh)
+# ============================================================
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+log_info() { echo -e "${GREEN}$1${NC}" >&2; }
+log_warn() { echo -e "${YELLOW}$1${NC}" >&2; }
+log_error() { echo -e "${RED}$1${NC}" >&2; }
+
+safe_read() {
+ local prompt="$1"
+ local result=""
+ if [[ -t 0 ]]; then
+ read -p "$prompt" result
+ elif echo -n "" > /dev/tty 2>/dev/null; then
+ read -p "$prompt" result < /dev/tty
+ else
+ log_error "Cannot read input: no TTY available"
+ return 1
+ fi
+ echo "$result"
+}
+
+nc_listen() {
+ local port=$1; shift
+ if nc --help 2>&1 | grep -q "BusyBox\|busybox" || nc --help 2>&1 | grep -q "\-p "; then
+ nc -l -p "$port" "$@"
+ else
+ nc -l "$port" "$@"
+ fi
+}
+
+open_browser() {
+ local url=$1
+ if command -v termux-open-url &> /dev/null; then termux-open-url "$url" /dev/null; then open "$url" /dev/null; then xdg-open "$url" /dev/null; then
+ log_warn "netcat (nc) not found - OAuth server unavailable"
+ return 1
+ fi
+ local callback_url="http://localhost:${callback_port}/callback"
+ local auth_url="https://openrouter.ai/auth?callback_url=${callback_url}"
+ local oauth_dir=$(mktemp -d)
+ local code_file="$oauth_dir/code"
+ log_warn "Starting local OAuth server on port ${callback_port}..."
+ (
+ local success_response='HTTP/1.1 200 OK\r\nContent-Type: text/html\r\nConnection: close\r\n\r\n
Authentication Successful!
Redirecting back to terminal...
This tab will close automatically
'
+ while true; do
+ local response_file=$(mktemp)
+ echo -e "$success_response" > "$response_file"
+ local request=$(nc_listen "$callback_port" < "$response_file" 2>/dev/null | head -1)
+ local nc_status=$?
+ rm -f "$response_file"
+ if [[ $nc_status -ne 0 ]]; then break; fi
+ if [[ "$request" == *"/callback?code="* ]]; then
+ local code=$(echo "$request" | sed -n 's/.*code=\([^ &]*\).*/\1/p')
+ echo "$code" > "$code_file"
+ break
+ fi
+ done
+ ) /dev/null; then
+ log_warn "Failed to start OAuth server (port may be in use)"
+ rm -rf "$oauth_dir"
+ return 1
+ fi
+ log_warn "Opening browser to authenticate with OpenRouter..."
+ open_browser "$auth_url"
+ local timeout=120 elapsed=0
+ while [[ ! -f "$code_file" ]] && [[ $elapsed -lt $timeout ]]; do sleep 1; ((elapsed++)); done
+ kill $server_pid 2>/dev/null || true
+ wait $server_pid 2>/dev/null || true
+ if [[ ! -f "$code_file" ]]; then
+ log_warn "OAuth timeout - no response received"
+ rm -rf "$oauth_dir"
+ return 1
+ fi
+ local oauth_code=$(cat "$code_file")
+ rm -rf "$oauth_dir"
+ log_warn "Exchanging OAuth code for API key..."
+ local key_response=$(curl -s -X POST "https://openrouter.ai/api/v1/auth/keys" \
+ -H "Content-Type: application/json" -d "{\"code\": \"$oauth_code\"}")
+ local api_key=$(echo "$key_response" | grep -o '"key":"[^"]*"' | sed 's/"key":"//;s/"$//')
+ if [[ -z "$api_key" ]]; then
+ log_error "Failed to exchange OAuth code: ${key_response}"
+ return 1
+ fi
+ log_info "Successfully obtained OpenRouter API key via OAuth!"
+ echo "$api_key"
+}
+
+get_openrouter_api_key_oauth() {
+ local callback_port=${1:-5180}
+ local api_key=$(try_oauth_flow "$callback_port")
+ if [[ -n "$api_key" ]]; then echo "$api_key"; return 0; fi
+ echo ""
+ log_warn "OAuth authentication failed or unavailable"
+ log_warn "You can enter your API key manually instead"
+ echo ""
+ local manual_choice=$(safe_read "Would you like to enter your API key manually? (Y/n): ") || {
+ log_error "Cannot prompt for manual entry in non-interactive mode"
+ log_warn "Set OPENROUTER_API_KEY environment variable for non-interactive usage"
+ return 1
+ }
+ if [[ ! "$manual_choice" =~ ^[Nn]$ ]]; then
+ api_key=$(get_openrouter_api_key_manual)
+ echo "$api_key"; return 0
+ else
+ log_error "Authentication cancelled by user"; return 1
+ fi
+}
+
+# ============================================================
+# Vultr specific functions
+# ============================================================
+
+VULTR_API_BASE="https://api.vultr.com/v2"
+SSH_OPTS="-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -i $HOME/.ssh/id_ed25519"
+
+vultr_api() {
+ local method="$1"
+ local endpoint="$2"
+ local body="$3"
+ local args=(-s -X "$method" -H "Authorization: Bearer ${VULTR_API_KEY}" -H "Content-Type: application/json")
+ if [[ -n "$body" ]]; then args+=(-d "$body"); fi
+ curl "${args[@]}" "${VULTR_API_BASE}${endpoint}"
+}
+
+ensure_vultr_token() {
+ if [[ -n "$VULTR_API_KEY" ]]; then
+ log_info "Using Vultr API key from environment"
+ return 0
+ fi
+ local config_dir="$HOME/.config/spawn"
+ local config_file="$config_dir/vultr.json"
+ if [[ -f "$config_file" ]]; then
+ local saved_key=$(python3 -c "import json; print(json.load(open('$config_file')).get('api_key',''))" 2>/dev/null)
+ if [[ -n "$saved_key" ]]; then
+ export VULTR_API_KEY="$saved_key"
+ log_info "Using Vultr API key from $config_file"
+ return 0
+ fi
+ fi
+ echo ""
+ log_warn "Vultr API Key Required"
+ echo -e "${YELLOW}Get your API key from: https://my.vultr.com/settings/#settingsapi${NC}"
+ echo ""
+ local api_key=$(safe_read "Enter your Vultr API key: ") || return 1
+ if [[ -z "$api_key" ]]; then
+ log_error "API key is required"
+ return 1
+ fi
+ export VULTR_API_KEY="$api_key"
+ local test_response=$(vultr_api GET "/account")
+ if echo "$test_response" | grep -q '"account"'; then
+ log_info "API key validated"
+ else
+ log_error "Invalid API key"
+ unset VULTR_API_KEY
+ return 1
+ fi
+ mkdir -p "$config_dir"
+ cat > "$config_file" << EOF
+{
+ "api_key": "$api_key"
+}
+EOF
+ chmod 600 "$config_file"
+ log_info "API key saved to $config_file"
+}
+
+ensure_ssh_key() {
+ local key_path="$HOME/.ssh/id_ed25519"
+ local pub_path="${key_path}.pub"
+ if [[ ! -f "$key_path" ]]; then
+ log_warn "Generating SSH key..."
+ mkdir -p "$HOME/.ssh"
+ ssh-keygen -t ed25519 -f "$key_path" -N "" -q
+ log_info "SSH key generated at $key_path"
+ fi
+ local pub_key=$(cat "$pub_path")
+ local existing_keys=$(vultr_api GET "/ssh-keys")
+ local existing_fingerprint=$(ssh-keygen -lf "$pub_path" -E md5 2>/dev/null | awk '{print $2}' | sed 's/MD5://')
+ if echo "$existing_keys" | grep -q "$existing_fingerprint"; then
+ log_info "SSH key already registered with Vultr"
+ return 0
+ fi
+ log_warn "Registering SSH key with Vultr..."
+ local key_name="spawn-$(hostname)-$(date +%s)"
+ local json_pub_key=$(python3 -c "import json; print(json.dumps('$pub_key'))" 2>/dev/null || echo "\"$pub_key\"")
+ local register_body="{\"name\":\"$key_name\",\"ssh_key\":$json_pub_key}"
+ local register_response=$(vultr_api POST "/ssh-keys" "$register_body")
+ if echo "$register_response" | grep -q '"ssh_key"'; then
+ log_info "SSH key registered with Vultr"
+ else
+ log_error "Failed to register SSH key: $register_response"
+ return 1
+ fi
+}
+
+get_server_name() {
+ if [[ -n "$VULTR_SERVER_NAME" ]]; then
+ log_info "Using server name from environment: $VULTR_SERVER_NAME"
+ echo "$VULTR_SERVER_NAME"
+ return 0
+ fi
+ local server_name=$(safe_read "Enter server name: ")
+ if [[ -z "$server_name" ]]; then
+ log_error "Server name is required"
+ log_warn "Set VULTR_SERVER_NAME environment variable for non-interactive usage"
+ return 1
+ fi
+ echo "$server_name"
+}
+
+get_cloud_init_userdata() {
+ cat << 'CLOUD_INIT_EOF'
+#cloud-config
+package_update: true
+packages:
+ - curl
+ - unzip
+ - git
+ - zsh
+
+runcmd:
+ - su - root -c 'curl -fsSL https://bun.sh/install | bash'
+ - su - root -c 'curl -fsSL https://claude.ai/install.sh | bash'
+ - echo 'export PATH="$HOME/.claude/local/bin:$HOME/.bun/bin:$PATH"' >> /root/.bashrc
+ - echo 'export PATH="$HOME/.claude/local/bin:$HOME/.bun/bin:$PATH"' >> /root/.zshrc
+ - touch /root/.cloud-init-complete
+CLOUD_INIT_EOF
+}
+
+create_server() {
+ local name="$1"
+ local plan="${VULTR_PLAN:-vc2-1c-2gb}"
+ local region="${VULTR_REGION:-ewr}"
+ # Ubuntu 24.04 x64 OS ID
+ local os_id="${VULTR_OS_ID:-2284}"
+
+ log_warn "Creating Vultr instance '$name' (plan: $plan, region: $region)..."
+
+ # Get all SSH key IDs
+ local ssh_keys_response=$(vultr_api GET "/ssh-keys")
+ local ssh_key_ids=$(python3 -c "
+import json, sys
+data = json.loads(sys.stdin.read())
+ids = [k['id'] for k in data.get('ssh_keys', [])]
+print(json.dumps(ids))
+" <<< "$ssh_keys_response")
+
+ local userdata=$(get_cloud_init_userdata)
+ local userdata_b64=$(echo "$userdata" | base64 -w0 2>/dev/null || echo "$userdata" | base64)
+
+ local body=$(python3 -c "
+import json
+body = {
+ 'label': '$name',
+ 'hostname': '$name',
+ 'region': '$region',
+ 'plan': '$plan',
+ 'os_id': $os_id,
+ 'sshkey_id': $ssh_key_ids,
+ 'user_data': '$userdata_b64',
+ 'backups': 'disabled'
+}
+print(json.dumps(body))
+")
+
+ local response=$(vultr_api POST "/instances" "$body")
+
+ if echo "$response" | grep -q '"instance"'; then
+ VULTR_SERVER_ID=$(echo "$response" | python3 -c "import json,sys; print(json.loads(sys.stdin.read())['instance']['id'])")
+ export VULTR_SERVER_ID
+ log_info "Instance created: ID=$VULTR_SERVER_ID"
+ else
+ local error_msg=$(echo "$response" | python3 -c "import json,sys; d=json.loads(sys.stdin.read()); print(d.get('error','Unknown error'))" 2>/dev/null || echo "$response")
+ log_error "Failed to create instance: $error_msg"
+ return 1
+ fi
+
+ # Wait for instance to get an IP
+ log_warn "Waiting for instance to become active..."
+ local max_attempts=60
+ local attempt=1
+ while [[ $attempt -le $max_attempts ]]; do
+ local status_response=$(vultr_api GET "/instances/$VULTR_SERVER_ID")
+ local status=$(echo "$status_response" | python3 -c "import json,sys; print(json.loads(sys.stdin.read())['instance']['status'])")
+ local power=$(echo "$status_response" | python3 -c "import json,sys; print(json.loads(sys.stdin.read())['instance']['power_status'])")
+
+ if [[ "$status" == "active" && "$power" == "running" ]]; then
+ VULTR_SERVER_IP=$(echo "$status_response" | python3 -c "import json,sys; print(json.loads(sys.stdin.read())['instance']['main_ip'])")
+ export VULTR_SERVER_IP
+ log_info "Instance active: IP=$VULTR_SERVER_IP"
+ return 0
+ fi
+
+ log_warn "Instance status: $status/$power ($attempt/$max_attempts)"
+ sleep 5
+ ((attempt++))
+ done
+
+ log_error "Instance did not become active in time"
+ return 1
+}
+
+verify_server_connectivity() {
+ local ip="$1"
+ local max_attempts=${2:-30}
+ local attempt=1
+ log_warn "Waiting for SSH connectivity to $ip..."
+ while [[ $attempt -le $max_attempts ]]; do
+ if ssh $SSH_OPTS -o ConnectTimeout=5 "root@$ip" "echo ok" >/dev/null 2>&1; then
+ log_info "SSH connection established"
+ return 0
+ fi
+ log_warn "Waiting for SSH... ($attempt/$max_attempts)"
+ sleep 5
+ ((attempt++))
+ done
+ log_error "Server failed to respond via SSH after $max_attempts attempts"
+ return 1
+}
+
+wait_for_cloud_init() {
+ local ip="$1"
+ local max_attempts=${2:-60}
+ local attempt=1
+ log_warn "Waiting for cloud-init to complete..."
+ while [[ $attempt -le $max_attempts ]]; do
+ if ssh $SSH_OPTS "root@$ip" "test -f /root/.cloud-init-complete" >/dev/null 2>&1; then
+ log_info "Cloud-init completed"
+ return 0
+ fi
+ log_warn "Cloud-init in progress... ($attempt/$max_attempts)"
+ sleep 5
+ ((attempt++))
+ done
+ log_error "Cloud-init did not complete after $max_attempts attempts"
+ return 1
+}
+
+run_server() {
+ local ip="$1"; local cmd="$2"
+ ssh $SSH_OPTS "root@$ip" "$cmd"
+}
+
+upload_file() {
+ local ip="$1"; local local_path="$2"; local remote_path="$3"
+ scp $SSH_OPTS "$local_path" "root@$ip:$remote_path"
+}
+
+interactive_session() {
+ local ip="$1"; local cmd="$2"
+ ssh -t $SSH_OPTS "root@$ip" "$cmd"
+}
+
+destroy_server() {
+ local server_id="$1"
+ log_warn "Destroying instance $server_id..."
+ vultr_api DELETE "/instances/$server_id"
+ log_info "Instance $server_id destroyed"
+}
+
+list_servers() {
+ local response=$(vultr_api GET "/instances")
+ python3 -c "
+import json, sys
+data = json.loads(sys.stdin.read())
+instances = data.get('instances', [])
+if not instances:
+ print('No instances found')
+ sys.exit(0)
+print(f\"{'LABEL':<25} {'ID':<40} {'STATUS':<12} {'IP':<16} {'PLAN':<15}\")
+print('-' * 108)
+for i in instances:
+ label = i.get('label', 'N/A')
+ iid = i['id']
+ status = i['status']
+ ip = i.get('main_ip', 'N/A')
+ plan = i['plan']
+ print(f'{label:<25} {iid:<40} {status:<12} {ip:<16} {plan:<15}')
+" <<< "$response"
+}
diff --git a/vultr/nanoclaw.sh b/vultr/nanoclaw.sh
new file mode 100755
index 00000000..a383dd91
--- /dev/null
+++ b/vultr/nanoclaw.sh
@@ -0,0 +1,64 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+if [[ -f "$SCRIPT_DIR/lib/common.sh" ]]; then
+ source "$SCRIPT_DIR/lib/common.sh"
+else
+ source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/vultr/lib/common.sh)
+fi
+
+log_info "NanoClaw on Vultr"
+echo ""
+
+ensure_vultr_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "$SERVER_NAME"
+verify_server_connectivity "$VULTR_SERVER_IP"
+wait_for_cloud_init "$VULTR_SERVER_IP"
+
+log_warn "Installing tsx..."
+run_server "$VULTR_SERVER_IP" "source ~/.bashrc && bun install -g tsx"
+log_warn "Cloning and building nanoclaw..."
+run_server "$VULTR_SERVER_IP" "git clone https://github.com/gavrielc/nanoclaw.git ~/nanoclaw && cd ~/nanoclaw && npm install && npm run build"
+log_info "NanoClaw installed"
+
+echo ""
+if [[ -n "$OPENROUTER_API_KEY" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_warn "Setting up environment variables..."
+ENV_TEMP=$(mktemp)
+cat > "$ENV_TEMP" << EOF
+
+# [spawn:env]
+export OPENROUTER_API_KEY="${OPENROUTER_API_KEY}"
+export ANTHROPIC_API_KEY="${OPENROUTER_API_KEY}"
+export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
+EOF
+upload_file "$VULTR_SERVER_IP" "$ENV_TEMP" "/tmp/env_config"
+run_server "$VULTR_SERVER_IP" "cat /tmp/env_config >> ~/.zshrc && rm /tmp/env_config"
+rm "$ENV_TEMP"
+
+log_warn "Configuring nanoclaw..."
+DOTENV_TEMP=$(mktemp)
+cat > "$DOTENV_TEMP" << EOF
+ANTHROPIC_API_KEY=${OPENROUTER_API_KEY}
+EOF
+upload_file "$VULTR_SERVER_IP" "$DOTENV_TEMP" "/root/nanoclaw/.env"
+rm "$DOTENV_TEMP"
+
+echo ""
+log_info "Vultr instance setup completed successfully!"
+log_info "Server: $SERVER_NAME (ID: $VULTR_SERVER_ID, IP: $VULTR_SERVER_IP)"
+echo ""
+
+log_warn "Starting nanoclaw..."
+log_warn "You will need to scan a WhatsApp QR code to authenticate."
+echo ""
+interactive_session "$VULTR_SERVER_IP" "cd ~/nanoclaw && source ~/.zshrc && npm run dev"
diff --git a/vultr/openclaw.sh b/vultr/openclaw.sh
new file mode 100755
index 00000000..720eb4b4
--- /dev/null
+++ b/vultr/openclaw.sh
@@ -0,0 +1,74 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+if [[ -f "$SCRIPT_DIR/lib/common.sh" ]]; then
+ source "$SCRIPT_DIR/lib/common.sh"
+else
+ source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/vultr/lib/common.sh)
+fi
+
+log_info "OpenClaw on Vultr"
+echo ""
+
+ensure_vultr_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "$SERVER_NAME"
+verify_server_connectivity "$VULTR_SERVER_IP"
+wait_for_cloud_init "$VULTR_SERVER_IP"
+
+log_warn "Installing openclaw..."
+run_server "$VULTR_SERVER_IP" "source ~/.bashrc && bun install -g openclaw"
+log_info "OpenClaw installed"
+
+echo ""
+if [[ -n "$OPENROUTER_API_KEY" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+echo ""
+log_warn "Browse models at: https://openrouter.ai/models"
+MODEL_ID=$(safe_read "Enter model ID [openrouter/auto]: ") || MODEL_ID=""
+MODEL_ID="${MODEL_ID:-openrouter/auto}"
+
+log_warn "Setting up environment variables..."
+ENV_TEMP=$(mktemp)
+cat > "$ENV_TEMP" << EOF
+
+# [spawn:env]
+export OPENROUTER_API_KEY="${OPENROUTER_API_KEY}"
+export ANTHROPIC_API_KEY="${OPENROUTER_API_KEY}"
+export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
+EOF
+upload_file "$VULTR_SERVER_IP" "$ENV_TEMP" "/tmp/env_config"
+run_server "$VULTR_SERVER_IP" "cat /tmp/env_config >> ~/.zshrc && rm /tmp/env_config"
+rm "$ENV_TEMP"
+
+log_warn "Configuring openclaw..."
+run_server "$VULTR_SERVER_IP" "rm -rf ~/.openclaw && mkdir -p ~/.openclaw"
+GATEWAY_TOKEN=$(openssl rand -hex 16)
+
+OPENCLAW_CONFIG_TEMP=$(mktemp)
+cat > "$OPENCLAW_CONFIG_TEMP" << EOF
+{
+ "env": { "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}" },
+ "gateway": { "mode": "local", "auth": { "token": "${GATEWAY_TOKEN}" } },
+ "agents": { "defaults": { "model": { "primary": "openrouter/${MODEL_ID}" } } }
+}
+EOF
+upload_file "$VULTR_SERVER_IP" "$OPENCLAW_CONFIG_TEMP" "/root/.openclaw/openclaw.json"
+rm "$OPENCLAW_CONFIG_TEMP"
+
+echo ""
+log_info "Vultr instance setup completed successfully!"
+log_info "Server: $SERVER_NAME (ID: $VULTR_SERVER_ID, IP: $VULTR_SERVER_IP)"
+echo ""
+
+log_warn "Starting openclaw..."
+run_server "$VULTR_SERVER_IP" "source ~/.zshrc && nohup openclaw gateway > /tmp/openclaw-gateway.log 2>&1 &"
+sleep 2
+interactive_session "$VULTR_SERVER_IP" "source ~/.zshrc && openclaw tui"