Feat/install dir hint and volume conflict check (#15)

Author: johnlanni

install/hiclaw-install.ps1

@@ -636,6 +636,10 @@ function Install-Manager {
 
     Write-Log "Registry: $($script:HICLAW_REGISTRY)"
     Write-Log ""
+    Write-Log "Installation directory: $(Get-Location)"
+    Write-Log "  (The env file 'hiclaw-manager.env' will be created in this directory.)"
+    Write-Log "  (Run this script from the directory where you want to manage this installation.)"
+    Write-Log ""
 
     # Check Docker
     if (-not (Test-DockerRunning)) {
@@ -1078,6 +1082,31 @@ function Install-Manager {
         docker rm hiclaw-manager *>$null
     }
 
+    # Check if the Docker volume is already owned by a different installation directory
+    $volumeExists = docker volume ls -q 2>$null | Select-String "^$($config.DATA_DIR)$"
+    if ($volumeExists) {
+        $existingInstallPath = (docker volume inspect $config.DATA_DIR --format '{{index .Labels "hiclaw.install-path"}}' 2>$null) -join ""
+        $currentInstallPath = (Get-Location).Path
+        if ($existingInstallPath -and $existingInstallPath.Trim() -ne $currentInstallPath) {
+            Write-Host ""
+            Write-Host "`e[31m[HiClaw ERROR] Volume conflict detected!`e[0m"
+            Write-Host "`e[31m  Docker volume '$($config.DATA_DIR)' was created by a different installation:`e[0m"
+            Write-Host "`e[31m    Original install directory : $($existingInstallPath.Trim())`e[0m"
+            Write-Host "`e[31m    Current  install directory : $currentInstallPath`e[0m"
+            Write-Host ""
+            Write-Host "`e[33m  Each HiClaw installation must use its own Docker volume.`e[0m"
+            Write-Host "`e[33m  Options:`e[0m"
+            Write-Host "`e[33m    1. Run this script from the original directory: $($existingInstallPath.Trim())`e[0m"
+            Write-Host "`e[33m    2. Use a different volume name: `$env:HICLAW_DATA_DIR='hiclaw-data-2'; .\hiclaw-install.ps1`e[0m"
+            Write-Host "`e[33m    3. Perform a clean reinstall from the original directory (option 2 in the upgrade menu)`e[0m"
+            Write-Host ""
+            throw "Volume conflict: cannot reuse volume '$($config.DATA_DIR)' from a different installation directory."
+        }
+    } else {
+        # Create the volume with an install-path label so future installs can detect conflicts
+        docker volume create --label "hiclaw.install-path=$($(Get-Location).Path)" $config.DATA_DIR | Out-Null
+    }
+
     # Pull images (skip if already exists locally)
     # For local images (prefix "hiclaw/"), skip pull if exists
     # For remote images, always pull to get updates

install/hiclaw-install.sh

@@ -485,6 +485,10 @@ install_manager() {
     log "=== HiClaw Manager Installation ==="
     log "Registry: ${HICLAW_REGISTRY}"
     log ""
+    log "Installation directory: $(pwd)"
+    log "  (The env file 'hiclaw-manager.env' will be created in this directory.)"
+    log "  (Run this script from the directory where you want to manage this installation.)"
+    log ""
 
     # Onboarding mode selection (skip if already in non-interactive mode)
     if [ "${HICLAW_NON_INTERACTIVE}" != "1" ]; then
@@ -915,6 +919,31 @@ EOF
         docker rm hiclaw-manager 2>/dev/null || true
     fi
 
+    # Check if the Docker volume is already owned by a different installation directory
+    if docker volume ls -q | grep -q "^${HICLAW_DATA_DIR}$"; then
+        EXISTING_INSTALL_PATH=$(docker volume inspect "${HICLAW_DATA_DIR}" \
+            --format '{{index .Labels "hiclaw.install-path"}}' 2>/dev/null || true)
+        CURRENT_INSTALL_PATH="$(pwd)"
+        if [ -n "${EXISTING_INSTALL_PATH}" ] && [ "${EXISTING_INSTALL_PATH}" != "${CURRENT_INSTALL_PATH}" ]; then
+            echo ""
+            echo -e "\033[31m[HiClaw ERROR] Volume conflict detected!\033[0m" >&2
+            echo -e "\033[31m  Docker volume '${HICLAW_DATA_DIR}' was created by a different installation:\033[0m" >&2
+            echo -e "\033[31m    Original install directory : ${EXISTING_INSTALL_PATH}\033[0m" >&2
+            echo -e "\033[31m    Current  install directory : ${CURRENT_INSTALL_PATH}\033[0m" >&2
+            echo "" >&2
+            echo -e "\033[33m  Each HiClaw installation must use its own Docker volume.\033[0m" >&2
+            echo -e "\033[33m  Options:\033[0m" >&2
+            echo -e "\033[33m    1. Run this script from the original directory: ${EXISTING_INSTALL_PATH}\033[0m" >&2
+            echo -e "\033[33m    2. Use a different volume name: HICLAW_DATA_DIR=hiclaw-data-2 $0\033[0m" >&2
+            echo -e "\033[33m    3. Perform a clean reinstall from the original directory (option 2 in the upgrade menu)\033[0m" >&2
+            echo "" >&2
+            exit 1
+        fi
+    else
+        # Create the volume with an install-path label so future installs can detect conflicts
+        docker volume create --label "hiclaw.install-path=$(pwd)" "${HICLAW_DATA_DIR}" > /dev/null
+    fi
+
     # Data mount: Docker volume
     DATA_MOUNT_ARGS="-v ${HICLAW_DATA_DIR}:/data"
 

openclaw-base/Dockerfile

@@ -59,6 +59,11 @@ RUN git clone --depth 1 --single-branch \
     pnpm config set registry ${NPM_REGISTRY} && \
     pnpm install && \
     pnpm build && \
+    echo "==> Verifying critical native addons..." && \
+    ADDON_DIR=/opt/openclaw/node_modules/.pnpm/@matrix-org+matrix-sdk-crypto-nodejs@0.4.0/node_modules/@matrix-org/matrix-sdk-crypto-nodejs && \
+    ls "$ADDON_DIR"/matrix-sdk-crypto.linux-*.node 2>/dev/null | grep -q . \
+        || (echo "ERROR: matrix-sdk-crypto native addon missing (pnpm install may have silently failed on this arch)" && exit 1) && \
+    echo "==> Native addon check passed: $(ls $ADDON_DIR/matrix-sdk-crypto.linux-*.node)" && \
     rm -rf \
         .git .github \
         test \