Switch to privileged LXC + LXQt desktop + Google Chrome

Replace unprivileged LXC/XFCE/Chromium setup with privileged LXC, LXQt desktop, and Google Chrome to support the OpenClaw browser extension (developer mode). Removes --no-sandbox workaround and XFCE desktop icon trust mechanism, adds Chrome .deb install and browser extension setup. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 12:34:10 +00:00
parent 4aa8b206b0
commit d869686e3b
3 changed files with 97 additions and 101 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,52 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+OpenClaw on Proxmox is a single-script deployment tool (`setup-openclaw-lxc.sh`) that automates creating a Proxmox LXC container with a fully configured OpenClaw AI assistant, LXQt desktop, Google Chrome, and VNC/noVNC remote access. It targets Proxmox VE 8.x+ hosts running as root.
+
+## Architecture
+
+The entire project is one ~460-line Bash script with this flow:
+
+1. **Pre-flight** — Verify Proxmox CLI tools (`pct`, `pvesh`, `pveam`) and root access
+2. **User prompts** — Collect container password, disk/memory/CPU/resolution settings
+3. **Auto-detection** — Find next VMID and storage backends via `pvesh` JSON + Python parsing
+4. **Template management** — Download Debian 13 template if missing
+5. **Container creation** — Privileged LXC, DHCP networking
+6. **Package installation** — Node.js 22, Homebrew (as non-root `brewuser`), OpenClaw (npm global), LXQt, TigerVNC, noVNC, Google Chrome, OpenClaw browser extension
+7. **Configuration** — OpenClaw gateway settings, VNC password/xstartup, noVNC auto-scaling patch, Chrome as default browser
+8. **Desktop integration** — Desktop shortcuts for onboarding wizard and dashboard
+9. **Systemd services** — Three auto-starting services: `openclaw-gateway` (port 18789), `vncserver` (:1/5901), `novnc` (port 6080)
+10. **Verification** — Check all services are active, print connection info
+
+Key helper: `ct_exec()` wraps `pct exec $VMID -- bash -c` for all in-container commands.
+
+## Development Notes
+
+- No build system, test suite, or linter — this is a standalone Bash script
+- Uses `set -euo pipefail` for strict error handling
+- All in-container operations use heredoc-embedded config files (systemd units, desktop files, wrapper scripts)
+- Colorized output via `info()`, `ok()`, `warn()`, `err()`, `fatal()` helper functions
+- Homebrew is installed under a dedicated `brewuser` account (non-root requirement) with a symlink at `/usr/local/bin/brew` for root access
+- The noVNC auto-scaling patch modifies `/usr/share/novnc/app/ui.js` in-place via `sed`
+- Auth token is generated with `openssl rand -hex 16`
+
+## Testing Changes
+
+There is no automated test infrastructure. To test changes, run the script on a Proxmox host:
+
+```bash
+bash setup-openclaw-lxc.sh
+```
+
+Verify by checking: container creation, all three systemd services running, noVNC web access, and OpenClaw dashboard reachability.
+
+## Shell Style
+
+- Bash with `set -euo pipefail`
+- Double-quoted variables throughout
+- Heredocs for multi-line content (both quoted `'EOF'` and unquoted `EOF` depending on variable expansion needs)
+- `grep -v` to suppress noisy apt/install output
+- Python3 one-liners for JSON parsing of Proxmox API output
--- a/README.md
+++ b/README.md
@@ -6,9 +6,9 @@ Deploy your own **[OpenClaw](https://openclaw.ai/) AI assistant** on any Proxmox

 - **Self-hosted AI assistant** — OpenClaw runs entirely on your hardware, under your control
 - **One command to deploy** — no manual package installation, no config file editing, no guesswork
- **Full remote desktop** — access a graphical XFCE desktop from any browser via noVNC
- **Ready-to-use browser** — Chromium pre-configured and set as default, works out of the box in LXC
- **Lightweight container** — runs in an unprivileged LXC (not a full VM), so it's fast and resource-efficient
+- **Full remote desktop** — access a graphical LXQt desktop from any browser via noVNC
+- **Ready-to-use browser** — Google Chrome with developer mode for OpenClaw browser extension
+- **Lightweight container** — runs in a privileged LXC (not a full VM), so it's fast and resource-efficient
 - **Auto-starts on boot** — all services (gateway, VNC, noVNC) are systemd-managed
 - **Onboarding made easy** — desktop shortcut walks you through OpenClaw setup step by step
 - **Homebrew included** — install OpenClaw skills right away
@@ -59,7 +59,7 @@ Once you open the remote desktop via noVNC, you'll find two shortcuts ready to g
 | Shortcut | What it does |
 |----------|-------------|
 | **OpenClaw Setup Wizard** | Opens the interactive onboarding wizard (`openclaw onboard`) to configure your channels, workspace, and skills |
-| **OpenClaw Dashboard** | Opens Chromium with the dashboard URL and auth token pre-filled — no manual token entry needed |
+| **OpenClaw Dashboard** | Opens Chrome with the dashboard URL and auth token pre-filled — no manual token entry needed |

 ## Requirements

@@ -85,11 +85,11 @@ Everything else is auto-detected — VMID, storage, networking (DHCP).

 All inside the container (nothing is installed on the Proxmox host):

- **Debian 13** LXC (unprivileged, nesting enabled)
+- **Debian 13** LXC (privileged)
 - **Node.js 22** + **OpenClaw**
 - **Homebrew** (for OpenClaw skills)
- **XFCE4** desktop + **TigerVNC** + **noVNC**
- **Chromium** (patched for LXC, set as default browser)
+- **LXQt** desktop + **TigerVNC** + **noVNC**
+- **Google Chrome** (with OpenClaw browser extension)
 - **Noto Color Emoji** font (for proper terminal rendering)
 - Three **systemd services**: `openclaw-gateway`, `vncserver`, `novnc`

@@ -121,16 +121,8 @@ pct exec <VMID> -- systemctl status vncserver
 pct exec <VMID> -- systemctl status novnc
 ```

-**Chromium won't launch?**
-The script patches this automatically. If you installed Chromium separately:
-```bash
-sed -i 's|Exec=/usr/bin/chromium|Exec=/usr/bin/chromium --no-sandbox|g' /usr/share/applications/chromium.desktop
-```
-
-**"Unable to contact settings server" in XFCE?**
-```bash
-apt-get install -y dbus-x11
-```
+**Chrome extension not loading?**
+Open Chrome, navigate to `chrome://extensions`, enable **Developer Mode** (top right toggle), then click **Load unpacked** and select the OpenClaw extension directory.

 ## License

--- a/setup-openclaw-lxc.sh
+++ b/setup-openclaw-lxc.sh
@@ -3,7 +3,7 @@
 # setup-openclaw-lxc.sh — Automated OpenClaw AI assistant setup in a Proxmox LXC container
 #
 # Run this script directly on the Proxmox host.
-# It creates a Debian 13 LXC, installs OpenClaw + XFCE desktop + VNC/noVNC,
+# It creates a Debian 13 LXC, installs OpenClaw + LXQt desktop + Google Chrome + VNC/noVNC,
 # and prints connection info when done.
 #

@@ -127,8 +127,7 @@ pct create "$VMID" "${TMPL_STORAGE}:vztmpl/${TEMPLATE}" \
    --memory "$MEMORY" \
    --cores "$CORES" \
    --net0 name=eth0,bridge=vmbr0,ip=dhcp \
-    --unprivileged 1 \
-    --features nesting=1 \
+    --unprivileged 0 \
    --start 0
 ok "Container $VMID created."

@@ -205,15 +204,24 @@ info "Installing OpenClaw..."
 ct_exec "npm install -g openclaw@latest 2>&1 | tail -5"
 ok "OpenClaw installed."

-info "Installing XFCE4, TigerVNC, noVNC, Chromium, dbus-x11 (this takes a few minutes)..."
+info "Installing LXQt, TigerVNC, noVNC (this takes a few minutes)..."
 ct_exec "
    export DEBIAN_FRONTEND=noninteractive
    export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
-    apt-get install -y xfce4 xfce4-terminal tigervnc-standalone-server novnc websockify chromium dbus-x11 fonts-noto-color-emoji 2>&1 \
+    apt-get install -y lxqt openbox qterminal tigervnc-standalone-server novnc websockify fonts-noto-color-emoji 2>&1 \
        | grep -v -E 'Failed to write|Failed to send reload|Permission denied|Cannot set LC_'
 "
 ok "Desktop environment installed."

+info "Installing Google Chrome..."
+ct_exec "
+    export DEBIAN_FRONTEND=noninteractive
+    curl -fsSL https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -o /tmp/chrome.deb
+    apt-get install -y /tmp/chrome.deb 2>&1 | grep -v -E 'Failed to write|Permission denied'
+    rm -f /tmp/chrome.deb
+"
+ok "Google Chrome installed."
+
 # ─── Configure OpenClaw ──────────────────────────────────────────────────────
 info "Configuring OpenClaw..."
 AUTH_TOKEN=$(openssl rand -hex 16)
@@ -226,6 +234,10 @@ ct_exec "
 "
 ok "OpenClaw configured (token: $AUTH_TOKEN)."

+info "Installing OpenClaw browser extension..."
+ct_exec "openclaw browser extension install 2>&1 | tail -5 || true"
+ok "OpenClaw browser extension installed."
+
 # ─── Configure VNC ───────────────────────────────────────────────────────────
 info "Configuring VNC..."
 ct_exec "
@@ -238,7 +250,7 @@ ct_exec "cat > /root/.config/tigervnc/xstartup << 'XSTARTUP'
 #!/bin/bash
 unset SESSION_MANAGER
 unset DBUS_SESSION_BUS_ADDRESS
-exec startxfce4
+exec startlxqt
 XSTARTUP
 chmod +x /root/.config/tigervnc/xstartup"

@@ -246,46 +258,19 @@ chmod +x /root/.config/tigervnc/xstartup"
 ct_exec "sed -i \"s/UI.initSetting('resize', 'off')/UI.initSetting('resize', 'scale')/\" /usr/share/novnc/app/ui.js"
 ok "VNC configured (auto-scaling enabled)."

-# ─── Fix Chromium for LXC (--no-sandbox) ─────────────────────────────────────
-info "Patching Chromium for LXC..."
+# ─── Configure Google Chrome as default browser ─────────────────────────────
+info "Configuring Google Chrome as default browser..."
 ct_exec "
-    sed -i 's|Exec=/usr/bin/chromium|Exec=/usr/bin/chromium --no-sandbox|g' /usr/share/applications/chromium.desktop
-
-    cat > /usr/local/bin/chromium-browser << 'WRAPPER'
-#!/bin/bash
-exec /usr/bin/chromium --no-sandbox \"\$@\"
-WRAPPER
-    chmod +x /usr/local/bin/chromium-browser
-
    mkdir -p /root/Desktop
-    cp /usr/share/applications/chromium.desktop /root/Desktop/
-    chmod +x /root/Desktop/chromium.desktop
-
-    # Set Chromium as default browser
-    update-alternatives --set x-www-browser /usr/bin/chromium 2>/dev/null || true
-    update-alternatives --set gnome-www-browser /usr/bin/chromium 2>/dev/null || true
-    xdg-settings set default-web-browser chromium.desktop 2>/dev/null || true
-
-    # XFCE preferred applications
-    mkdir -p /root/.config/xfce4
-    cat > /root/.config/xfce4/helpers.rc << 'HELPERS'
-WebBrowser=custom-WebBrowser
-HELPERS
-    mkdir -p /root/.local/share/xfce4/helpers
-    cat > /root/.local/share/xfce4/helpers/custom-WebBrowser.desktop << 'HELPER'
-[Desktop Entry]
-NoDisplay=true
-Version=1.0
-Encoding=UTF-8
-Type=X-XFCE-Helper
-X-XFCE-Binaries=chromium
-X-XFCE-Category=WebBrowser
-Name=Chromium
-X-XFCE-Commands=/usr/bin/chromium --no-sandbox;
-X-XFCE-CommandsWithParameter=/usr/bin/chromium --no-sandbox \"%s\";
-HELPER
+    cp /usr/share/applications/google-chrome.desktop /root/Desktop/
+    chmod +x /root/Desktop/google-chrome.desktop
+    update-alternatives --set x-www-browser /usr/bin/google-chrome-stable 2>/dev/null || true
+    update-alternatives --set gnome-www-browser /usr/bin/google-chrome-stable 2>/dev/null || true
+    xdg-mime default google-chrome.desktop x-scheme-handler/http 2>/dev/null || true
+    xdg-mime default google-chrome.desktop x-scheme-handler/https 2>/dev/null || true
+    xdg-mime default google-chrome.desktop text/html 2>/dev/null || true
 "
-ok "Chromium patched."
+ok "Google Chrome configured as default browser."

 # ─── Create desktop shortcuts ────────────────────────────────────────────────
 info "Creating desktop shortcuts..."
@@ -297,7 +282,7 @@ Version=1.0
 Type=Application
 Name=OpenClaw Setup Wizard
 Comment=Run the OpenClaw onboarding wizard to configure your AI assistant
-Exec=xfce4-terminal --title \"OpenClaw Onboarding\" --hold -e \"openclaw onboard\"
+Exec=qterminal --title 'OpenClaw Onboarding' -e sh -c 'openclaw onboard; exec bash'
 Icon=utilities-terminal
 Terminal=false
 Categories=Utility;
@@ -305,14 +290,14 @@ StartupNotify=true
 SHORTCUT
 chmod +x /root/Desktop/openclaw-onboard.desktop"

-# OpenClaw Dashboard (opens in Chromium with token)
+# OpenClaw Dashboard (opens in Chrome with token)
 ct_exec "cat > /root/Desktop/openclaw-dashboard.desktop << SHORTCUT
 [Desktop Entry]
 Version=1.0
 Type=Application
 Name=OpenClaw Dashboard
-Comment=Open the OpenClaw Control UI in Chromium
-Exec=/usr/bin/chromium --no-sandbox http://127.0.0.1:18789/#token=${AUTH_TOKEN}
+Comment=Open the OpenClaw Control UI in Google Chrome
+Exec=google-chrome-stable http://127.0.0.1:18789/#token=${AUTH_TOKEN}
 Icon=web-browser
 Terminal=false
 Categories=Network;WebBrowser;
@@ -320,43 +305,6 @@ StartupNotify=true
 SHORTCUT
 chmod +x /root/Desktop/openclaw-dashboard.desktop"

-# Mark desktop shortcuts as trusted (runs once after XFCE/DBUS starts via VNC)
-ct_exec "cat > /usr/local/bin/trust-desktop-icons << 'SCRIPT'
-#!/bin/bash
-# Wait for XFCE DBUS session socket to appear
-for i in \$(seq 1 30); do
-    SOCK=\$(find /tmp -maxdepth 1 -name 'dbus-*' -type s 2>/dev/null | head -1)
-    [ -n \"\$SOCK\" ] && break
-    sleep 1
-done
-[ -z \"\$SOCK\" ] && exit 1
-export DBUS_SESSION_BUS_ADDRESS=unix:path=\$SOCK
-for f in /root/Desktop/*.desktop; do
-    gio set \"\$f\" metadata::xfce-exe-checksum \"\$(sha256sum \"\$f\" | cut -d' ' -f1)\" 2>/dev/null
-done
-# Self-disable after first successful run
-systemctl disable trust-desktop-icons.service 2>/dev/null
-SCRIPT
-chmod +x /usr/local/bin/trust-desktop-icons"
-
-ct_exec "cat > /etc/systemd/system/trust-desktop-icons.service << 'SVC'
-[Unit]
-Description=Mark desktop shortcuts as trusted for XFCE
-After=vncserver.service
-Requires=vncserver.service
-
-[Service]
-Type=oneshot
-ExecStartPre=/bin/sleep 5
-ExecStart=/usr/local/bin/trust-desktop-icons
-RemainAfterExit=yes
-
-[Install]
-WantedBy=multi-user.target
-SVC
-systemctl daemon-reload
-systemctl enable trust-desktop-icons.service"
-
 ok "Desktop shortcuts created."

 # ─── Create systemd services ─────────────────────────────────────────────────
@@ -453,6 +401,10 @@ echo -e "  ${BOLD}noVNC (remote desktop):${NC}"
 echo -e "    http://${CT_IP}:6080/vnc.html"
 echo -e "    VNC password: (same as container password)"
 echo
+echo -e "  ${BOLD}Browser Extension:${NC}"
+echo -e "    Open Chrome → chrome://extensions → Enable Developer Mode"
+echo -e "    Click 'Load unpacked' and select the OpenClaw extension directory"
+echo
 echo -e "  ${BOLD}SSH:${NC}"
 echo -e "    ssh root@${CT_IP}"
 echo