Env Doctor is a mandatory diagnostic and installation engine for OpenClaw, ensuring all CLI tools, runtimes, and dependencies are perfectly configured across macOS and Windows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install qclaw-env
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 qclaw-env 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 Env Doctor?
Env Doctor serves as the critical entry point for any environment setup within the Openclaw Skills ecosystem. It is designed to automate the detection, diagnosis, and installation of essential development tools, ranging from base runtimes like Node.js and Python to complex CLI utilities like ffmpeg or gh.
By following a strict detect-then-install principle, Env Doctor prevents redundant installations and solves common path issues. It intelligently handles cross-platform differences, provides network connectivity checks for global and local mirror sources, and offers fallback mechanisms when automated scripts encounter permission restrictions.
Env Doctor Use Cases
- Installing or configuring CLI tools like gh, ffmpeg, or whisper.
- Setting up foundational runtimes including Node/npm, Python3/pip, Go, and uv.
- Resolving command not found or path-related execution errors.
- Automated system health checks and environment diagnostics.
- Configuring package managers such as Homebrew, Scoop, winget, or Chocolatey.
- Managing API keys, environment variables, and PATH configurations.
- Optimizing download speeds by configuring domestic mirror sources for restricted network environments.
How Env Doctor Works
- Platform Detection: Identifies the OS (macOS/Windows/Linux) and architecture (arm64/x64) to determine the correct instruction set.
- Environment Snapshot: Scans the system for existing tools and versions to establish a baseline and avoid duplication.
- Network Connectivity Test: Pings key repositories (GitHub, npm, PyPI) to decide if mirror sources are required for a successful installation.
- Dependency Chain Analysis: Evaluates the hierarchy of requirements from the network layer up to the target CLI tool.
- Automated Installation: Executes platform-specific scripts (via Homebrew on macOS or Scoop/winget on Windows) based on a predefined decision tree.
- Post-Installation Verification: Runs version checks to ensure the tool is correctly installed and accessible in the system path.
Env Doctor Setup
Env Doctor is a core utility. To begin a diagnostic check and prepare your environment for other Openclaw Skills, run the following commands based on your OS:
macOS / Linux Platform Detection:
OS="$(uname -s)"
ARCH="$(uname -m)"
echo "Platform: $OS, Arch: $ARCH"
Windows (PowerShell) Platform Detection:
$OS = "Windows"
$ARCH = if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" }
Write-Host "Platform: $OS, Arch: $ARCH"
Env Doctor Data Schema & Taxonomy
Env Doctor organizes system information and dependency mapping using the following taxonomy:
| Layer | Component Type | Examples |
|---|---|---|
| Layer 0 | Network Environment | Mirrors, Proxies, DNS |
| Layer 1 | Package Managers | Homebrew, Scoop, winget, Chocolatey |
| Layer 2 | Base Runtimes | Node.js, Python, Go, uv |
| Layer 3 | Target CLI Tools | gh, ffmpeg, clawhub, jq, rg |
| Layer 4 | Environment Config | API Keys, PATH, Shell profiles |
Env Doctor Advanced Features
- Smart Decision Tree: Automatically selects the best package manager based on existing system state.
- Network Speed Optimization: Recommends and configures mirrors if connection latency exceeds 2 seconds.
- Graceful Degradation: Provides manual copy-paste instructions when sudo permissions or automated installers fail.
- Python Stub Detection: Specifically identifies fake Python stubs in macOS Sonoma+ to ensure a functional runtime.
- Cross-Platform Mapping: Maps inconsistent command names (e.g., pip3 vs pip) to ensure scripts run correctly regardless of OS.
SKILL.md
Loading
Related Openclaw Skills
A. Lange & Söhne Brand Intelligence
An expert-level brand intelligence skill providing deep insights into the engineering, history, and market value of A. Lange & Söhne.
Capcom Game Industry Intelligence
A comprehensive intelligence skill for analyzing Capcom's gaming empire, technical moat, and global market strategies.
AIG Insurance Agent Skill
A comprehensive analytical skill for AI agents to understand AIG's history, global insurance business models, and its pivotal role in the 2008 financial crisis.
CoverGirl Brand Knowledge Skill
A comprehensive strategic intelligence skill for analyzing the history, business model, and market positioning of CoverGirl within the global beauty industry.
Cron Skill
A powerful scheduling engine for creating one-time reminders or recurring cron jobs across local and external communication channels.
NeoData Financial Search
A natural language financial data service providing real-time access to global stocks, funds, macroeconomics, and market analytics.
Featured*
