freight-vps-provisioner

name

freight-vps-provisioner

description

Provision VPS instances for new freight broker clients using cloud providers (DigitalOcean, Hetzner, AWS). Creates standardized Ubuntu servers pre-configured for OpenClaw deployment. Use when onboarding a new client and need to create their dedicated VPS, checking VPS provisioning status, or listing all client VPS instances. Triggered by "create VPS", "provision server", "new client setup", "VPS status", or "list clients".

Freight VPS Provisioner

Creates cloud VPS instances for freight broker clients. Each client gets their own isolated OpenClaw instance.

Supported Providers

Provider	Cost (approx)	Region Options
DigitalOcean	$24-48/mo	NYC, SF, London, etc.
Hetzner	€7-15/mo	Germany, Finland, USA
AWS EC2	$30-60/mo	Global

Setup

# Choose provider and set API key
export VPS_PROVIDER=digitalocean  # or hetzner, aws
export VPS_API_KEY=dop_v1_xxxxxxxx

# Optional: SSH key for server access
export VPS_SSH_KEY_ID=12345678  # DigitalOcean key ID

Get API keys:

• DigitalOcean: https://cloud.digitalocean.com/account/api/tokens
• Hetzner: https://console.hetzner.cloud/projects → Security → API Tokens

Usage

Create VPS for new client

cd skills/freight-vps-provisioner/scripts
python3 vps_manager.py --create --client-name "ABC Trucking" --client-email "[e-mail]"

Check provisioning status

python3 vps_manager.py --status CLIENT-20251218000001

List all clients

python3 vps_manager.py --list

Default VPS Specs

• OS: Ubuntu 22.04 LTS
• CPU/RAM: 2 vCPU / 4GB RAM (suitable for 1 broker)
• Disk: 80GB SSD
• Pre-installed: Python3, Node.js, Git, OpenClaw CLI

Client Onboarding Workflow

1. Create VPS → Get client_id and IP address
2. Wait for provisioning (1-2 minutes)
3. Install OpenClaw → SSH in and run install
4. Configure iMessage → Set up SMS relay
5. Deploy freight skills → Copy skills to VPS
6. Test → Send test SMS to verify

SMS Output Example

✅ VPS CREATED - ABC Trucking
Client ID: CLIENT-20251218000001
IP: 192.0.2.100
Status: Provisioning...

Next steps:
1. Wait 2 minutes for boot
2. SSH: ssh root@192.0.2.100
3. Run: openclaw setup

Integrations

This skill uses the following external services. See INTEGRATIONS.md for detailed setup instructions, API documentation links, and implementation guidance.

Service	Purpose	Section in INTEGRATIONS.md
DigitalOcean API	VPS provisioning	Refer to this SKILL.md
Hetzner Cloud API	VPS provisioning (EU)	Refer to this SKILL.md
AWS EC2 API	VPS provisioning (enterprise)	Refer to this SKILL.md

See INTEGRATIONS.md for complete integration architecture

Storage

Client records: ~/.freight-broker/clients.json