A highly reliable automation workflow designed to install, configure, and manage backend database and web services within Windows Subsystem for Linux (WSL) directly from the Windows host.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wsl-service-deploy
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wsl-service-deploy using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WSL Service Deploy?
The WSL Service Deploy skill enables developer agents to execute swift, one-click deployments of backend services directly inside Ubuntu WSL on Windows hosts. By utilizing direct Windows-to-WSL command pathways via wsl.exe, this capability circumvents the typical pain points of SSH configurations, dynamically shifting IP addresses, and complex authentication setups. Utilizing aptitude as its preferred package manager for superior dependency handling, it ensures highly reliable environment setups.
This workflow is optimized for developer environments where local databases, caching layers, and web servers need to run inside a Linux sandbox while being seamlessly managed from Windows. Using robust shell scripting patterns and background execution pipelines, it provides an airtight infrastructure-as-code-like deployment experience for local machines, making it a valuable addition to your Openclaw Skills collection.
WSL Service Deploy Use Cases
- Setting up local development databases like MySQL or PostgreSQL inside WSL Ubuntu without needing manual SSH configuration or GUI-based management tools.
- Rapid provisioning of caching layers such as Redis with configured auth passwords and external network bindings for local testing.
- Installing web servers (e.g., Nginx) directly from the Windows side to serve localized web environments.
- Streamlining repetitive environment setups across teams using standardized Openclaw Skills scripts execution directly inside Windows terminal workflows.
- Programmatic cleanup and service uninstallation (purging residues and residual packages) to reset local environments cleanly.
How WSL Service Deploy Works
- Identify or Search: The agent searches for the target package using aptitude search on WSL Ubuntu to find official package names.
- Write Installer Script: It generates an installation bash script containing step-by-step commands and saves it securely to the
/tmp/directory in WSL. - Execute as Root in Background: The skill triggers
wsl.exewithsu -cwrapping to execute the installer script as root in the background, circumventing sudo interactive prompts and preventing terminal timeout issues. - Monitor Logs: The workflow checks status by polling the installer log file (
/tmp/install_<service>.log) after a contextual delay matching the expected installation time. - Configure and Enable: It backs up configurations, updates key files (e.g., binding addresses, root credentials), and enables systemd services.
- Verify Service Status: Finally, it validates successful deployment by querying port listeners and verifying active processes with systemctl.
WSL Service Deploy Setup
Ensure that your local environment meets the standard configurations outlined below before execution.
# Verify WSL Ubuntu environment from Windows Host
wsl.exe -e bash -c "lsb_release -a"
# Check if aptitude is available inside your WSL
wsl.exe -e bash -c "which aptitude || sudo apt-get install -y aptitude"
Essential Parameters
- Target OS: Ubuntu 26.04 LTS (resolute) with Aliyun mirror sources enabled.
- Root Credentials: The execution scripts assume the default WSL root password is set to
123456. - Security Configuration: Ensure that system-level execution capabilities are allowed within your runner security policies.
WSL Service Deploy Data Schema & Taxonomy
The WSL Service Deploy skill leverages temporary script executions while maintaining robust logging and configuration structures.
| Directory / File Path | Purpose | Behavior & Lifetime |
|---|---|---|
/tmp/install_<service>.sh |
Dynamically written shell installer script containing specific install logic | Created on the fly, persistent until manual wipe or system reboot |
/tmp/install_<service>.log |
Complete logs of script stderr and stdout execution steps | Retained for debugging and verification steps |
/etc/<service>/ |
Configuration storage folder (e.g., /etc/mysql/ or /etc/redis/) |
Backed up with .bak suffixes prior to modification |
/var/lib/<service>/ |
Primary data repository (e.g., MySQL schemas or Redis data dumps) | Retained throughout the service lifetime; removed entirely upon purge commands |
WSL Service Deploy Advanced Features
- Direct Host-to-Guest Pipe Execution: Eradicates SSH connection issues, securing the communication lane even if the WSL IP address shifts.
- Sudo Bypass Wrapper: Automates root operations through raw password pipes (
su -c 'bash <script>'), eliminating manual terminal entry loops. - Non-blocking Background Processing: Runs heavy package deployments in the background with configured validation polling (
sleepparameters scaled to individual services). - Active Lock Mitigation: Automatically scans for and purges residual apt/dpkg locks (
dpkg --configure -aorkillall dpkg) before initiating new installations. - State Cleanup Routines: Removes leftover artifacts and residual packages completely via custom
aptitude purge ~cdirectives during uninstallation processes.
SKILL.md
Loading
Related Openclaw Skills
IT Operations & Diagnostics Toolkit
A zero-dependency, cross-platform IT administration suite enabling AI-driven network, service, and diagnostic commands via native Python scripts.
The Mythical Man-Month Skill
An executable toolkit that brings Frederick Brooks's classic project management and software engineering insights directly into your AI coding agent workflow.
The Book Thief Executable Literary Guide
An executable literary guide analyzing Markus Zusak's The Book Thief to explore its themes, characters, and distinct narration by Death.
From Chinatown to Every Town
An executable AI-powered toolkit mapping the migration patterns, economic engines, and cultural integration of contemporary Chinese immigrants in America.
Crypto Morning Briefing
An automated command-line skill that retrieves and structures daily cryptocurrency market insights, macro news, and key indicators without requiring API keys.
On Intelligence
An executable cognitive model and neuroscientific toolkit representing Jeff Hawkins's theories on biological intelligence, the neocortex, and the path to true AGI.
Featured*
