virtualbox

# VirtualBox Skill

Control and manage VirtualBox virtual machines directly from openclaw using the VBoxManage command-line interface. This skill provides comprehensive VM lifecycle management, configuration, and monitoring capabilities.

## Setup

### Prerequisites
1. VirtualBox must be installed on the host system
2. VBoxManage CLI must be accessible (usually in PATH after VirtualBox installation)
3. User must have appropriate permissions to control VMs

### Verify Installation
```bash
VBoxManage --version
```

### Common Paths
- **Linux**: `/usr/bin/VBoxManage` or `/usr/local/bin/VBoxManage`
- **macOS**: `/Applications/VirtualBox.app/Contents/MacOS/VBoxManage`
- **Windows**: `C:\Program Files\Oracle\VirtualBox\VBoxManage.exe`

## Core Capabilities

### VM Lifecycle Management
- Create, start, stop, pause, and delete VMs
- Manage VM states (running, paused, saved, powered off)
- Force stop and ACPI shutdown options
- Reset and restart VMs

### Configuration Management
- Modify VM settings (CPU, RAM, storage)
- Configure network adapters and modes
- Set up shared folders
- Manage USB device passthrough

### Snapshot & Cloning
- Create and restore snapshots
- Clone existing VMs
- Export/Import appliances

### Monitoring & Information
- List all VMs and their states
- Get detailed VM information
- Monitor VM metrics and performance
- View logs and debugging info

## Usage

### List All VMs

```bash
# List all registered VMs
VBoxManage list vms

# List running VMs only
VBoxManage list runningvms

# Get detailed info about all VMs (JSON-like output)
VBoxManage list vms --long
```

### VM Information

```bash
# Get detailed info about a specific VM
VBoxManage showvminfo "VM_NAME"

# Get info in machine-readable format
VBoxManage showvminfo "VM_NAME" --machinereadable
```

### Start a VM

```bash
# Start VM with GUI
VBoxManage startvm "VM_NAME"

# Start VM headless (no GUI)
VBoxManage startvm "VM_NAME" --type headless

# Start VM with separate UI process
VBoxManage start...