@agenthippo-ai/agenthippo 0.1.0

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

@@ -0,0 +1,953 @@
+#
+# 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 ""