SOLO-WEB-DESKTOP-ELECTRON/README.md

Solo Trae Desktop Installers

Code Mode

This repository contains native desktop installers for Solo Trae (https://solo.trae.ai) on both Windows and Linux.

Work Mode

The installers are built using a wrapper around the official Electron runtime and bundled with a Go-based self-extracting deployment tool. They provide a seamless native application experience without requiring standard browsers or manual configuration.

Files Provided

1. SoloInstaller.exe (Windows)

A completely silent, self-extracting native installer for Windows (x64).

• How to Use: Download and double-click SoloInstaller.exe.
• What it Does:
  • Extracts the pre-configured Electron app silently to your %APPDATA%\SoloApp directory.
  • Automatically creates a desktop shortcut (Solo.lnk).
  • Immediately launches the Solo application.

2. SoloInstaller-Linux (Linux)

A native executable installer for Linux (x64).

• How to Use:
  1. Download the file.
  2. Make it executable: chmod +x SoloInstaller-Linux
  3. Run it: ./SoloInstaller-Linux
• What it Does:
  • Extracts the Linux Electron app silently to your ~/.config/SoloAppLinux (or a fallback temp directory).
  • Sets the correct execution permissions.
  • Creates a .desktop shortcut on your Desktop for easy access.
  • Launches the Solo application.

Development Details

• Runtime: Built around Electron v41.1.1
• Packaging: Bundled using Go embed to bypass traditional deployment toolchain limitations (like Wine).
• Silent Mode: Installers execute completely in the background without requiring user interaction (No Next/Finish wizards).

OpenClaw Automated Self-Healing Engine

Included in this repository is openclaw-healer.sh, a robust background daemon script designed to mitigate headless browser crashes and port deadlocks commonly encountered when automating OpenClaw or Puppeteer.

What it does:

1. Zombie Reaping: Continuously scans for and aggressively reaps [Z] Defunct instances of Chrome, Chromium, and Puppeteer by terminating their deadlocked parent processes.
2. Port Mitigation: Monitors target ports (default 18800) for stalled processes. If a process holds the port for longer than 120 seconds, the healer executes a forced termination (kill -15 then kill -9) to guarantee the port is released for the next automation task.

How to run it:

chmod +x openclaw-healer.sh
nohup bash -c "while true; do ./openclaw-healer.sh; sleep 60; done" > /var/log/openclaw-healer.log 2>&1 &