Summary

[RFC] Native Windows Companion Application

Overview

This proposal documents the addition of a native Windows companion application to the OpenClaw ecosystem. The app is located in apps/windows and is built using Tauri and Rust to provide a secure and efficient background service wrapper for the OpenClaw Gateway.

Motivation & Vision Alignment

As defined in VISION.md (line 32), multi-platform support including Windows is a priority for the project. This implementation provides parity with existing macOS, iOS, and Android applications, ensuring a consistent user experience across all major desktop and mobile platforms.

Architecture & Technical Details

1. Core Stack

• Framework: Tauri (Rust-based)
• Runtime: Utilizes system WebView2 for minimal resource footprint.
• Process Management: Native Rust implementation for handling sidecar processes.

2. Key Features

• Gateway Watchdog: A dedicated Rust-based monitor that ensures high availability of the OpenClaw Gateway.
  • Automated health probes via HTTP and process status.
  • Exponential backoff restart logic (max 3 attempts).
  • Throttled system notifications for critical errors.
• System Tray Integration: Background operation with quick access to common actions and status monitoring.
• Unified Installer: A hardened PowerShell-based installer (install.ps1) for automated dependency management and environment setup.

Implementation Status

The application is fully functional and follows the project's established directory structure (apps/windows). It reuses core gateway logic while introducing Windows-specific hardening and lifecycle management.

Drafted by Aladdin

Problem to solve

Currently, Windows users lack a native, non-technical way to install and manage the OpenClaw Gateway. Relying solely on CLI/npm global installs creates a high barrier to entry and lacks essential system-level features like a background watchdog, system tray management, and automated dependency handling. This leads to a fragmented user experience compared to macOS and mobile platforms.

Proposed solution

Implementation of a native Windows companion application in apps/windows using Tauri and Rust. This app wraps the OpenClaw Gateway as a protected sidecar process. Key technical components include a Rust-based Watchdog for automatic crash recovery, a system tray interface for background management, and a hardened PowerShell installer script to handle environment setup and dependency management.

Alternatives considered

No response

Impact

• Affected users: All current and potential Windows users, which represents a large portion of the desktop user base.
• Severity: High. For non-technical users, the lack of a native app is a blocker that prevents them from using OpenClaw entirely. For power users, it remains an annoying manual process to manage the gateway.
• Frequency: Always. This is felt during every initial setup and subsequent background management of the service.
• Consequence: Lower project adoption on Windows, high support overhead due to manual setup issues, and lack of background stability (gateway remains manual/fragile).

Evidence/examples

No response

Additional information

No response