@aiwerk/mcp-bridge 1.0.0

package/scripts/install-server.ps1

@@ -0,0 +1,300 @@
+$ErrorActionPreference = "Stop"
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$OpenclawDir = Join-Path $env:USERPROFILE ".openclaw"
+$EnvFile = Join-Path $OpenclawDir ".env"
+$OpenclawJson = Join-Path $OpenclawDir "openclaw.json"
+
+if ($args.Count -eq 0) {
+    Write-Host "Usage: install-server.ps1 <server-name> [--dry-run] [--remove]"
+    Write-Host ""
+    Write-Host "Available servers:"
+    Get-ChildItem -Path (Join-Path $ScriptDir "servers") -Directory | ForEach-Object { Write-Host "  - $($_.Name)" }
+    exit 1
+}
+
+$ServerName = $args[0]
+$DryRun = $args -contains "--dry-run"
+$Remove = $args -contains "--remove"
+
+$ServerDir = Join-Path $ScriptDir "servers\$ServerName"
+if (-not (Test-Path $ServerDir)) {
+    Write-Host "Error: Server '$ServerName' not found."
+    Get-ChildItem -Path (Join-Path $ScriptDir "servers") -Directory | ForEach-Object { Write-Host "  - $($_.Name)" }
+    exit 1
+}
+
+$ServerTitle = ($ServerName -replace '-', ' ' -split ' ' | ForEach-Object { if ($_.Length -gt 0) { $_.Substring(0,1).ToUpper() + $_.Substring(1) } }) -join ' '
+$ServerConfigFile = Join-Path $ServerDir "config.json"
+$EnvVarsFile = Join-Path $ServerDir "env_vars"
+
+function Require-Command {
+    param([string]$Name)
+    if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+        throw "Missing required command: $Name"
+    }
+}
+
+function Get-TokenUrl {
+    switch ($ServerName) {
+        "apify"       { "https://console.apify.com/settings/integrations" }
+        "github"      { "https://github.com/settings/tokens" }
+        "google-maps" { "https://console.cloud.google.com/apis/credentials" }
+        "hetzner"     { "https://console.hetzner.cloud/" }
+        "hostinger"   { "https://hpanel.hostinger.com/api" }
+        "linear"      { "https://linear.app/settings/api" }
+        "miro"        { "https://miro.com/app/settings/user-profile/apps" }
+        "notion"      { "https://www.notion.so/my-integrations" }
+        "stripe"      { "https://dashboard.stripe.com/apikeys" }
+        "tavily"      { "https://app.tavily.com/home" }
+        "todoist"     { "https://app.todoist.com/app/settings/integrations/developer" }
+        "wise"        { "https://wise.com/settings/api-tokens" }
+        default       { "" }
+    }
+}
+
+function Check-Prerequisites {
+    switch ($ServerName) {
+        "github"  { Require-Command docker }
+        "linear"  { Require-Command node; Require-Command npm }
+        { $_ -in "wise","hetzner" } { Require-Command git; Require-Command node; Require-Command npm }
+        default   { Require-Command node; Require-Command npx }
+    }
+}
+
+function Install-Dependencies {
+    switch ($ServerName) {
+        "github" {
+            Write-Host "Pulling GitHub MCP server Docker image..."
+            docker pull ghcr.io/github/github-mcp-server | Out-Host
+        }
+        "linear" {
+            Write-Host "Installing @anthropic-pb/linear-mcp-server globally..."
+            npm install -g @anthropic-pb/linear-mcp-server | Out-Host
+        }
+        "wise" {
+            $cloneDir = Join-Path $ServerDir "mcp-server"
+            if (Test-Path (Join-Path $cloneDir ".git")) {
+                Write-Host "Updating wise mcp-server..."
+                git -C $cloneDir pull --ff-only | Out-Host
+            } else {
+                Write-Host "Cloning wise mcp-server..."
+                git clone https://github.com/Szotasz/wise-mcp.git $cloneDir | Out-Host
+            }
+            Push-Location $cloneDir
+            npm install | Out-Host; npm run build | Out-Host
+            Pop-Location
+        }
+        "hetzner" {
+            $cloneDir = Join-Path $ServerDir "mcp-server"
+            if (Test-Path (Join-Path $cloneDir ".git")) {
+                Write-Host "Updating hetzner mcp-server..."
+                git -C $cloneDir pull --ff-only | Out-Host
+            } else {
+                Write-Host "Cloning hetzner mcp-server..."
+                git clone https://github.com/dkruyt/mcp-hetzner.git $cloneDir | Out-Host
+            }
+            Push-Location $cloneDir
+            npm install | Out-Host; npm run build | Out-Host
+            Pop-Location
+        }
+    }
+}
+
+function Get-PathOverride {
+    switch ($ServerName) {
+        "linear" {
+            $npmRoot = npm root -g
+            $distPath = Join-Path $npmRoot "@anthropic-pb/linear-mcp-server\dist\index.js"
+            $buildPath = Join-Path $npmRoot "@anthropic-pb/linear-mcp-server\build\index.js"
+            if (Test-Path $distPath) { return $distPath }
+            if (Test-Path $buildPath) { return $buildPath }
+            return $distPath
+        }
+        "wise"    { return (Join-Path $ServerDir "mcp-server\dist\cli.js") }
+        "hetzner" { return (Join-Path $ServerDir "mcp-server\dist\index.js") }
+        default   { return "" }
+    }
+}
+
+function Ensure-Property {
+    param($Object, [string]$Name, $DefaultValue)
+    if (-not ($Object.PSObject.Properties.Name -contains $Name)) {
+        $Object | Add-Member -NotePropertyName $Name -NotePropertyValue $DefaultValue
+    }
+    return $Object.$Name
+}
+
+# ========================================
+# REMOVE MODE
+# ========================================
+if ($Remove) {
+    Write-Host "========================================"
+    Write-Host "Removing $ServerTitle MCP Server"
+    Write-Host "========================================"
+
+    if (-not (Test-Path $OpenclawJson)) {
+        Write-Host "❌ Config not found: $OpenclawJson" -ForegroundColor Red
+        exit 1
+    }
+
+    $cfg = Get-Content $OpenclawJson -Raw | ConvertFrom-Json
+    $servers = $cfg.plugins.entries.'openclaw-mcp-bridge'.config.servers
+    if (-not ($servers.PSObject.Properties.Name -contains $ServerName)) {
+        Write-Host "ℹ️  Server '$ServerName' not found in config. Nothing to remove." -ForegroundColor Yellow
+        exit 0
+    }
+
+    # Backup
+    $backupFile = "$OpenclawJson.bak-$(Get-Date -Format 'yyyyMMddHHmmss')"
+    Copy-Item $OpenclawJson $backupFile
+    Write-Host "Backup: $backupFile"
+
+    # Remove server entry
+    $servers.PSObject.Properties.Remove($ServerName)
+    $cfg | ConvertTo-Json -Depth 10 | Set-Content $OpenclawJson -Encoding UTF8
+    Write-Host "✅ Removed $ServerName from config" -ForegroundColor Green
+    Write-Host "ℹ️  Server recipe kept in servers\$ServerName\ (reinstall anytime)" -ForegroundColor Cyan
+
+    # Remove env var from .env
+    $envVarsFile = Join-Path $ServerDir "env_vars"
+    if ((Test-Path $envVarsFile) -and (Test-Path $EnvFile)) {
+        $envVarName = (Get-Content $envVarsFile -TotalCount 1).Trim()
+        $envContent = Get-Content $EnvFile
+        $filtered = $envContent | Where-Object { $_ -notmatch "^$envVarName=" }
+        if ($filtered.Count -lt $envContent.Count) {
+            $filtered | Set-Content $EnvFile -Encoding UTF8
+            Write-Host "🔑 Removed $envVarName from $EnvFile" -ForegroundColor Green
+        }
+    }
+
+    $restart = Read-Host "Restart gateway now? [Y/n]"
+    if ([string]::IsNullOrEmpty($restart) -or $restart -match '^[Yy]$') {
+        try {
+            Restart-Service openclaw-gateway -ErrorAction Stop
+            Write-Host "✅ Gateway restarted. $ServerTitle removed." -ForegroundColor Green
+        } catch {
+            Write-Host "⚠️  Auto-restart failed. Run: Restart-Service openclaw-gateway" -ForegroundColor Yellow
+        }
+    } else {
+        Write-Host "⏭️  Run manually: Restart-Service openclaw-gateway"
+    }
+    exit 0
+}
+
+# ========================================
+# INSTALL MODE
+# ========================================
+Write-Host "========================================"
+Write-Host "Installing $ServerTitle MCP Server"
+Write-Host "========================================"
+
+if ($DryRun) {
+    Write-Host "[DRY RUN] Server: $ServerName"
+    if (Test-Path $EnvVarsFile) { Write-Host "[DRY RUN] Env var: $(Get-Content $EnvVarsFile -TotalCount 1)" }
+    Write-Host "[DRY RUN] Config:"; Get-Content $ServerConfigFile
+    exit 0
+}
+
+if (-not (Test-Path $EnvVarsFile)) { throw "Missing env_vars file in $ServerDir" }
+
+$EnvVarName = (Get-Content $EnvVarsFile -TotalCount 1).Trim()
+if ([string]::IsNullOrWhiteSpace($EnvVarName)) { throw "env_vars file does not contain a variable name" }
+
+# 1. Prerequisites
+Check-Prerequisites
+
+# 2. Dependencies
+Install-Dependencies
+
+# 3. Get API token
+$tokenUrl = Get-TokenUrl
+if ($tokenUrl) { Write-Host "Get your API token here: $tokenUrl" }
+
+$Token = ""
+while ([string]::IsNullOrWhiteSpace($Token)) {
+    $Token = Read-Host "Enter your $ServerTitle API token"
+    if ([string]::IsNullOrWhiteSpace($Token)) { Write-Host "Token cannot be empty." }
+}
+
+# 4. Write to .env
+New-Item -ItemType Directory -Force -Path $OpenclawDir | Out-Null
+if (-not (Test-Path $EnvFile)) { New-Item -ItemType File -Force -Path $EnvFile | Out-Null }
+
+$envExists = Select-String -Path $EnvFile -Pattern "^$([regex]::Escape($EnvVarName))=" -Quiet
+if ($envExists) {
+    $overwrite = Read-Host "$EnvVarName already exists. Overwrite with new token? [y/N]"
+    if ($overwrite -match "^[Yy]$") {
+        $content = Get-Content $EnvFile | Where-Object { $_ -notmatch "^$([regex]::Escape($EnvVarName))=" }
+        Set-Content -Path $EnvFile -Value $content -Encoding UTF8
+        Add-Content -Path $EnvFile -Value "$EnvVarName=$Token"
+        Write-Host "Updated $EnvVarName in $EnvFile"
+    } else {
+        Write-Host "Keeping existing value."
+    }
+} else {
+    Add-Content -Path $EnvFile -Value "$EnvVarName=$Token"
+    Write-Host "Saved $EnvVarName to $EnvFile"
+}
+
+# 5. Backup and merge openclaw.json
+if (-not (Test-Path $OpenclawJson)) { Set-Content -Path $OpenclawJson -Value "{}" -Encoding UTF8 }
+
+$timestamp = Get-Date -Format "yyyyMMddHHmmss"
+Copy-Item -Path $OpenclawJson -Destination "$OpenclawJson.bak-$timestamp" -Force
+Write-Host "Backup: $OpenclawJson.bak-$timestamp"
+
+$cfgRaw = Get-Content -Path $OpenclawJson -Raw
+if ([string]::IsNullOrWhiteSpace($cfgRaw)) { $cfgRaw = "{}" }
+$cfg = $cfgRaw | ConvertFrom-Json
+$serverConfig = Get-Content -Path $ServerConfigFile -Raw | ConvertFrom-Json
+
+$pathOverride = Get-PathOverride
+if ($pathOverride -and $serverConfig.args -and $serverConfig.args.Count -gt 0) {
+    for ($i = 0; $i -lt $serverConfig.args.Count; $i++) {
+        if ($serverConfig.args[$i] -is [string] -and $serverConfig.args[$i].StartsWith("path/to/")) {
+            $serverConfig.args[$i] = $pathOverride
+        }
+    }
+}
+
+$plugins = Ensure-Property -Object $cfg -Name "plugins" -DefaultValue ([PSCustomObject]@{})
+$allow = Ensure-Property -Object $plugins -Name "allow" -DefaultValue @()
+if ($allow -notcontains "openclaw-mcp-bridge") { $plugins.allow = @($allow) + "openclaw-mcp-bridge" }
+$entries = Ensure-Property -Object $plugins -Name "entries" -DefaultValue ([PSCustomObject]@{})
+
+if (-not ($entries.PSObject.Properties.Name -contains "openclaw-mcp-bridge")) {
+    $entries | Add-Member -NotePropertyName "openclaw-mcp-bridge" -NotePropertyValue ([PSCustomObject]@{})
+}
+$mcpClient = $entries."openclaw-mcp-bridge"
+if (-not ($mcpClient.PSObject.Properties.Name -contains "enabled")) {
+    $mcpClient | Add-Member -NotePropertyName "enabled" -NotePropertyValue $true
+}
+$mcpConfig = Ensure-Property -Object $mcpClient -Name "config" -DefaultValue ([PSCustomObject]@{})
+if (-not ($mcpConfig.PSObject.Properties.Name -contains "toolPrefix")) { $mcpConfig | Add-Member -NotePropertyName "toolPrefix" -NotePropertyValue $true }
+if (-not ($mcpConfig.PSObject.Properties.Name -contains "reconnectIntervalMs")) { $mcpConfig | Add-Member -NotePropertyName "reconnectIntervalMs" -NotePropertyValue 30000 }
+if (-not ($mcpConfig.PSObject.Properties.Name -contains "connectionTimeoutMs")) { $mcpConfig | Add-Member -NotePropertyName "connectionTimeoutMs" -NotePropertyValue 10000 }
+if (-not ($mcpConfig.PSObject.Properties.Name -contains "requestTimeoutMs")) { $mcpConfig | Add-Member -NotePropertyName "requestTimeoutMs" -NotePropertyValue 60000 }
+$servers = Ensure-Property -Object $mcpConfig -Name "servers" -DefaultValue ([PSCustomObject]@{})
+
+if ($servers.PSObject.Properties.Name -contains $ServerName) {
+    $servers.PSObject.Properties.Remove($ServerName)
+}
+$servers | Add-Member -NotePropertyName $ServerName -NotePropertyValue $serverConfig
+
+$cfg | ConvertTo-Json -Depth 30 | Set-Content -Path $OpenclawJson -Encoding UTF8
+Write-Host "Configuration merged for: $ServerName"
+
+# 6. Gateway restart
+Write-Host ""
+$restart = Read-Host "Restart gateway now? [Y/n]"
+if ([string]::IsNullOrWhiteSpace($restart) -or $restart -match "^[Yy]$") {
+    try {
+        openclaw gateway restart 2>$null
+        Write-Host "Gateway restarting... Check 'openclaw gateway status' in a moment."
+    } catch {
+        Write-Host "Could not restart automatically. Run: openclaw gateway restart"
+    }
+} else {
+    Write-Host "Run manually: openclaw gateway restart"
+}

package/scripts/install-server.sh

@@ -0,0 +1,357 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+OPENCLAW_DIR="${HOME}/.openclaw"
+OPENCLAW_JSON="${OPENCLAW_DIR}/openclaw.json"
+ENV_FILE="${OPENCLAW_DIR}/.env"
+
+usage() {
+    echo "Usage: $0 <server-name> [--dry-run] [--remove]"
+    echo ""
+    echo "Available servers:"
+    for server_dir in "$SCRIPT_DIR/servers"/*; do
+        [[ -d "$server_dir" ]] && echo "  - $(basename "$server_dir")"
+    done
+    exit 1
+}
+
+[[ $# -eq 0 ]] && usage
+
+SERVER_NAME="$1"
+DRY_RUN=false
+REMOVE=false
+shift
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --dry-run) DRY_RUN=true ;;
+        --remove)  REMOVE=true ;;
+    esac
+    shift
+done
+
+SERVER_DIR="$SCRIPT_DIR/servers/$SERVER_NAME"
+if [[ ! -d "$SERVER_DIR" ]]; then
+    echo "Error: Server '$SERVER_NAME' not found."
+    usage
+fi
+
+SERVER_TITLE="$(tr '-' ' ' <<<"$SERVER_NAME" | awk '{for(i=1;i<=NF;i++){$i=toupper(substr($i,1,1))substr($i,2)};print}')"
+SERVER_CONFIG_FILE="$SERVER_DIR/config.json"
+ENV_VARS_FILE="$SERVER_DIR/env_vars"
+
+require_cmd() {
+    if ! command -v "$1" >/dev/null 2>&1; then
+        echo "❌ Missing required command: $1"
+        exit 1
+    fi
+}
+
+get_token_url() {
+    case "$SERVER_NAME" in
+        apify)       echo "https://console.apify.com/settings/integrations" ;;
+        github)      echo "https://github.com/settings/tokens" ;;
+        google-maps) echo "https://console.cloud.google.com/apis/credentials" ;;
+        hetzner)     echo "https://console.hetzner.cloud/" ;;
+        hostinger)   echo "https://hpanel.hostinger.com/api" ;;
+        linear)      echo "https://linear.app/settings/api" ;;
+        miro)        echo "https://miro.com/app/settings/user-profile/apps" ;;
+        notion)      echo "https://www.notion.so/my-integrations" ;;
+        stripe)      echo "https://dashboard.stripe.com/apikeys" ;;
+        tavily)      echo "https://app.tavily.com/home" ;;
+        todoist)     echo "https://app.todoist.com/app/settings/integrations/developer" ;;
+        wise)        echo "https://wise.com/settings/api-tokens" ;;
+        *)           echo "" ;;
+    esac
+}
+
+check_prerequisites() {
+    case "$SERVER_NAME" in
+        github)
+            require_cmd docker ;;
+        linear|wise|hetzner)
+            require_cmd node; require_cmd npm ;;
+        *)
+            require_cmd node; require_cmd npx ;;
+    esac
+}
+
+install_dependencies() {
+    case "$SERVER_NAME" in
+        github)
+            echo "Pulling GitHub MCP server Docker image..."
+            docker pull ghcr.io/github/github-mcp-server ;;
+        linear)
+            echo "Installing @anthropic-pb/linear-mcp-server globally..."
+            npm install -g @anthropic-pb/linear-mcp-server ;;
+        wise)
+            local clone_dir="$SERVER_DIR/mcp-server"
+            if [ -d "$clone_dir/.git" ]; then
+                echo "Updating wise mcp-server..."; git -C "$clone_dir" pull --ff-only
+            else
+                echo "Cloning wise mcp-server..."; git clone https://github.com/Szotasz/wise-mcp.git "$clone_dir"
+            fi
+            echo "Building wise mcp-server..."
+            (cd "$clone_dir" && npm install && npm run build) ;;
+        hetzner)
+            local clone_dir="$SERVER_DIR/mcp-server"
+            if [ -d "$clone_dir/.git" ]; then
+                echo "Updating hetzner mcp-server..."; git -C "$clone_dir" pull --ff-only
+            else
+                echo "Cloning hetzner mcp-server..."; git clone https://github.com/dkruyt/mcp-hetzner.git "$clone_dir"
+            fi
+            echo "Building hetzner mcp-server..."
+            (cd "$clone_dir" && npm install && npm run build) ;;
+    esac
+}
+
+resolve_path_override() {
+    case "$SERVER_NAME" in
+        linear)
+            local npm_root; npm_root="$(npm root -g)"
+            if [ -f "$npm_root/@anthropic-pb/linear-mcp-server/dist/index.js" ]; then
+                echo "$npm_root/@anthropic-pb/linear-mcp-server/dist/index.js"
+            else
+                echo "$npm_root/@anthropic-pb/linear-mcp-server/build/index.js"
+            fi ;;
+        wise)   echo "$SERVER_DIR/mcp-server/dist/cli.js" ;;
+        hetzner) echo "$SERVER_DIR/mcp-server/dist/index.js" ;;
+        *)      echo "" ;;
+    esac
+}
+
+# ========================================
+# REMOVE MODE
+# ========================================
+if [[ "$REMOVE" == "true" ]]; then
+    echo "========================================"
+    echo "Removing ${SERVER_TITLE} MCP Server"
+    echo "========================================"
+
+    if [[ ! -f "$OPENCLAW_JSON" ]]; then
+        echo "❌ Config not found: $OPENCLAW_JSON"
+        exit 1
+    fi
+
+    # Check if server exists in config
+    HAS_SERVER=$(python3 -c "
+import json
+with open('$OPENCLAW_JSON') as f:
+    cfg = json.load(f)
+servers = cfg.get('plugins',{}).get('entries',{}).get('openclaw-mcp-bridge',{}).get('config',{}).get('servers',{})
+print('yes' if '$SERVER_NAME' in servers else 'no')
+" 2>/dev/null)
+
+    if [[ "$HAS_SERVER" != "yes" ]]; then
+        echo "ℹ️  Server '$SERVER_NAME' not found in config. Nothing to remove."
+        exit 0
+    fi
+
+    # Backup
+    BACKUP_FILE="${OPENCLAW_JSON}.bak-$(date +%Y%m%d%H%M%S)"
+    cp "$OPENCLAW_JSON" "$BACKUP_FILE"
+    echo "Backup: ${BACKUP_FILE}"
+
+    # Remove server entry from config (keep servers/<name>/ directory)
+    python3 -c "
+import json
+with open('$OPENCLAW_JSON') as f:
+    cfg = json.load(f)
+servers = cfg['plugins']['entries']['openclaw-mcp-bridge']['config']['servers']
+del servers['$SERVER_NAME']
+with open('$OPENCLAW_JSON', 'w') as f:
+    json.dump(cfg, f, indent=2)
+    f.write('\n')
+print('✅ Removed $SERVER_NAME from config')
+print('ℹ️  Server recipe kept in servers/$SERVER_NAME/ (reinstall anytime)')
+" 2>/dev/null
+
+    # Remove env var from .env if exists
+    if [[ -f "$ENV_VARS_FILE" ]] && [[ -s "$ENV_VARS_FILE" ]] && [[ -f "$ENV_FILE" ]]; then
+        ENV_VAR_NAME="$(head -n 1 "$ENV_VARS_FILE" | tr -d '[:space:]')"
+        if grep -q "^${ENV_VAR_NAME}=" "$ENV_FILE" 2>/dev/null; then
+            sed -i "/^${ENV_VAR_NAME}=/d" "$ENV_FILE"
+            echo "🔑 Removed ${ENV_VAR_NAME} from ${ENV_FILE}"
+        fi
+    fi
+
+    # Restart
+    echo ""
+    RESTART="y"
+    if [ -e /dev/tty ]; then
+        read -r -p "Restart gateway now? [Y/n]: " RESTART </dev/tty
+    fi
+    if [[ -z "$RESTART" || "$RESTART" =~ ^[Yy]$ ]]; then
+        systemctl --user restart openclaw-gateway 2>/dev/null || {
+            echo "⚠️  Auto-restart failed. Run: systemctl --user restart openclaw-gateway"
+            exit 0
+        }
+        sleep 3
+        if systemctl --user is-active --quiet openclaw-gateway 2>/dev/null; then
+            echo "✅ Gateway restarted. ${SERVER_TITLE} removed."
+        else
+            echo "❌ Gateway failed to start! Restoring backup..."
+            cp "$BACKUP_FILE" "$OPENCLAW_JSON"
+            systemctl --user restart openclaw-gateway 2>/dev/null
+            echo "Restored from backup."
+        fi
+    else
+        echo "⏭️  Run manually: systemctl --user restart openclaw-gateway"
+    fi
+    exit 0
+fi
+
+# ========================================
+# INSTALL MODE
+# ========================================
+echo "========================================"
+echo "Installing ${SERVER_TITLE} MCP Server"
+echo "========================================"
+
+if [[ "$DRY_RUN" == "true" ]]; then
+    echo "[DRY RUN] Server: $SERVER_NAME"
+    [[ -f "$ENV_VARS_FILE" ]] && echo "[DRY RUN] Env var: $(cat "$ENV_VARS_FILE")"
+    echo "[DRY RUN] Config:"; cat "$SERVER_CONFIG_FILE"
+    exit 0
+fi
+
+# 1. Check prerequisites
+check_prerequisites
+
+# 2. Install server-specific dependencies
+install_dependencies
+
+# 3. Get API token
+if [[ -f "$ENV_VARS_FILE" ]] && [[ -s "$ENV_VARS_FILE" ]]; then
+    ENV_VAR_NAME="$(head -n 1 "$ENV_VARS_FILE" | tr -d '[:space:]')"
+
+    TOKEN_URL="$(get_token_url)"
+    [[ -n "$TOKEN_URL" ]] && echo "Get your API token here: ${TOKEN_URL}"
+
+    TOKEN=""
+    while [ -z "$TOKEN" ]; do
+        read -r -p "Enter your ${SERVER_TITLE} API token: " TOKEN </dev/tty
+        [[ -z "$TOKEN" ]] && echo "Token cannot be empty."
+    done
+
+    # Write to .env
+    mkdir -p "$OPENCLAW_DIR"
+    touch "$ENV_FILE"
+    chmod 600 "$ENV_FILE"
+
+    if grep -q "^${ENV_VAR_NAME}=" "$ENV_FILE" 2>/dev/null; then
+        echo "${ENV_VAR_NAME} already exists in ${ENV_FILE}."
+        read -r -p "Overwrite with new token? [y/N]: " OVERWRITE </dev/tty
+        if [[ "$OVERWRITE" =~ ^[Yy]$ ]]; then
+            sed -i "/^${ENV_VAR_NAME}=/d" "$ENV_FILE"
+            echo "${ENV_VAR_NAME}=${TOKEN}" >> "$ENV_FILE"
+            echo "✅ Updated ${ENV_VAR_NAME} in ${ENV_FILE}"
+        else
+            echo "Keeping existing value."
+        fi
+    else
+        echo "${ENV_VAR_NAME}=${TOKEN}" >> "$ENV_FILE"
+        echo "✅ Saved ${ENV_VAR_NAME} to ${ENV_FILE}"
+    fi
+fi
+
+# 4. Backup and merge openclaw.json
+mkdir -p "$(dirname "$OPENCLAW_JSON")"
+[[ ! -f "$OPENCLAW_JSON" ]] && echo "{}" > "$OPENCLAW_JSON"
+
+BACKUP_FILE="${OPENCLAW_JSON}.bak-$(date +%Y%m%d%H%M%S)"
+cp "$OPENCLAW_JSON" "$BACKUP_FILE"
+echo "Backup: ${BACKUP_FILE}"
+
+PATH_OVERRIDE="$(resolve_path_override)"
+
+python3 - "$OPENCLAW_JSON" "$SERVER_CONFIG_FILE" "$SERVER_NAME" "$PATH_OVERRIDE" <<'PY'
+import json, sys
+
+openclaw_path, server_cfg_path, server_name, path_override = sys.argv[1:5]
+
+with open(openclaw_path, "r", encoding="utf-8") as f:
+    raw = f.read().strip()
+    cfg = json.loads(raw) if raw else {}
+
+with open(server_cfg_path, "r", encoding="utf-8") as f:
+    server_cfg = json.load(f)
+
+if path_override:
+    args = server_cfg.get("args")
+    if isinstance(args, list):
+        for idx, value in enumerate(args):
+            if isinstance(value, str) and value.startswith("path/to/"):
+                args[idx] = path_override
+
+plugins = cfg.setdefault("plugins", {})
+allow = plugins.setdefault("allow", [])
+if "openclaw-mcp-bridge" not in allow:
+    allow.append("openclaw-mcp-bridge")
+entries = plugins.setdefault("entries", {})
+mcp_client = entries.setdefault("openclaw-mcp-bridge", {})
+mcp_client.setdefault("enabled", True)
+mcp_cfg = mcp_client.setdefault("config", {})
+mcp_cfg.setdefault("toolPrefix", True)
+mcp_cfg.setdefault("reconnectIntervalMs", 30000)
+mcp_cfg.setdefault("connectionTimeoutMs", 10000)
+mcp_cfg.setdefault("requestTimeoutMs", 60000)
+servers = mcp_cfg.setdefault("servers", {})
+servers[server_name] = server_cfg
+
+with open(openclaw_path, "w", encoding="utf-8") as f:
+    json.dump(cfg, f, indent=2)
+    f.write("\n")
+
+print(f"✅ Configuration merged for: {server_name}")
+PY
+
+# 5. Gateway restart
+echo ""
+read -r -p "Restart gateway now? [Y/n]: " RESTART </dev/tty
+if [[ -z "$RESTART" || "$RESTART" =~ ^[Yy]$ ]]; then
+    systemctl --user restart openclaw-gateway 2>/dev/null || {
+        echo "⚠️  Auto-restart failed. Run: systemctl --user restart openclaw-gateway"
+        exit 0
+    }
+    echo "Waiting for gateway startup..."
+    CONFIRMED=false
+    ROUTER_MODE=false
+    for i in 1 2 3 4 5 6; do
+        sleep 5
+        if ! systemctl --user is-active --quiet openclaw-gateway 2>/dev/null; then
+            echo "❌ Gateway failed to start!"
+            journalctl --user -u openclaw-gateway --since "1 min ago" --no-pager 2>/dev/null | grep -iE "error|fail|missing" | head -5
+            echo "Full logs: journalctl --user -u openclaw-gateway --since '1 min ago' --no-pager"
+            exit 1
+        fi
+        # Router mode: servers connect lazily, just check plugin loaded
+        if journalctl --user -u openclaw-gateway --since "1 min ago" --no-pager 2>/dev/null | grep -qi "Plugin activated with.*servers configured"; then
+            CONFIRMED=true
+            ROUTER_MODE=true
+            break
+        fi
+        # Direct mode: server connects at boot
+        if journalctl --user -u openclaw-gateway --since "1 min ago" --no-pager 2>/dev/null | grep -qi "Server ${SERVER_NAME} initialized"; then
+            CONFIRMED=true
+            break
+        fi
+        # Check if server explicitly failed
+        if journalctl --user -u openclaw-gateway --since "1 min ago" --no-pager 2>/dev/null | grep -qi "Startup failed: ${SERVER_NAME}"; then
+            echo "❌ ${SERVER_TITLE} MCP Server failed to start!"
+            journalctl --user -u openclaw-gateway --since "1 min ago" --no-pager 2>/dev/null | grep -i "$SERVER_NAME" | tail -5
+            exit 1
+        fi
+    done
+    if $CONFIRMED; then
+        if $ROUTER_MODE; then
+            echo "✅ ${SERVER_TITLE} configured! (Router mode — server connects on first use)"
+        else
+            echo "✅ ${SERVER_TITLE} MCP Server installed and running!"
+        fi
+    else
+        echo "⚠️  Gateway running but plugin not confirmed after 30s. Check: journalctl --user -u openclaw-gateway -f"
+    fi
+else
+    echo "⏭️  Run manually: systemctl --user restart openclaw-gateway"
+fi