Function ensurePythonDeps

openclaw-plugin/src/index.js:66–133

* Ensure the Python `uncommon-route` package is installed. * Tries: pipx → uv → pip (with --user fallback). * Returns the python executable to use.

(logger)

 * Returns the python executable to use.
 */
function ensurePythonDeps(logger) {
  const pythonCandidates = ["python3", "python"];
  let pythonPath = null;

  for (const candidate of pythonCandidates) {
    const path = which(candidate);
    if (path) {
      try {
        const ver = execSync(`${path} --version`, { encoding: "utf-8" }).trim();
        const match = ver.match(/(\d+)\.(\d+)/);
        if (match && (parseInt(match[1]) > 3 || (parseInt(match[1]) === 3 && parseInt(match[2]) >= 11))) {
          pythonPath = path;
          break;
        }
      } catch { /* skip */ }
    }
  }

  if (!pythonPath) {
    logger.error("Python 3.11+ not found. Install Python first: https://python.org");
    logger.error("  macOS:   brew install python@3.12");
    logger.error("  Ubuntu:  sudo apt install python3.12");
    return null;
  }

  if (isPythonPackageInstalled(pythonPath)) {
    logger.info(`Python package '${PY_PACKAGE}' already installed`);
    return pythonPath;
  }

  logger.info(`Installing Python package '${PY_PACKAGE}'...`);

  // Strategy 1: pipx (isolated, clean)
  if (which("pipx")) {
    try {
      execSync(`pipx install ${PY_PACKAGE}`, { stdio: "pipe" });
      logger.info(`Installed via pipx`);
      return pythonPath;
    } catch { /* fallthrough */ }
  }

  // Strategy 2: uv (fast, modern)
  if (which("uv")) {
    try {
      execSync(`uv pip install ${PY_PACKAGE}`, { stdio: "pipe" });
      logger.info(`Installed via uv`);
      return pythonPath;
    } catch { /* fallthrough */ }
  }

  // Strategy 3: pip install --user
  try {
    execSync(`${pythonPath} -m pip install ${PY_PACKAGE} --user --quiet`, { stdio: "pipe" });
    logger.info(`Installed via pip --user`);
    return pythonPath;
  } catch { /* fallthrough */ }

  // Strategy 4: pip install --break-system-packages (last resort on managed envs)