@agenthippo-ai/agenthippo 1.110.11 → 1.110.19

package/out/scripts/gateway/setup-gateway-server.ps1

@@ -1,953 +0,0 @@
-#
-# AgentHippo -- Server Gateway Setup (Windows)
-#
-# Installs OpenClaw Gateway and builds the web UI so users can
-# configure messaging channels (Telegram, WhatsApp, Slack, etc.)
-#
-# Usage:
-#   .\setup-gateway-server.ps1 -Source "C:\dev\openclaw"        # Local source
-#   .\setup-gateway-server.ps1 -Source "openclaw@latest"        # npm source
-#   .\setup-gateway-server.ps1 -Bind "0.0.0.0" -Token "mysecret"
-#   .\setup-gateway-server.ps1 -Check                           # Check status only
-#   .\setup-gateway-server.ps1 -NoStart                         # Install only
-#   .\setup-gateway-server.ps1 -Uninstall                       # stop gateway + remove global openclaw
-#   .\setup-gateway-server.ps1 -Reinstall -Source <src>       # uninstall, verify, install (+ start)
-#
-
-param(
-    [string]$Source = "",
-    [switch]$Check,
-    [switch]$Uninstall,
-    [switch]$Reinstall,
-    [int]$Port = 18789,
-    [string]$Bind = "127.0.0.1",
-    [string]$Token = "",
-    [switch]$Systemd,
-    [switch]$NoStart,
-    [string]$ConfigTemplate = ""
-)
-
-$ErrorActionPreference = "Stop"
-
-function Read-OpenclawConfigGatewayPort {
-    $cfg = Join-Path $env:USERPROFILE ".openclaw\openclaw.json"
-    if (-not (Test-Path -LiteralPath $cfg)) { return $null }
-    if (-not (Get-Command node -ErrorAction SilentlyContinue)) { return $null }
-    $expr = 'const fs=require("fs");const p=require("path");const o=require("os");const f=p.join(o.homedir(),".openclaw","openclaw.json");if(!fs.existsSync(f))process.exit(1);let t=fs.readFileSync(f,"utf8");t=t.replace(/^\s*\/\/.*$/gm,"").replace(/,\s*([\]}])/g,"$1");try{const j=JSON.parse(t);const x=j&&j.gateway&&j.gateway.port;if(typeof x==="number"&&x>=1&&x<=65535){process.stdout.write(String(x));process.exit(0)}if(typeof x==="string"&&/^[0-9]+$/.test(x)){process.stdout.write(x);process.exit(0)}}catch(z){}process.exit(1);'
-    try {
-        $raw = & node -e $expr 2>$null
-        if ($null -ne $raw -and "$raw" -match '^[0-9]+$') { return [int]"$raw" }
-    } catch { }
-    return $null
-}
-
-function Get-HippoclawCommonBinaryPaths {
-    $userHome = $env:USERPROFILE
-    $localAppData = if ($env:LOCALAPPDATA) { $env:LOCALAPPDATA } else { Join-Path $userHome "AppData\Local" }
-    $appData = if ($env:APPDATA) { $env:APPDATA } else { Join-Path $userHome "AppData\Roaming" }
-
-    return @(
-        (Join-Path $localAppData "AgentHippo\bin\hippoclaw.exe"),
-        (Join-Path $localAppData "AgentHippo\bin\hippoclaw.ps1"),
-        (Join-Path $localAppData "AgentHippo\bin\hippoclaw.cmd"),
-        (Join-Path $userHome "AppData\Local\Programs\hippoclaw\hippoclaw.exe"),
-        (Join-Path $appData "npm\hippoclaw.ps1"),
-        (Join-Path $appData "npm\hippoclaw.cmd"),
-        (Join-Path $localAppData "pnpm\hippoclaw.ps1"),
-        (Join-Path $localAppData "pnpm\hippoclaw.cmd"),
-        (Join-Path $userHome ".npm-global\hippoclaw.ps1"),
-        (Join-Path $userHome ".npm-global\hippoclaw.cmd")
-    )
-}
-
-function Resolve-HippoclawBinary {
-    $cmd = Get-Command hippoclaw -ErrorAction SilentlyContinue
-    if ($cmd) {
-        if ($cmd.Path) { return $cmd.Path }
-        if ($cmd.Source -and (Test-Path -LiteralPath $cmd.Source)) { return $cmd.Source }
-        if ($cmd.Definition) { return $cmd.Definition }
-    }
-
-    foreach ($candidate in (Get-HippoclawCommonBinaryPaths)) {
-        if (Test-Path -LiteralPath $candidate) {
-            return $candidate
-        }
-    }
-
-    return $null
-}
-
-function Resolve-GatewayBindMode {
-    param([string]$BindValue)
-
-    $normalized = if ($BindValue) { $BindValue.Trim().ToLowerInvariant() } else { "" }
-    switch ($normalized) {
-        "" { return "loopback" }
-        "127.0.0.1" { return "loopback" }
-        "localhost" { return "loopback" }
-        "loopback" { return "loopback" }
-        "0.0.0.0" { return "lan" }
-        "::" { return "lan" }
-        "lan" { return "lan" }
-        "tailnet" { return "tailnet" }
-        "auto" { return "auto" }
-        "custom" { return "custom" }
-        default { return "custom" }
-    }
-}
-
-function Resolve-GatewayDisplayHost {
-    param([string]$BindValue)
-
-    $normalized = if ($BindValue) { $BindValue.Trim().ToLowerInvariant() } else { "" }
-    switch ($normalized) {
-        "" { return "127.0.0.1" }
-        "127.0.0.1" { return "127.0.0.1" }
-        "localhost" { return "127.0.0.1" }
-        "loopback" { return "127.0.0.1" }
-        "0.0.0.0" { return $env:COMPUTERNAME }
-        "::" { return $env:COMPUTERNAME }
-        "lan" { return $env:COMPUTERNAME }
-        "tailnet" { return $env:COMPUTERNAME }
-        "auto" { return $env:COMPUTERNAME }
-        default { return $BindValue }
-    }
-}
-
-function Get-HippoclawStartCommand {
-    param(
-        [string]$BinaryPath,
-        [string[]]$CliArgs
-    )
-
-    $extension = [System.IO.Path]::GetExtension($BinaryPath).ToLowerInvariant()
-    if ($extension -eq ".ps1") {
-        return @{
-            FilePath = (Join-Path $env:WINDIR "System32\WindowsPowerShell\v1.0\powershell.exe")
-            ArgumentList = @("-NoProfile", "-ExecutionPolicy", "Bypass", "-File", $BinaryPath) + $CliArgs
-        }
-    }
-
-    if ($extension -eq ".cmd" -or $extension -eq ".bat") {
-        $quotedBinaryPath = '"' + $BinaryPath + '"'
-        return @{
-            FilePath = $env:ComSpec
-            ArgumentList = @("/d", "/c", ($quotedBinaryPath + " " + ($CliArgs -join " ")))
-        }
-    }
-
-    return @{
-        FilePath = $BinaryPath
-        ArgumentList = $CliArgs
-    }
-}
-
-if (-not $PSBoundParameters.ContainsKey('Port')) {
-    $cfgPort = Read-OpenclawConfigGatewayPort
-    if ($null -ne $cfgPort) { $Port = $cfgPort }
-}
-
-# ============================================================================
-# Logging helpers
-# ============================================================================
-function Log-Info    { param([string]$msg) Write-Host "[INFO] $msg" -ForegroundColor Blue }
-function Log-Success { param([string]$msg) Write-Host "  [OK] $msg" -ForegroundColor Green }
-function Log-Warn    { param([string]$msg) Write-Host "  [WARN] $msg" -ForegroundColor Yellow }
-function Log-Error   { param([string]$msg) Write-Host "[ERROR] $msg" -ForegroundColor Red }
-function Log-Step    { param([string]$msg) Write-Host "`n$msg" -ForegroundColor Cyan }
-
-# ============================================================================
-# Git / GitHub-style sources need a local UI build (published tarballs ship dist/).
-# ============================================================================
-function Test-SourceNeedsBuild {
-    param([string]$S)
-    if (-not $S) { return $false }
-    if ($S.StartsWith("\\") -or $S.StartsWith("/") -or $S.StartsWith(".")) { return $true }
-    if ($S -match '^[A-Za-z]:') { return $true }
-    if ($S.StartsWith("github:")) { return $true }
-    if ($S.StartsWith("git+http:") -or $S.StartsWith("git+https:")) { return $true }
-    if ($S.Contains("#")) { return $true }
-    if ($S -match '^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$') { return $true }
-    return $false
-}
-
-function Needs-Pnpm {
-    return Test-SourceNeedsBuild -S $Source
-}
-
-function Test-InstallSourceLocal {
-    param([string]$S)
-    if (-not $S) { return $false }
-    return $S.StartsWith("\\") -or $S.StartsWith("/") -or $S.StartsWith(".") -or ($S -match '^[A-Za-z]:')
-}
-
-# Git checkouts omit dist/; build in clone before npm pack.
-function Install-OpenclawFromRemoteGitSpec {
-    param([string]$Spec)
-
-    $s = $Spec
-    $ref = $null
-    if ($s.Contains("#")) {
-        $ref = $s.Substring($s.LastIndexOf("#") + 1)
-        $s = $s.Substring(0, $s.LastIndexOf("#"))
-    }
-
-    $cloneUrl = $null
-    if ($s.StartsWith("git+https:") -or $s.StartsWith("git+http:")) {
-        $cloneUrl = $s.Substring(4)
-    } elseif ($s.StartsWith("github:")) {
-        $rest = $s.Substring("github:".Length)
-        $cloneUrl = "https://github.com/$rest.git"
-    } elseif ($s -match '^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$') {
-        $cloneUrl = "https://github.com/$s.git"
-    } else {
-        Log-Error "Unsupported git install source: $Spec"
-        throw "Unsupported git install source"
-    }
-
-    $work = Join-Path ([System.IO.Path]::GetTempPath()) ("openclaw-gateway-src-" + [guid]::NewGuid().ToString("n"))
-    New-Item -ItemType Directory -Path $work -Force | Out-Null
-    $srcDir = Join-Path $work "src"
-
-    try {
-        Log-Info "Cloning $(Split-Path -Leaf $cloneUrl) (shallow) for npm pack install..."
-        if ($ref) {
-            git clone --depth 1 -b $ref $cloneUrl $srcDir
-        } else {
-            git clone --depth 1 $cloneUrl $srcDir
-        }
-        if ($LASTEXITCODE -ne 0) {
-            if (Test-Path $work) { Remove-Item -Recurse -Force $work -ErrorAction SilentlyContinue }
-            Log-Error "git clone failed (check ref and network)"
-            throw "git clone failed"
-        }
-
-        Log-Info "Building OpenClaw in clone before npm pack (may take several minutes)..."
-        try {
-            Invoke-OpenclawRepoBuild -RepoDir $srcDir
-        } catch {
-            if (Test-Path $work) { Remove-Item -Recurse -Force $work -ErrorAction SilentlyContinue }
-            Log-Error "OpenClaw source build failed: $_"
-            throw
-        }
-
-        Log-Info "npm pack --ignore-scripts ..."
-        Push-Location $srcDir
-        try {
-            npm pack --ignore-scripts
-            if ($LASTEXITCODE -ne 0) {
-                if (Test-Path $work) { Remove-Item -Recurse -Force $work -ErrorAction SilentlyContinue }
-                Log-Error "npm pack failed"
-                throw "npm pack failed"
-            }
-        } finally {
-            Pop-Location
-        }
-
-        $tgz = Get-ChildItem -Path $srcDir -Filter "openclaw-*.tgz" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
-        if (-not $tgz) {
-            if (Test-Path $work) { Remove-Item -Recurse -Force $work -ErrorAction SilentlyContinue }
-            Log-Error "npm pack did not produce openclaw-*.tgz under clone"
-            throw "npm pack produced no tarball"
-        }
-
-        Log-Info "npm install -g $($tgz.Name) ..."
-        npm install -g $tgz.FullName
-        if ($LASTEXITCODE -ne 0) {
-            if (Test-Path $work) { Remove-Item -Recurse -Force $work -ErrorAction SilentlyContinue }
-            Log-Error "npm install -g tarball failed"
-            throw "npm install tarball failed"
-        }
-
-        $script:RemoteGatewayCloneSrc = $srcDir
-        $script:RemoteGatewayWorkDir = $work
-    } catch {
-        if (Test-Path $work) {
-            Remove-Item -Recurse -Force $work -ErrorAction SilentlyContinue
-        }
-        throw
-    }
-}
-
-# ============================================================================
-# Check prerequisites
-# ============================================================================
-function Check-Prerequisites {
-    Log-Step "Checking prerequisites..."
-
-    $allGood = $true
-
-    # Node.js >= 22
-    try {
-        $nodeVersion = (node -v 2>$null)
-        if ($nodeVersion) {
-            $major = [int]($nodeVersion -replace 'v','').Split('.')[0]
-            if ($major -ge 22) {
-                Log-Success "Node.js $nodeVersion"
-            } else {
-                Log-Warn "Node.js $nodeVersion -- version 22+ required"
-                $allGood = $false
-            }
-        } else {
-            throw "not found"
-        }
-    } catch {
-        Log-Warn "Node.js not found (version 22+ required)"
-        Write-Host "       Install: https://nodejs.org/" -ForegroundColor Gray
-        $allGood = $false
-    }
-
-    # npm
-    try {
-        $npmVersion = (npm -v 2>$null)
-        if ($npmVersion) {
-            Log-Success "npm $npmVersion"
-        } else {
-            throw "not found"
-        }
-    } catch {
-        Log-Warn "npm not found"
-        $allGood = $false
-    }
-
-    if (Test-SourceNeedsBuild -S $Source) {
-        $localSrc = Test-InstallSourceLocal -S $Source
-        if (-not $localSrc) {
-            try {
-                $gitVersion = (git --version 2>$null)
-                if ($gitVersion) {
-                    Log-Success "git $gitVersion"
-                } else {
-                    throw "not found"
-                }
-            } catch {
-                Log-Warn "git not found (required for GitHub / git URL gateway install sources)"
-                $allGood = $false
-            }
-        }
-    }
-
-    # pnpm (needed for ui:build when installing from git/local source)
-    if (Needs-Pnpm) {
-        try {
-            $pnpmVersion = (pnpm -v 2>$null)
-            if ($pnpmVersion) {
-                Log-Success "pnpm $pnpmVersion"
-            } else {
-                throw "not found"
-            }
-        } catch {
-            Log-Warn "pnpm not found (needed to build OpenClaw from source)"
-            Write-Host "       Install: npm install -g pnpm" -ForegroundColor Gray
-        }
-    } else {
-        Log-Info "pnpm not required for published package install"
-    }
-
-    return $allGood
-}
-
-# ============================================================================
-# Ensure pnpm is available when we need to build the UI
-# ============================================================================
-function Get-PreferredGitBashPath {
-    $candidates = @()
-    if ($env:ProgramFiles) {
-        $candidates += (Join-Path $env:ProgramFiles "Git\usr\bin\bash.exe")
-        $candidates += (Join-Path $env:ProgramFiles "Git\bin\bash.exe")
-    }
-    $programFilesX86 = [Environment]::GetEnvironmentVariable("ProgramFiles(x86)")
-    if ($programFilesX86) {
-        $candidates += (Join-Path $programFilesX86 "Git\usr\bin\bash.exe")
-        $candidates += (Join-Path $programFilesX86 "Git\bin\bash.exe")
-    }
-
-    foreach ($candidate in $candidates) {
-        if ($candidate -and (Test-Path -LiteralPath $candidate)) {
-            return $candidate
-        }
-    }
-
-    try {
-        $commands = @(Get-Command bash -All -ErrorAction SilentlyContinue)
-        foreach ($command in $commands) {
-            if ($command.Source -and $command.Source -match '[\\/]Git[\\/]usr[\\/]bin[\\/]bash\.exe$') {
-                return $command.Source
-            }
-        }
-        foreach ($command in $commands) {
-            if ($command.Source -and $command.Source -match '[\\/]Git[\\/].*bash\.exe$') {
-                return $command.Source
-            }
-        }
-    } catch { }
-
-    return $null
-}
-
-function Invoke-WithPreferredWindowsBash {
-    param([scriptblock]$ScriptBlock)
-
-    $originalPath = $env:PATH
-    $originalScriptShell = $env:npm_config_script_shell
-    $shimDir = $null
-    try {
-        $gitBashPath = Get-PreferredGitBashPath
-        if ($gitBashPath) {
-            $gitBashDir = Split-Path -Parent $gitBashPath
-            $shimDir = Join-Path ([System.IO.Path]::GetTempPath()) ("agent-anywhere-bash-" + [guid]::NewGuid().ToString("n"))
-            New-Item -ItemType Directory -Path $shimDir -Force | Out-Null
-            $shimPath = Join-Path $shimDir "bash.cmd"
-            $shimContent = @(
-                "@echo off",
-                ('"{0}" %*' -f $gitBashPath)
-            ) -join "`r`n"
-            Set-Content -Path $shimPath -Value $shimContent -Encoding Ascii
-            $env:PATH = "$shimDir;$gitBashDir;$env:PATH"
-            $env:npm_config_script_shell = $gitBashPath
-            Log-Info "Using Git Bash for source build scripts: $gitBashPath"
-        }
-        & $ScriptBlock
-    } finally {
-        $env:PATH = $originalPath
-        if ($null -eq $originalScriptShell) {
-            Remove-Item Env:npm_config_script_shell -ErrorAction SilentlyContinue
-        } else {
-            $env:npm_config_script_shell = $originalScriptShell
-        }
-        if ($shimDir -and (Test-Path -LiteralPath $shimDir)) {
-            Remove-Item -LiteralPath $shimDir -Recurse -Force -ErrorAction SilentlyContinue
-        }
-    }
-}
-
-function Ensure-Pnpm {
-    try {
-        $pnpmVersion = (pnpm -v 2>$null)
-        if ($pnpmVersion) {
-            Log-Success "pnpm $pnpmVersion"
-            return $true
-        }
-    } catch { }
-
-    Log-Warn "pnpm not found - attempting to install"
-
-    try {
-        Log-Info "Installing pnpm via npm..."
-        npm install -g pnpm | Out-Null
-        $pnpmVersion = (pnpm -v 2>$null)
-        if ($pnpmVersion) {
-            Log-Success "pnpm $pnpmVersion"
-            return $true
-        }
-    } catch { }
-
-    try {
-        $corepackVersion = (corepack -v 2>$null)
-        if ($corepackVersion) {
-            Log-Info "Installing pnpm via corepack..."
-            $previousPromptValue = $env:COREPACK_ENABLE_DOWNLOAD_PROMPT
-            try {
-                $env:COREPACK_ENABLE_DOWNLOAD_PROMPT = "0"
-                corepack prepare pnpm@latest --activate | Out-Null
-            } finally {
-                if ($null -eq $previousPromptValue) {
-                    Remove-Item Env:COREPACK_ENABLE_DOWNLOAD_PROMPT -ErrorAction SilentlyContinue
-                } else {
-                    $env:COREPACK_ENABLE_DOWNLOAD_PROMPT = $previousPromptValue
-                }
-            }
-            $pnpmVersion = (pnpm -v 2>$null)
-            if ($pnpmVersion) {
-                Log-Success "pnpm $pnpmVersion"
-                return $true
-            }
-        }
-    } catch { }
-
-    Log-Warn "pnpm install failed - cannot build OpenClaw from source"
-    return $false
-}
-
-function Invoke-OpenclawRepoBuild {
-    param([string]$RepoDir)
-    if (-not (Test-Path -LiteralPath $RepoDir)) {
-        Log-Error "Repo directory missing: $RepoDir"
-        throw "missing repo dir"
-    }
-    if (-not (Ensure-Pnpm)) {
-        Log-Error "pnpm is required to build OpenClaw from a git checkout"
-        throw "pnpm missing"
-    }
-    $lock = Join-Path $RepoDir "pnpm-lock.yaml"
-    if (-not (Test-Path $lock)) {
-        Log-Error "pnpm-lock.yaml missing in $RepoDir"
-        throw "missing pnpm-lock.yaml"
-    }
-    Push-Location $RepoDir
-    try {
-        $previousCi = $env:CI
-        try {
-            $env:CI = "true"
-            Invoke-WithPreferredWindowsBash {
-                Log-Info "pnpm install..."
-                pnpm install
-                if ($LASTEXITCODE -ne 0) { throw "pnpm install failed (exit $LASTEXITCODE)" }
-                Log-Info "pnpm build..."
-                pnpm build
-                if ($LASTEXITCODE -ne 0) { throw "pnpm build failed (exit $LASTEXITCODE)" }
-                Log-Info "pnpm ui:build..."
-                pnpm ui:build
-                if ($LASTEXITCODE -ne 0) { throw "pnpm ui:build failed (exit $LASTEXITCODE)" }
-            }
-        } finally {
-            if ($null -eq $previousCi) {
-                Remove-Item Env:CI -ErrorAction SilentlyContinue
-            } else {
-                $env:CI = $previousCi
-            }
-        }
-    } finally {
-        Pop-Location
-    }
-}
-
-# ============================================================================
-# Check installed components
-# ============================================================================
-function Check-Installed {
-    Log-Step "Checking installed components..."
-
-    $allOk = $true
-
-    # hippoclaw binary
-    $hippoclawBin = Resolve-HippoclawBinary
-    if ($hippoclawBin) {
-        try {
-            $ocVersion = (& $hippoclawBin --version 2>$null | Select-Object -First 1)
-            Log-Success "hippoclaw installed: $ocVersion"
-        } catch {
-            Log-Success "hippoclaw installed at $hippoclawBin"
-        }
-    } else {
-        Log-Warn "hippoclaw not installed"
-        $allOk = $false
-    }
-
-    try {
-        $npmRoot = (npm root -g 2>$null).Trim()
-        $groot = Join-Path $npmRoot "openclaw"
-        $entryMjs = Join-Path $groot "dist\entry.mjs"
-        $entryJs = Join-Path $groot "dist\entry.js"
-        if ((Test-Path $entryMjs) -or (Test-Path $entryJs)) {
-            Log-Success ("CLI dist present (" + $groot + "\dist\entry.*)")
-        } else {
-            Log-Warn "CLI dist missing (reinstall from npm or rerun setup with source build)"
-            $allOk = $false
-        }
-        $uiDir = Join-Path $groot "dist\control-ui"
-        if (Test-Path (Join-Path $uiDir "index.html")) {
-            Log-Success "Web UI built ($uiDir)"
-        } else {
-            Log-Warn "Web UI not built"
-            $allOk = $false
-        }
-    } catch {
-        Log-Warn "Could not verify global openclaw dist (npm root?)"
-        $allOk = $false
-    }
-
-    # Gateway running?
-    try {
-        $tcp = New-Object System.Net.Sockets.TcpClient
-        $tcp.Connect("127.0.0.1", $Port)
-        $tcp.Close()
-        Log-Success "Gateway running on port $Port"
-    } catch {
-        Log-Warn "Gateway not running on port $Port"
-    }
-
-    # Config file
-    $configPath = Join-Path $env:USERPROFILE ".openclaw\openclaw.json"
-    if (Test-Path $configPath) {
-        Log-Success "Config file present ($configPath)"
-    } else {
-        Log-Warn "Config file not found ($configPath)"
-    }
-
-    Write-Host ""
-    if ($allOk) {
-        Write-Host "Gateway is fully installed!" -ForegroundColor Green
-    } else {
-        Write-Host "Gateway setup is incomplete." -ForegroundColor Yellow
-    }
-
-    return $allOk
-}
-
-# ============================================================================
-# Install gateway
-# ============================================================================
-function Install-Gateway {
-    if (-not $Source) {
-        Log-Error "No install source specified. Use -Source <source>"
-        exit 1
-    }
-
-    $script:RemoteGatewayCloneSrc = $null
-    $script:RemoteGatewayWorkDir = $null
-
-    Log-Step "Installing OpenClaw Gateway..."
-    Log-Info "Source: $Source"
-
-    $npmRoot = $null
-    try {
-        $npmRoot = (npm root -g 2>$null).Trim()
-    } catch { }
-
-    if ($npmRoot -and (Test-Path (Join-Path $npmRoot "openclaw"))) {
-        Log-Info "Removing existing global openclaw tree (avoids partial install)..."
-        Remove-Item -Recurse -Force (Join-Path $npmRoot "openclaw") -ErrorAction SilentlyContinue
-    }
-
-    $isLocal = Test-InstallSourceLocal -S $Source
-
-    try {
-        if (Test-SourceNeedsBuild -S $Source) {
-            if ($isLocal) {
-                $absSrc = (Resolve-Path -LiteralPath $Source).Path
-                try {
-                    Invoke-OpenclawRepoBuild -RepoDir $absSrc
-                } catch {
-                    Log-Error "OpenClaw source build failed: $_"
-                    exit 1
-                }
-                npm install -g $absSrc
-                if ($LASTEXITCODE -ne 0) {
-                    Log-Error "npm install failed"
-                    exit 1
-                }
-            } else {
-                Install-OpenclawFromRemoteGitSpec -Spec $Source
-            }
-        } else {
-            npm install -g $Source
-            if ($LASTEXITCODE -ne 0) {
-                Log-Error "npm install failed"
-                exit 1
-            }
-        }
-        Log-Success "npm install complete"
-
-        if (Test-SourceNeedsBuild -S $Source) {
-            Log-Info "OpenClaw built from source; global install includes dist/."
-        } else {
-            Log-Info "Published package -- web UI should be pre-built"
-        }
-    } finally {
-        if ($script:RemoteGatewayWorkDir -and (Test-Path $script:RemoteGatewayWorkDir)) {
-            Remove-Item -Recurse -Force $script:RemoteGatewayWorkDir -ErrorAction SilentlyContinue
-        }
-        $script:RemoteGatewayWorkDir = $null
-        $script:RemoteGatewayCloneSrc = $null
-    }
-}
-
-function Test-GatewayPortOpen([int]$ListenPort) {
-    try {
-        $tcp = New-Object System.Net.Sockets.TcpClient
-        $tcp.Connect("127.0.0.1", $ListenPort)
-        $tcp.Close()
-        return $true
-    } catch { return $false }
-}
-
-function Stop-ListenersOnGatewayPort([int]$ListenPort) {
-    if (-not (Test-GatewayPortOpen $ListenPort)) { return }
-    Log-Info "Port $ListenPort still in use - stopping listener process(es)..."
-    try {
-        $conns = Get-NetTCPConnection -LocalPort $ListenPort -State Listen -ErrorAction SilentlyContinue
-        foreach ($c in $conns) {
-            Stop-Process -Id $c.OwningProcess -Force -ErrorAction SilentlyContinue
-        }
-    } catch { }
-}
-
-function Stop-OrphanGatewayListenersOnPorts {
-    Log-Step "Clearing local gateway listener(s) if still bound..."
-    $pidPath = Join-Path $env:USERPROFILE ".openclaw\gateway.pid"
-    Remove-Item -Path $pidPath -ErrorAction SilentlyContinue
-    $sweepPorts = @($Port)
-    if ($Port -ne 18789) { $sweepPorts += 18789 }
-    foreach ($sp in ($sweepPorts | Select-Object -Unique)) {
-        Stop-ListenersOnGatewayPort $sp
-    }
-    Start-Sleep -Seconds 1
-    $anyUp = $false
-    foreach ($sp in ($sweepPorts | Select-Object -Unique)) {
-        if (Test-GatewayPortOpen $sp) { $anyUp = $true; break }
-    }
-    if ($anyUp) {
-        Log-Warn "A process may still be listening on 127.0.0.1 (ports: $($sweepPorts -join ', '))"
-    } else {
-        Log-Success "Gateway port(s) free on 127.0.0.1 ($($sweepPorts -join ', '))"
-    }
-}
-
-function Invoke-HippoclawUninstallService {
-    $hippoclawBin = Resolve-HippoclawBinary
-    if (-not $hippoclawBin) { return }
-    Log-Step "hippoclaw CLI: uninstall gateway service..."
-    Log-Info "Running: $hippoclawBin uninstall --service --yes --non-interactive"
-    $prevEap = $ErrorActionPreference
-    $ErrorActionPreference = "Continue"
-    try {
-        & $hippoclawBin uninstall --service --yes --non-interactive
-    } catch { }
-    $ErrorActionPreference = $prevEap
-    if ($LASTEXITCODE -eq 0) {
-        Log-Success "hippoclaw uninstall --service completed"
-    } else {
-        Log-Info "hippoclaw uninstall --service failed or skipped (continuing)"
-    }
-}
-
-function Uninstall-Gateway {
-    Invoke-HippoclawUninstallService
-    Write-Host ""
-    Log-Step "Uninstalling OpenClaw (global npm package)..."
-    npm uninstall -g openclaw 2>$null
-    if ($LASTEXITCODE -ne 0) {
-        Log-Warn "npm uninstall returned exit code $LASTEXITCODE (package may not have been installed)"
-    }
-    Log-Success "Ran: npm uninstall -g openclaw (global tree removed if present)"
-    Log-Info "~/.openclaw was not removed (config, sessions, and credentials stay on disk)."
-    Write-Host ""
-    Stop-OrphanGatewayListenersOnPorts
-}
-
-# ============================================================================
-# Write starter config
-# ============================================================================
-function Write-Config {
-    $configPath = Join-Path $env:USERPROFILE ".openclaw\openclaw.json"
-
-    if (Test-Path $configPath) {
-        Log-Info "Config already exists at $configPath -- skipping"
-        return
-    }
-
-    Log-Step "Writing starter config..."
-    $configDir = Split-Path $configPath -Parent
-    New-Item -ItemType Directory -Path $configDir -Force | Out-Null
-
-    if ($ConfigTemplate -and (Test-Path $ConfigTemplate)) {
-        Copy-Item -Path $ConfigTemplate -Destination $configPath -Force
-        Log-Success "Config written from template: $configPath"
-        return
-    }
-
-    # Convert user-facing bind values to the gateway's current bind modes.
-    $bindMode = Resolve-GatewayBindMode -BindValue $Bind
-
-    # Build auth line
-    $authLine = ""
-    if ($Token) {
-        $authLine = ('"auth": { "token": "{0}" },' -f $Token)
-    }
-
-    $configContent = @"
-// OpenClaw Gateway Configuration (JSON5)
-// Docs: https://docs.openclaw.ai/configuration
-// Created by: setup-gateway-server.ps1
-{
-  "gateway": {
-    "mode": "local",
-    "port": $Port,
-    "bind": "$bindMode",
-    $authLine
-    "controlUi": { "enabled": true }
-  },
-  "bindings": [],
-  "channels": {},
-  "plugins": { "entries": {} },
-  "commands": { "nativeSkills": false },
-  "session": { "dmScope": "per-peer" },
-  "agents": { "defaults": { "maxConcurrent": 4 } }
-}
-"@
-
-    Set-Content -Path $configPath -Value $configContent -Encoding UTF8
-    Log-Success "Config written: $configPath"
-}
-
-# ============================================================================
-# Start gateway (nohup background)
-# ============================================================================
-function Start-Gateway {
-    # Check if already running
-    try {
-        $tcp = New-Object System.Net.Sockets.TcpClient
-        $tcp.Connect("127.0.0.1", $Port)
-        $tcp.Close()
-        Log-Info "Gateway already running on port $Port"
-        return
-    } catch { }
-
-    Log-Step "Starting gateway..."
-
-    $hippoclawBin = Resolve-HippoclawBinary
-    if (-not $hippoclawBin) {
-        Log-Error "hippoclaw binary not found in PATH or common locations"
-        return
-    }
-
-    $gatewayDir = Join-Path $env:USERPROFILE ".openclaw"
-    New-Item -ItemType Directory -Path $gatewayDir -Force | Out-Null
-    $logFile = Join-Path $gatewayDir "gateway.log"
-    $errorLogFile = Join-Path $gatewayDir "gateway.stderr.log"
-    $pidPath = Join-Path $gatewayDir "gateway.pid"
-    $bindMode = Resolve-GatewayBindMode -BindValue $Bind
-    $gatewayArgs = @("gateway", "run", "--bind", $bindMode, "--port", "$Port", "--force")
-    $startCommand = Get-HippoclawStartCommand -BinaryPath $hippoclawBin -CliArgs $gatewayArgs
-    Remove-Item -Path $pidPath -ErrorAction SilentlyContinue
-    $process = Start-Process -FilePath $startCommand.FilePath -ArgumentList $startCommand.ArgumentList -WindowStyle Hidden -RedirectStandardOutput $logFile -RedirectStandardError $errorLogFile -PassThru
-
-    # Wait for it to come up
-    $retries = 10
-    while ($retries -gt 0) {
-        try {
-            $tcp = New-Object System.Net.Sockets.TcpClient
-            $tcp.Connect("127.0.0.1", $Port)
-            $tcp.Close()
-            $listenerPid = $null
-            try {
-                $listenerPid = Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue |
-                    Select-Object -ExpandProperty OwningProcess -Unique |
-                    Select-Object -First 1
-            } catch { }
-            if (-not $listenerPid) {
-                $listenerPid = $process.Id
-            }
-            Set-Content -Path $pidPath -Value "$listenerPid" -Encoding ascii
-            Log-Success "Gateway started (pid=$listenerPid, port=$Port)"
-            return
-        } catch { }
-        Start-Sleep -Seconds 1
-        $retries--
-    }
-
-    Log-Warn "Gateway may not have started. Check: Get-Content $logFile -Wait"
-    Log-Info "stderr log: $errorLogFile"
-}
-
-# ============================================================================
-# Print connection info
-# ============================================================================
-function Print-ConnectionInfo {
-    Log-Step "Connection info"
-
-    $gatewayHost = Resolve-GatewayDisplayHost -BindValue $Bind
-
-    Write-Host ""
-    Write-Host ("  Gateway URL:  ws://{0}:{1}" -f $gatewayHost, $Port) -ForegroundColor White
-    if ($Token) {
-        Write-Host "  Auth token:   $Token" -ForegroundColor White
-    }
-    Write-Host ("  Web UI:       http://{0}:{1}" -f $gatewayHost, $Port) -ForegroundColor White
-    Write-Host ""
-    Write-Host "  Connect from AgentHippo CLI:" -ForegroundColor Cyan
-    Write-Host ("    setx OPENCLAW_GATEWAY_URL ws://{0}:{1}" -f $gatewayHost, $Port)
-    if ($Token) {
-        Write-Host "    setx OPENCLAW_GATEWAY_TOKEN $Token"
-    }
-    Write-Host "    agenthippo serve -a myagent --bind telegram,whatsapp"
-    Write-Host ""
-}
-
-# ============================================================================
-# Main
-# ============================================================================
-
-Write-Host ""
-Write-Host "  =======================================" -ForegroundColor Cyan
-Write-Host "    AgentHippo Gateway (Server)" -ForegroundColor Cyan
-Write-Host "    Reach your agents from anywhere" -ForegroundColor Cyan
-Write-Host "  =======================================" -ForegroundColor Cyan
-Write-Host ""
-
-if ($Check) {
-    $result = Check-Installed
-    if ($result) { exit 0 } else { exit 1 }
-}
-
-if ($Reinstall) {
-    if (-not $Source) {
-        Log-Error "-Reinstall requires -Source <src>"
-        exit 1
-    }
-    Log-Step "Reinstall: uninstall -> verify -> install"
-    Uninstall-Gateway
-    Write-Host ""
-    Log-Step "Post-uninstall verification (-Check)..."
-    Check-Installed | Out-Null
-    Write-Host ""
-    if (-not (Check-Prerequisites)) {
-        Write-Host ""
-        Log-Error "Prerequisites not met. Install the missing tools and try again."
-        exit 1
-    }
-    Write-Host ""
-    Install-Gateway
-    Write-Config
-    if (-not $NoStart) {
-        Start-Gateway
-    }
-    Write-Host ""
-    Check-Installed | Out-Null
-    Print-ConnectionInfo
-    Write-Host "Reinstall complete." -ForegroundColor White
-    Write-Host ""
-    exit 0
-}
-
-if ($Uninstall) {
-    Uninstall-Gateway
-    Write-Host ""
-    Check-Installed | Out-Null
-    exit 0
-}
-
-# Prerequisites
-if (-not (Check-Prerequisites)) {
-    Write-Host ""
-    Log-Error "Prerequisites not met. Install the missing tools and try again."
-    exit 1
-}
-
-# Install if not present
-if (-not (Resolve-HippoclawBinary)) {
-    Write-Host ""
-    Install-Gateway
-}
-
-# Write config if missing
-Write-Config
-
-# Start the gateway
-if (-not $NoStart) {
-    Start-Gateway
-}
-
-# Final status
-Write-Host ""
-Check-Installed | Out-Null
-
-# Print connection info
-Print-ConnectionInfo
-
-$webUiHost = Resolve-GatewayDisplayHost -BindValue $Bind
-Write-Host "Done! Next steps:" -ForegroundColor White
-Write-Host ("  1. Set up channels: open http://{0}:{1} or edit ~\\.openclaw\\openclaw.json" -f $webUiHost, $Port)
-Write-Host "  2. Connect your agent: agenthippo serve -a myagent --bind telegram"
-Write-Host ""