aionclaw在windows上需手动配置python(3.9–3.12)和mingw-w64环境,下载源码后以开发模式pip install -e .安装,不可用pip一键安装;验证通过python -c "import aionclaw; print(aionclaw.__version__)"输出版本号。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Windows系统上安装AionClaw需要手动配置Python环境、下载源码并编译核心组件,不能通过pip一键安装,因为官方未发布PyPI包。
确认系统满足最低要求
打开命令提示符,依次执行:python --version 和 gcc --version;若提示“不是内部或外部命令”,说明Python或MinGW-w64未安装或未加入PATH——【必须先解决这两个依赖,否则后续所有步骤都会失败】。
Python版本需为3.9~3.12(3.13暂不兼容),推荐使用python.org下载的Windows x64安装包,并勾选“Add Python to PATH”。
安装MinGW-w64编译工具链
方法一:使用MSYS2(推荐)→ 打开MSYS2终端 → 运行 pacman -S mingw-w64-x86_64-gcc → 等待安装完成。
方法二:直接下载TDM-GCC(https://jmeubank.github.io/tdm-gcc/)→ 选择“Latest stable release”→ 安装时勾选“Add to PATH”→ 安装后重启命令提示符。
注意:不要用Visual Studio Build Tools替代,AionClaw的C扩展模块依赖GCC特定宏定义,MSVC会编译报错。
获取并准备AionClaw源码
第一步:访问GitHub仓库 https://github.com/aionclaw/aionclaw → 点击绿色“Code”按钮 → 选择“Download ZIP” → 解压到不含中文和空格的路径,例如 C:\aionclaw。
第二步:以管理员身份打开PowerShell → 执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser → 允许运行本地脚本。
第三步:进入解压目录 → 运行 cd C:\aionclaw → 确保当前路径下存在 setup.py 和 pyproject.toml 文件。
构建并安装Python包
在当前目录下执行:pip install -e . --no-deps;该命令以开发模式安装,跳过自动拉取依赖(避免与已安装的numpy/scipy版本冲突)。
如果遇到“Failed building wheel for aionclaw”错误,说明C扩展编译失败,请检查MinGW-w64是否可用,再重试;成功后你会看到“Installing collected packages: aionclaw”和“Successfully installed aionclaw”两行输出。
最后执行 python -c "import aionclaw; print(aionclaw.__version__)" → 输出版本号即表示安装完成。











