feat: integrate headless Chromium browser support with automated path detection and configuration

Dockerfile

@@ -19,6 +19,27 @@ RUN apt-get update && apt-get install -y \
     curl \
     python3 \
     python3-pip \
+    chromium \
+    libnss3 \
+    libatk1.0-0 \
+    libatk-bridge2.0-0 \
+    libdrm2 \
+    libgbm1 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxrandr2 \
+    libxkbcommon0 \
+    libx11-6 \
+    libxext6 \
+    libxfixes3 \
+    libasound2 \
+    fonts-dejavu-core \
+    fonts-liberation \
+    fonts-noto-color-emoji \
+    fonts-freefont-ttf \
+    fonts-ipafont-gothic \
+    fonts-wqy-zenhei \
+    xfonts-scalable \
     --no-install-recommends && \
     pip3 install --no-cache-dir --break-system-packages huggingface_hub && \
     rm -rf /var/lib/apt/lists/*
@@ -30,6 +51,13 @@ RUN mkdir -p /home/node/app /home/node/.openclaw && \
 # Copy pre-built OpenClaw (skips npm install entirely — much faster!)
 COPY --from=openclaw --chown=1000:1000 /app /home/node/.openclaw/openclaw-app
 
+# Add Playwright in an isolated sidecar node_modules so we do not mutate the
+# bundled OpenClaw app dependency tree.
+RUN mkdir -p /home/node/browser-deps && \
+    cd /home/node/browser-deps && \
+    npm init -y && \
+    PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm install --omit=dev playwright@1.59.1
+
 # Symlink openclaw CLI so it's available globally
 RUN ln -s /home/node/.openclaw/openclaw-app/openclaw.mjs /usr/local/bin/openclaw 2>/dev/null || \
     npm install -g openclaw@${OPENCLAW_VERSION}
@@ -48,6 +76,7 @@ USER node
 ENV HOME=/home/node \
     OPENCLAW_VERSION=${OPENCLAW_VERSION} \
     PATH=/home/node/.local/bin:/usr/local/bin:$PATH \
+    NODE_PATH=/home/node/browser-deps/node_modules \
     NODE_OPTIONS="--require /opt/dns-fix.js"
 
 WORKDIR /home/node/app

README.md

@@ -42,6 +42,7 @@ license: mit
 - 🔌 **Any LLM:** Use Claude, OpenAI GPT, Google Gemini, Grok, DeepSeek, Qwen, and 40+ providers (set `LLM_API_KEY` and `LLM_MODEL` accordingly).
 - ⚡ **Zero Config:** Duplicate this Space and set **just three** secrets (LLM_API_KEY, LLM_MODEL, GATEWAY_TOKEN) – no other setup needed.
 - 🐳 **Fast Builds:** Uses a pre-built OpenClaw Docker image to deploy in minutes.
+- 🌐 **Built-In Browser:** Headless Chromium is included in the Space, so browser actions work from the start.
 - 💾 **Workspace Backup:** Chats, settings, and WhatsApp session state sync to a private HF Dataset via the `huggingface_hub` (Git fallback), preserving data automatically.
 - ⏰ **External Keep-Alive:** Set up a one-time UptimeRobot monitor from the dashboard to help keep free HF Spaces awake.
 - 👥 **Multi-User Messaging:** Support for Telegram (multi-user) and WhatsApp (pairing).
@@ -60,7 +61,7 @@ Watch a quick walkthrough on YouTube: [Deploying HuggingClaw on HF Spaces](https
 
 [![Duplicate this Space](https://huggingface.co/datasets/huggingface/badges/resolve/main/duplicate-this-space-xl.svg)](https://huggingface.co/spaces/somratpro/HuggingClaw?duplicate=true)
 
-Click the button above to duplicate the template. 
+Click the button above to duplicate the template.
 
 ### Step 2: Add Your Secrets
 

start.sh

@@ -236,6 +236,31 @@ CONFIG_JSON=$(echo "$CONFIG_JSON" | jq ".gateway.auth.token = \"$GATEWAY_TOKEN\"
 # Model configuration at top level
 CONFIG_JSON=$(echo "$CONFIG_JSON" | jq ".agents.defaults.model = \"$LLM_MODEL\"")
 
+# Browser configuration (managed local Chromium in HF/Docker)
+BROWSER_EXECUTABLE_PATH=""
+for candidate in /usr/bin/chromium /usr/bin/chromium-browser /snap/bin/chromium; do
+  if [ -x "$candidate" ]; then
+    BROWSER_EXECUTABLE_PATH="$candidate"
+    break
+  fi
+done
+
+BROWSER_SHOULD_ENABLE=false
+if [ -n "$BROWSER_EXECUTABLE_PATH" ] && [ -x "$BROWSER_EXECUTABLE_PATH" ]; then
+  BROWSER_SHOULD_ENABLE=true
+fi
+
+if [ "$BROWSER_SHOULD_ENABLE" = "true" ]; then
+  CONFIG_JSON=$(echo "$CONFIG_JSON" | jq \
+    ".browser = {
+      \"enabled\": true,
+      \"defaultProfile\": \"openclaw\",
+      \"headless\": true,
+      \"noSandbox\": true,
+      \"executablePath\": \"$BROWSER_EXECUTABLE_PATH\"
+    } | .agents.defaults.sandbox.browser.allowHostControl = true")
+fi
+
 # Control UI origin (allow HF Space URL for web UI access)
 if [ -n "$SPACE_HOST" ]; then
   CONFIG_JSON=$(echo "$CONFIG_JSON" | jq ".gateway.controlUi.allowedOrigins = [\"https://${SPACE_HOST}\"]")
@@ -345,6 +370,11 @@ printf "  │  %-40s │\n" "WhatsApp: ✅ enabled"
 else
 printf "  │  %-40s │\n" "WhatsApp: ❌ disabled"
 fi
+if [ "$BROWSER_SHOULD_ENABLE" = "true" ]; then
+printf "  │  %-40s │\n" "Browser: ✅ ${BROWSER_EXECUTABLE_PATH}"
+else
+printf "  │  %-40s │\n" "Browser: ❌ unavailable"
+fi
 if [ -n "$HF_USERNAME" ] && [ -n "$HF_TOKEN" ]; then
 printf "  │  %-40s │\n" "Backup: ✅ ${HF_USERNAME}/${BACKUP_DATASET:-huggingclaw-backup}"
 else