Managing Services
The Service List window
The Service List is the control centre of WinWraper, the place where you view and interact with all your managed services.
| # | Folder | Executable | PID | Port | Type | Status | Uptime | CPU | RAM | Crashes | Win Service | Auto-Restart | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | my-backend | node index.js | 4821 | 3000 | Node.js | ● Running | 1h 0m | 2.1% | 128 MB | 0 | ● Running (WinSvc) | ||
| 2 | next-storefront | next start | 4822 | 3001 | Next.js | ● Running | 30m 20s | 4.6% | 213 MB | 0 | — | ||
| 3 | ml-worker | python main.py | — | — | Python | ○ Stopped | — | — | — | 2 | — | ||
| 4 | data-exporter | DataExport.exe | 9104 | 9200 | Console | ● Running | 12m 4s | 1.2% | 64 MB | 0 | ● Running (WinSvc) | ||
| 5 | log-collector | LogService.exe | — | — | Console | ○ Stopped | — | — | — | 1 | — |
Column reference
The Service List shows 14 columns. From left to right:
| Column | Description |
|---|---|
| # | Row number |
| Name | The name you gave the service |
| Executable | File or script being run |
| PID | Process ID while the service is running |
| Port | Open network port (if applicable) |
| Type | Colour-coded badge: Node.js, Python, .exe, Next.js, Ruby, ... |
| Status | Running / Stopped / Starting / Restarting / ⛔ Circuit Open / ⚠ Path Missing / ⚠ Runtime Missing /, Disabled |
| Uptime | How long the service has been running since the current start |
| CPU | Current CPU % being used |
| RAM | RAM currently in use (MB) |
| Crashes | Crashes in the current run / total lifetime crashes |
| Win Service | Windows Service (SCM) status: Running / Stopped / Not Registered |
| Auto-Restart | Inline toggle, click directly to enable/disable automatic restart on crash |
| Health | HTTP health-check result: Healthy / Unhealthy / Unknown |
Sorting & filtering
- Click any column header to sort ascending or descending.
- The "Hide disabled" checkbox hides services you have temporarily disabled (when ON, disabled services disappear from the list).
Quick Add a service
The ⚡ Quick Add ▾ dropdown on the toolbar installs ready-made packages (Known Apps) in a single click, not generic framework templates. Today the available items are:
Quick Add, Add services from preset menu
Click Quick Add to pick a preset service type and fill in its configuration.
| # | Name | Executable | PID | Port | Type | Status | RAM | Crashes | Windows Service | Auto-Restart | Health | Actions |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | openclaw.exe | 26576 | 3100 | Console | ● Running | 371 MB | — | ● Online |
- OpenClaw Gateway, the AI gateway running in WSL2 (see WSL2 & OpenClaw).
- WSL2 Manager, install / remove WSL2 distros.
- NPM in WSL, install Node.js (LTS) inside a WSL2 distro.
- OpenClaw Uninstall, remove OpenClaw from WSL2.
For a regular service (your own .exe / Node.js / Python script) use ➕ Add Service instead.
Add Service dialog
For full control, use Add Service:
Add New Service
Supported runtime types
| Type | Description |
|---|---|
| Executable (.exe) | Any Windows executable |
| Node.js | Node.js script, WinWraper locates node.exe automatically |
| Python | Python script, auto-finds python.exe / python3 |
| Next.js | Next.js project, runs npm start automatically |
| Ruby | Ruby script, auto-finds ruby.exe |
| Ruby on Rails | Rails app, detects bundle exec rails server |
| Custom | Any interpreter, enter the path manually |
ℹ️Note
Run-In-Place mode: WinWraper does not copy your files, services run directly from their original folder. Code changes take effect immediately after restarting the service.
Configuring a service
Click the ⚙ Configure button on the toolbar to open the Configure Instances dialog. This dialog is intentionally minimal, it only contains global options and the per-service Enable checkbox:
What's in the Configure dialog
- Auto-start all services on open, when WinWraper opens, start every enabled service automatically.
- Start with Windows, WinWraper launches when you sign in.
- Language, switch between Vietnamese and English.
- A list of services with an Enabled checkbox each, untick a service to temporarily disable it.
What's NOT in this dialog
- Auto-Restart, toggled inline on the service row, in the Auto-Restart column.
- Working directory / interpreter / arguments, set when you add the service via ➕ Add Service, or edited later via right-click → Configure.
Enabling / disabling a service
- Enable: The service is active and can be started or stopped.
- Disable: The service is marked "Disabled" (shown in grey) and will not auto-start. Useful when you want to temporarily deactivate it without removing it.
To Enable a disabled service: right-click → Enable. To Disable a service: click the Configure button → uncheck the service in the list.
Removing a service
Right-click → Remove.
⚠️Warning
Removing a service only removes it from WinWraper, it does not delete your original files. However, if the service is registered as a Windows Service, Unregister it first before removing.
Context menu (right-click)
Right-click any service to see all available actions:
- Start / Stop / Restart
- Enable (only shown for disabled services)
- Register / Unregister Windows Service
- View Metrics (CPU/RAM chart)
- Remove
- Restore / Minimize Window (for WinUI service types)
- Download Runtime…, downloads the missing Node.js / Python / Ruby runtime if needed
- Manage OpenClaw, only on the OpenClaw service; opens the OpenClaw configuration manager
ℹ️Note
To open the folder containing the service file: double-click the service row in the list.