feat: add bootable Linux USB module (independent within repo)

Add bootable/ directory with complete toolkit to create a bootable Ubuntu USB drive with OpenClaw AI: - 4-step PowerShell scripts for USB preparation on Windows - Ventoy 1.0.99 boot manager with casper-rw persistence - Self-contained Linux setup and startup scripts - Detailed README with architecture, usage guide, and troubleshooting bootable/ is fully independent - does not reference any files from portable/, u-claw-app/, or website/. Also maintained as standalone repo at u-claw-linux for convenience. Update main README to reference both bootable/ and u-claw-linux repo. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 18:35:41 +08:00
parent 44b1afa177
commit b9f37e1e1b
11 changed files with 1106 additions and 10 deletions
--- a/bootable/2-download-iso.ps1
+++ b/bootable/2-download-iso.ps1
@@ -0,0 +1,110 @@
+# ============================================================
+#  U-Claw Bootable USB - Step 2: Download Ubuntu 24.04 ISO
+#  Downloads and verifies Ubuntu desktop ISO
+# ============================================================
+
+$ErrorActionPreference = "Stop"
+
+Write-Host ""
+Write-Host "============================================" -ForegroundColor Cyan
+Write-Host "  U-Claw Bootable USB - Step 2: Ubuntu ISO" -ForegroundColor Cyan
+Write-Host "============================================" -ForegroundColor Cyan
+Write-Host ""
+
+# ── Config ──
+$ISOName = "ubuntu-24.04.2-desktop-amd64.iso"
+$SHA256Expected = "d6dab0c3a657988501b4bd76f1297c053df710e06e0c3aece60dead24f270b4d"
+$CacheDir = Join-Path $PSScriptRoot ".download-cache"
+$ISOPath = Join-Path $CacheDir $ISOName
+
+# Mirror list (China mirrors first)
+$Mirrors = @(
+    "https://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases/24.04.2/$ISOName",
+    "https://mirrors.aliyun.com/ubuntu-releases/24.04.2/$ISOName",
+    "https://mirrors.ustc.edu.cn/ubuntu-releases/24.04.2/$ISOName",
+    "https://releases.ubuntu.com/24.04.2/$ISOName"
+)
+
+# ── Create cache directory ──
+if (-not (Test-Path $CacheDir)) {
+    New-Item -ItemType Directory -Path $CacheDir -Force | Out-Null
+}
+
+# ── Check existing download ──
+if (Test-Path $ISOPath) {
+    Write-Host "[INFO] ISO file found in cache. Verifying SHA256..." -ForegroundColor Yellow
+    $hash = (Get-FileHash -Path $ISOPath -Algorithm SHA256).Hash.ToLower()
+    if ($hash -eq $SHA256Expected) {
+        Write-Host "[OK]   SHA256 verified. ISO is valid." -ForegroundColor Green
+        Write-Host "       Path: $ISOPath" -ForegroundColor White
+        Write-Host ""
+        Write-Host "       Next: Run .\3-create-persistence.ps1" -ForegroundColor Cyan
+        Read-Host "Press Enter to continue"
+        exit 0
+    } else {
+        Write-Host "[WARN] SHA256 mismatch! Re-downloading..." -ForegroundColor Red
+        Write-Host "       Expected: $SHA256Expected" -ForegroundColor Gray
+        Write-Host "       Got:      $hash" -ForegroundColor Gray
+        Remove-Item -Path $ISOPath -Force
+    }
+}
+
+# ── Download ISO ──
+Write-Host "[INFO] Downloading Ubuntu 24.04.2 Desktop (~5.8 GB)..." -ForegroundColor Yellow
+Write-Host "       This will take a while depending on your connection." -ForegroundColor Gray
+Write-Host ""
+
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+
+$downloaded = $false
+foreach ($mirror in $Mirrors) {
+    $mirrorHost = ([System.Uri]$mirror).Host
+    Write-Host "       Trying $mirrorHost ..." -ForegroundColor Gray
+    try {
+        $ProgressPreference = 'Continue'
+        Invoke-WebRequest -Uri $mirror -OutFile $ISOPath -UseBasicParsing
+        $downloaded = $true
+        Write-Host "[OK]   Downloaded from $mirrorHost" -ForegroundColor Green
+        break
+    } catch {
+        Write-Host "       Failed: $($_.Exception.Message)" -ForegroundColor DarkGray
+        if (Test-Path $ISOPath) { Remove-Item -Path $ISOPath -Force }
+        continue
+    }
+}
+
+if (-not $downloaded) {
+    Write-Host ""
+    Write-Host "[ERROR] All download mirrors failed." -ForegroundColor Red
+    Write-Host "        Please download Ubuntu 24.04.2 Desktop ISO manually:" -ForegroundColor Yellow
+    Write-Host "        https://releases.ubuntu.com/24.04.2/" -ForegroundColor Yellow
+    Write-Host "        Save it as: $ISOPath" -ForegroundColor Yellow
+    Read-Host "Press Enter to exit"
+    exit 1
+}
+
+# ── Verify SHA256 ──
+Write-Host "[INFO] Verifying SHA256 checksum..." -ForegroundColor Yellow
+$hash = (Get-FileHash -Path $ISOPath -Algorithm SHA256).Hash.ToLower()
+if ($hash -eq $SHA256Expected) {
+    Write-Host "[OK]   SHA256 verified! ISO is authentic." -ForegroundColor Green
+} else {
+    Write-Host "[WARN] SHA256 mismatch!" -ForegroundColor Red
+    Write-Host "       Expected: $SHA256Expected" -ForegroundColor Gray
+    Write-Host "       Got:      $hash" -ForegroundColor Gray
+    Write-Host ""
+    Write-Host "       The ISO may be corrupted or a newer version." -ForegroundColor Yellow
+    Write-Host "       You can continue at your own risk, or re-download." -ForegroundColor Yellow
+    $cont = Read-Host "Continue anyway? (y/N)"
+    if ($cont -ne "y" -and $cont -ne "Y") {
+        Remove-Item -Path $ISOPath -Force
+        exit 1
+    }
+}
+
+Write-Host ""
+Write-Host "[OK]   Step 2 complete! ISO saved to:" -ForegroundColor Green
+Write-Host "       $ISOPath" -ForegroundColor White
+Write-Host ""
+Write-Host "       Next: Run .\3-create-persistence.ps1" -ForegroundColor Cyan
+Read-Host "Press Enter to continue"