A comprehensive automation skill for deploying the FastapiAdmin stack within a Windows WSL2 Ubuntu environment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install faa-wsl
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 faa-wsl 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 FastapiAdmin WSL2 Deployment Skill?
The FastapiAdmin WSL2 deployment skill is a specialized technical workflow designed to bridge the gap between Windows development environments and Linux-based production-ready stacks. It automates the intricate process of setting up a full-stack Python and Node.js application, handling everything from system-level dependencies to complex networking configurations inherent to WSL2.
By leveraging Openclaw Skills, developers can bypass manual configuration hurdles such as Nginx alias/try_files loops and SSL certificate generation. This skill ensures that the backend FastAPI service and the frontend Vue/Vite application are synchronized, properly networked, and accessible from the Windows host browser with minimal friction.
FastapiAdmin WSL2 Deployment Skill Use Cases
- Deploying FastapiAdmin for local development on Windows machines.
- Automating the setup of MySQL, Redis, and Nginx on WSL2 Ubuntu instances.
- Troubleshooting and fixing Nginx SPA routing issues like redirection loops.
- Configuring secure local environments with self-signed SSL certificates.
How FastapiAdmin WSL2 Deployment Skill Works
- Environment Audit: Checks for Python 3.10+, Node.js 20+, and necessary package managers.
- Dependency Installation: Automates the installation of pip, pnpm, MySQL, Redis, and Nginx via apt-get.
- Database Initialization: Creates the MySQL database and user with appropriate permissions and character sets.
- Repository Management: Clones the backend and frontend source code into a unified work directory.
- Service Configuration: Sets up Python virtual environments, installs requirements, and executes database migrations.
- Frontend Orchestration: Installs Node dependencies and builds the production assets using the WSL2 IP address.
- Nginx Optimization: Configures Nginx with optimized SPA routing rules and generates self-signed SSL certificates for secure access.
FastapiAdmin WSL2 Deployment Skill Setup
To initiate the deployment process using Openclaw Skills, ensure your WSL2 Ubuntu environment is active and run the following commands:
# Update system packages
sudo apt-get update
# Install python venv support
sudo apt-get install -y python3.12-venv
# Ensure node and npm are present to install pnpm
sudo npm install -g pnpm
Follow the specific configuration steps in the SKILL.md to map your DATABASE_USER and DATABASE_PASSWORD within the env/.env.dev file.
FastapiAdmin WSL2 Deployment Skill Data Schema & Taxonomy
The skill organizes data within a centralized workspace to maintain cleanliness and portability:
| Path | Purpose |
|---|---|
~/workdir/FastapiAdmin |
Main project root containing backend and frontend code |
~/workdir/FastDocs |
Documentation repository |
/etc/nginx/ssl/ |
Location for generated server.key and server.pem |
/etc/nginx/nginx.conf |
Global Nginx configuration linked to the project devops files |
backend/venv |
Isolated Python virtual environment for backend dependencies |
FastapiAdmin WSL2 Deployment Skill Advanced Features
- Auto-IP Discovery: Dynamic detection of WSL2 IP addresses for frontend environment variable injection.
- SPA Loop Mitigation: Advanced Nginx internal fallback logic to prevent
alias+try_filesredirection errors. - SSL Automation: One-touch generation of X.509 certificates for local HTTPS development.
- System-Level Hooking: Automated service management for MySQL and Redis status checks.
SKILL.md
Loading
Related Openclaw Skills
MapLibre to Mapbox Migration
A professional developer guide for transitioning web mapping applications from MapLibre GL JS to the Mapbox GL JS ecosystem.
Vision-Action-Evolution Loop
An integrated cognitive framework for Embodied AI that bridges visual perception, action planning, and self-evolutionary learning.
Academic Deep Search
A high-precision academic research skill designed to synthesize methods, markers, and findings from peer-reviewed literature into structured, evidence-based reports.
Mapbox Search Patterns
A specialized guidance skill for AI agents to master Mapbox search tools through optimized tool selection, parameter tuning, and spatial constraints.
Zhangyan Assistant
An intelligent appraisal consultant specialized in artifacts, calligraphy, porcelain, jade, and antique collection risk management.
Mapbox iOS Integration Patterns
A comprehensive implementation guide for integrating Mapbox Maps SDK v11 into iOS applications using Swift and SwiftUI.
Featured*
