Windows本地安装OpenHands遇setuptools及distutils错误求助

第一步：修复No module named 'distutils'错误 #

Windows环境下的Python若为Microsoft Store版本或精简版，可能缺失distutils模块，按以下场景处理：

• 官方Python安装包：重新运行安装程序，勾选「Add Python to PATH」，进入「Customize installation」确保「Optional Features」里的pip和tcl/tk and IDLE已勾选；接着在「Advanced Options」中勾选「Install for all users」「Add Python to environment variables」，同时确认「Install standard library」相关选项全选，完成安装后distutils会被自动包含。
• Miniconda/Anaconda环境：直接执行命令安装distutils：

conda install distutils

第二步：安装兼容的setuptools版本 #

setuptools 36+版本移除了setuptools.extern.six，但低于36的版本依赖完整distutils支持，推荐使用35.0.2版本：

1. 卸载当前setuptools：

pip uninstall -y setuptools

2. 安装指定版本：

pip install setuptools==35.0.2

第三步：安装OpenHands #

完成上述配置后，执行安装命令：

pip install openhands

额外排查（若仍有问题） #

• 确认Python版本为3.7-3.9区间（OpenHands旧版本对高版本Python兼容性较差）。
• 若出现其他依赖报错，可手动下载OpenHands源码包，解压后查看setup.py中的依赖列表，逐个安装依赖后执行python setup.py install完成安装。

内容的提问来源于stack exchange，提问作者Jothi Ram