| 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
export VPS_PROVIDER=digitalocean
export VPS_API_KEY=dop_v1_xxxxxxxx
export VPS_SSH_KEY_ID=12345678
Get API keys:
Usage
Create VPS for new client
cd skills/freight-vps-provisioner/scripts
python3 vps_manager.py --create --client-name "ABC Trucking" --client-email "ops@abctrucking.com"
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
- Create VPS → Get client_id and IP address
- Wait for provisioning (1-2 minutes)
- Install OpenClaw → SSH in and run install
- Configure iMessage → Set up SMS relay
- Deploy freight skills → Copy skills to VPS
- 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