A professional tool to generate fully isolated development, testing, and production environments for Python web projects with integrated frontend support.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install multi-env-isolator
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 multi-env-isolator 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 Multi-Environment Isolator?
The Multi-Environment Isolator is a specialized utility within the Openclaw Skills library designed to solve environment conflicts in multi-agent and multi-developer teams. It automates the generation of independent configuration files, startup scripts, and data directories, ensuring that developers, testers, and production systems never interfere with one another. This skill is optimized for FastAPI and uvicorn backends paired with Vue or React frontends, providing a seamless workflow for modern web development.
By utilizing this skill from Openclaw Skills, teams can implement a robust isolation strategy that includes environment-specific databases, media storage, and port configurations. This ensures that a developer can break things in dev while a tester validates a release in a stable test environment, all on the same machine or server without port collisions or data corruption.
Multi-Environment Isolator Use Cases
- Setting up new FastAPI and Vue/React projects that require distinct dev, test, and prod stages.
- Transitioning single-environment legacy projects into isolated multi-stage architectures.
- Enabling multi-agent coordination where different AI agents (like Valina and Choco) work on coding and testing simultaneously.
- Implementing Playwright E2E testing within a dedicated environment that won't touch production data.
- Standardizing project startup and configuration across a distributed team.
How Multi-Environment Isolator Works
- The user executes the setup script provided by the Openclaw Skills package against their project directory.
- The skill analyzes the project and generates environment-specific .env files (.env.dev, .env.test, .env.prod).
- It creates a scripts directory containing shell scripts for starting both backend and frontend services on unique ports.
- A local data directory structure is initialized to isolate SQLite databases and media uploads for each environment.
- Startup scripts automatically load the correct environment variables and application modules using uvicorn.
- For frontend projects, it configures ports and proxy settings to match the respective backend environment.
Multi-Environment Isolator Setup
To initialize the isolated environments, run the following command within your project:
python3 scripts/setup_envs.py /path/to/your-project \
--name "My Project" \
--dev-backend-port 8000 \
--test-backend-port 8001 \
--prod-backend-port 8002
Once configured, you can start specific environments using the generated scripts:
# Start Development
./scripts/start-dev.sh
# Start Testing
./scripts/start-test.sh
Multi-Environment Isolator Data Schema & Taxonomy
The skill creates a structured data hierarchy to ensure no cross-contamination between environments:
| Directory/File | Description |
|---|---|
.env.[env] |
Stores environment-specific variables like DEBUG, DATABASE_URL, and PORT. |
scripts/ |
Contains start-backend-*.sh and start-frontend-*.sh for environment control. |
data/[env]/ |
Root directory for environment-specific persistent data. |
data/[env]/media/ |
Isolated storage for file uploads and static media. |
docs/MULTI_ENV_SETUP.md |
Auto-generated documentation for team onboarding. |
Multi-Environment Isolator Advanced Features
- Parallel Environment Execution: Run dev, test, and prod simultaneously on separate ports without conflicts.
- Automated Playwright Integration: Generates configuration for end-to-end testing specifically targeting the test environment.
- Intelligent Port Management: Customizable port assignments for both backend (uvicorn) and frontend (Vite/NPM) services.
- Production Optimization: Auto-configures multi-worker support and restricted CORS settings for production environments.
- Multi-Agent Support: Includes specific user-flags to coordinate tasks between developer and tester AI agents.
SKILL.md
Loading
Related Openclaw Skills
MooTeam
A powerful API integration for OpenClaw that enables AI agents to manage projects, tasks, and time tracking through the MooTeam platform.
Category Page Generator
A specialized tool for creating and auditing high-converting e-commerce category pages and listing structures.
Shopify Traffic Analyzer
A strategic intelligence tool for Shopify merchants to benchmark competitor traffic and execute a 90-day growth roadmap.
AI Tip: LangChain Structured Output
A technical guide to implementing reliable, schema-based structured outputs in LangChain agents.
Promotion Engine
A smart retail promotion calculator that computes final prices, applies discount stacking rules, and provides transparent savings breakdowns for customers.
Xiaohongshu Keyword Collector
An automated browser-based tool that extracts real-time search suggestions and trending keywords directly from Xiaohongshu's Explore page.
Featured*
