OpenClaw 在windows上安装前卸载 微软商店版 Python

第二步：OpenClaw 只认这种 Python ✅ 能给 OpenClaw 使用的 Python 特征： 1.不是微软商店版 路径里带 WindowsApps 的必须卸载！ 例如：C:\Users\xxx\AppData\Local\Microsoft\WindowsApps\python.exe 2.是 官方独立安装版（https://python.org/ 下载的） 3.版本 3.11 最稳

第三步：安全卸载微软商店版 Python 方法 1：设置里直接卸载（最推荐，无残留） 1.按下 Win + I → 应用 → 已安装的应用搜索 Python  找到名称带「PythonSoftwareFoundation.Python.3.13」（你的版本）、发布者是Microsoft的那个（路径带WindowsApps的就是它）; 2.点击右侧「⋮」→ 选择「卸载」，按提示确认即可，全程默认下一步;

方法 2：微软商店直接卸载（备用） 打开微软商店 → 右上角点击「我的」→ 「已安装的应用」 找到对应 Python 版本 → 点击「卸载」确认。

第四步: 卸载假快捷方式 微软商店版 Python 最恶心的就是 —— 卸载了还会留个假快捷方式，命令行依然优先调用它，导致你永远用不了真正的 Python。 1.按 Win + I 键; 2.搜索 管理应用执行别名; 3.在列表里找到：Python 和 Python3 把它们的 开关全部关掉！ ✅ 这一步就是彻底干掉微软商店版的关键。

第五步: 检查是否删干净 重新打开PowerShell，运行以下命令，如果没有输出带WindowsApps的 Python 路径，就是删干净了 where python python --version pip --version

一、官方兼容范围（2026.4.5） 1.最低要求：Python ≥3.10 2.官方推荐：Python 3.11.x（文档明确 prefers 3.11） 3.不推荐：3.9（已过期）、3.12/3.13/3.14（太新，部分依赖易报错）二、最新稳定版（2026.4） Python 3.11.15（2026-03-03 发布，最新安全更新） Windows 64 位 官方下载（带安装器）： https://www.python.org/ftp/python/3.11.9/python-3.11.9-amd64.exe; 注：3.11.9 是最后一个带完整 Windows 安装包的版本；3.11.10+ 只有源码包Python，普通用户用 3.11.9 最稳、最方便;三、为什么 3.11 最适合 2026.4.5 1.性能最优：3.11 比 3.10 快 10–60%，OpenClaw/freeride 响应更快 2.依赖最稳：2026.4.5 所有依赖包（httpx、cryptography、gitpython 等）在 3.11 下无编译错误 3.长期支持：3.11 支持到 2027-10，安全更新充足 4.社区验证：大量用户在 2026.3.x/4.x 用 3.11.9/3.11.15 无问题四、安装要点（必做） ✅ 勾选 Add Python.exe to PATH 关闭所有终端 → 重新打开 PowerShell 验证： python --version   pip --version 应输出     Python 3.11.9     pip 24.0 from xxx

Python 3.11.9（或 3.11.15）是 OpenClaw 2026.4.5 官方首选、最新稳定、100% 兼容的版本。

OpenClaw 2026.4.5 必须用官方推荐的 Python 3.11.x（如 3.11.9）的核心原因  本质是 **「版本匹配 + 依赖稳定 + 功能兼容 + 环境无冲突」**，从 OpenClaw 本身、依赖包、运行环境三层规避所有报错，也是官方基于新版功能迭代的明确要求，具体原因分 4 点，每一点都对应之前踩过的坑：  1. 新版功能适配」：匹配 OpenClaw 2026.4.5 的最新代码逻辑    OpenClaw 2026.3.x/4.x 是新版迭代，内部代码（如 freeride 联动、设备插件调用、AI 引擎适配）针对 Python 3.11 做了优化，3.10 虽能运行但部分新功能（如米家插件高级调用、本地模型推理）会有隐性兼容问题；    而 3.12/3.13 太新，OpenClaw 源码暂未做全面适配，易出现「函数调用失败、模块加载异常」。  2.「依赖包零报错」：规避第三方库的编译 / 安装问题    OpenClaw 和 freeride 的核心依赖（cryptography、gitpython、httpx、numpy 等），其官方预编译的 Windows 二进制包在 Python 3.11 下最齐全：    2.1 不用手动编译 C/C++ 扩展，pip 安装一步到位；    2.2 避免 3.12/3.13 的「依赖包找不到适配版本、编译失败」，也避免 3.10 的「部分新版依赖包放弃支持」。    这是解决之前「pip 装包失败、模块找不到」的核心关键。   3.「规避环境冲突」：彻底解决微软商店版 / 高版本的路径 / 权限问题    你之前的所有报错（freeride命令不识别、模块找不到、权限不足），核心根源是微软商店版 Python 的路径隔离 + 权限限制，而官方版 Python 3.11.x：    3.1 安装时勾选Add Python.exe to PATH，能让系统全局识别python/pip/freeride命令，无路径冲突；    3.2 安装在用户目录 / 系统目录，权限正常，能正常写入依赖包、读取 OpenClaw 配置文件，避免「权限被拒、文件找不到」。   4.「性能 + 长期支持」：兼顾运行效率和后续更新    4.1 性能更优：Python 3.11 比 3.10 快 10%-60%，OpenClaw 的 AI 推理、设备扫描、freeride 联动响应更快，适合智能家居本地部署的低延迟需求；    4.2 长期支持：Python 3.11 官方安全更新支持到 2027 年 10 月，OpenClaw 后续版本会持续兼容，不用频繁更换 Python 版本；    4.3 社区验证：OpenClaw 2026.x 主流用户均使用 Python 3.11.x，遇到问题有成熟的解决方案，避免小众版本的「踩坑无参考」。