skill-python-env

这是OpenClaw内部工具skill，不直接面向用户，由其他需Python环境的skill调用。核心功能：按Python版本号创建共享虚拟环境，多skill可复用同版本环境；支持Shell、Python两种调用方式，具备幂等性，自动安装依赖工具uv。输入需指定Python版本，可选追加安装包；输出机器可读的环境路径等信息，供调用方解析使用。

liberalchang

热度 65.89

最近更新 2026-05-11 17:38:33

分类：开发依赖：代码执行 / 读写文件应用场景：DevOps / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add skill-python-env

Metadata

name: skill-python-env
description: 【OpenClaw 内部工具 skill】为其他 skill 提供 Python 虚拟环境管理。按 Python 版本号在 ~/.python_env/<version> 下创建共享环境，多个 skill 可复用同一版本环境。自动安装 uv（若未安装）。不直接面向用户。
emoji: 🐍
metadata: {"clawdbot":{"config":{"requiredEnv":[],"stateDirs":[],"internal":true,"calledBy":"other_skills","example":"# 在其他 skill 脚本中调用（确保 Python 3.11 环境存在）\nbash ~/.openclaw/skills/skill-python-env/scripts/ensure_python_env.sh 3.11\nsource ~/.python_env/3.11/bin/activate\n"}}}

skill-python-env

内部工具 skill — 本 skill 不直接响应用户指令，由其他需要 Python 环境的 skill 在执行时调用。

设计原则

按版本共享：环境以 Python 版本号命名（~/.python_env/3.11），不同 skill 只要版本相同即复用同一环境，避免重复创建
幂等安全：环境已存在则秒返回，包安装使用 uv pip install（已安装的包自动跳过）
零前置依赖：uv 未安装时自动下载安装，安装完毕后继续执行，无需用户手动干预

目录结构

skill-python-env/
├── SKILL.md
├── _meta.json
└── scripts/
    ├── ensure_python_env.sh    # Shell 版（供 bash/zsh/Git Bash 调用）
    └── ensure_python_env.py    # Python 版（供 uv run 或 python3 调用）

调用接口

两个脚本功能完全相同，根据调用方语言选择。

Shell 版

bash ~/.openclaw/skills/skill-python-env/scripts/ensure_python_env.sh <python_version> [packages...]

参数	说明
`python_version`	必填，如 `3.11`、`3.12`
`packages...`	可选，追加安装的包，空格分隔

Python 版（uv run）

uv run ~/.openclaw/skills/skill-python-env/scripts/ensure_python_env.py <python_version> [--packages pkg1 pkg2 ...]

参数	说明
`python_version`	必填，如 `3.11`、`3.12`
`--packages`	可选，追加安装的包

输出格式

脚本运行完成后，stdout 末尾输出以下机器可读行，供调用方 grep 解析：

PYTHON_ENV_ACTIVATE:/home/user/.python_env/3.11/bin/activate
PYTHON_ENV_DIR:/home/user/.python_env/3.11
PYTHON_ENV_VERSION:3.11

其他 skill 集成示例

方式 A：直接激活后运行（Shell）

#!/usr/bin/env bash
# 其他 skill 的入口脚本

SKILL_ENV="$HOME/.openclaw/skills/skill-python-env/scripts/ensure_python_env.sh"

# 确保 Python 3.11 环境就绪，并安装本 skill 所需的包
bash "$SKILL_ENV" 3.11 requests httpx

# 激活并执行
source "$HOME/.python_env/3.11/bin/activate"
python -m my_skill "$@"

方式 B：解析输出路径（更健壮）

#!/usr/bin/env bash
SKILL_ENV="$HOME/.openclaw/skills/skill-python-env/scripts/ensure_python_env.sh"

OUTPUT=$(bash "$SKILL_ENV" 3.11 requests 2>&1)
echo "$OUTPUT"

ACTIVATE=$(echo "$OUTPUT" | grep '^PYTHON_ENV_ACTIVATE:' | cut -d: -f2-)
source "$ACTIVATE"
python -m my_skill "$@"

方式 C：Python 调用

import subprocess, os
from pathlib import Path

script = Path.home() / ".openclaw/skills/skill-python-env/scripts/ensure_python_env.py"
result = subprocess.run(
    ["uv", "run", str(script), "3.11", "--packages", "requests"],
    capture_output=True, text=True
)
# 解析激活路径（仅用于参考，Python 脚本通常直接 import）
activate = next(
    line.split(":", 1)[1] for line in result.stdout.splitlines()
    if line.startswith("PYTHON_ENV_ACTIVATE:")
)

环境路径规范

平台	激活命令
Linux / macOS	`source ~/.python_env/3.11/bin/activate`
Windows (Git Bash)	`source ~/.python_env/3.11/Scripts/activate`
Windows (PowerShell)	`& "$env:USERPROFILE\.python_env\3.11\Scripts\Activate.ps1"`

uv 自动安装

平台	安装方式	安装路径
Linux / macOS	curl / wget 管道 sh	`~/.local/bin/uv`
Windows	PowerShell `irm`	`%USERPROFILE%\.local\bin\uv.exe`

安装成功后脚本会提示将对应目录加入 PATH 以永久生效。

常见问题

Q: 想重置某个版本的环境 删除目录后重新调用即可自动重建：

rm -rf ~/.python_env/3.11
bash ensure_python_env.sh 3.11

Q: uv 找不到指定的 Python 版本 uv 会自动从官方源下载对应版本的 Python，需要网络可访问 python.org。

Q: Windows PowerShell 执行策略报错 以管理员身份运行：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned