uv-global for Openclaw

A high-performance global uv environment manager for rapid Python scripting without system-wide side effects.

guoqiao
v0.1.2
Feb 11, 2026
0
3.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install uv-global

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install uv-global 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 uv-global?

uv-global is a specialized Openclaw Skills utility designed to create and maintain a shared virtual environment at ~/.uv-global. By leveraging the lightning-fast uv package manager, it allows developers to execute ad hoc Python scripts with external dependencies while keeping the system interpreter clean and avoiding the overhead of creating individual project environments for simple tasks.

This skill is essential for developers who frequently perform data processing, web scraping, or system automation using Python. It ensures that your scripts have access to a robust, pre-configured environment instantly, significantly reducing the friction of dependency management for temporary coding tasks within the Openclaw Skills ecosystem.

uv-global Use Cases

  • Executing one-off Python scripts that require external libraries like requests or pandas.
  • Avoiding system Python pollution when performing rapid prototyping or experimentation.
  • Managing a centralized environment for administrative or automation scripts across the local machine.
  • Quick data analysis tasks where setting up a dedicated project environment is unnecessary.

How uv-global Works

  1. The skill checks for the presence of the uv package manager and installs it via Homebrew or curl if missing.
  2. A global project directory is initialized at ~/.uv-global to serve as the environment host.
  3. A dedicated virtual environment is created within that directory, prepopulated with common utilities and shims.
  4. Users add dependencies to this global state using the --project flag to ensure persistence across sessions.
  5. Python scripts are executed via the global uv runner, providing consistent performance and isolated dependencies.

uv-global Setup

To install this skill, execute the provided installation script within your terminal:

bash ${baseDir}/install.sh

After installation, it is recommended to add the global virtual environment bin directory to your PATH to enable seamless access to the Python interpreter and installed shims:

export PATH=~/.uv-global/.venv/bin:$PATH

uv-global Data Schema & Taxonomy

The uv-global skill organizes its environment and metadata within the user's home directory as follows:

Component Path Description
Root Directory ~/.uv-global/ The central hub for the global Python environment.
Configuration ~/.uv-global/pyproject.toml Tracks the dependency list for the global environment.
Virtual Env ~/.uv-global/.venv/ The isolated directory containing the Python executable and libraries.
Binaries ~/.uv-global/.venv/bin/ Contains the python interpreter and package shims.

uv-global Advanced Features

  • Automated dependency resolution using the high-performance uv engine for near-instant package installs.
  • Persistent shim management for frequently used CLI tools across different scripting contexts.
  • Multi-package bulk installation support for complex ad hoc requirements.
  • Seamless integration with existing Openclaw Skills workflows for automated Python tasks.

SKILL.md


Loading

Related Openclaw Skills

Featured*