【JiuwenClaw】完整安装踩坑指南（Windows 版）

【JiuwenClaw】完整安装踩坑指南Windows 版本文基于真实安装过程整理包含可直接复制的命令、关键版本限制、必踩的坑和对应解法帮你一次性搞定 JiuwenClaw 环境配置。一、前言先搞懂你会遇到的核心限制JiuwenClaw 是 OpenJiuwen 推出的龙虾机器人框架它有一个硬性要求Python 版本必须满足3.11 且 3.14也就是仅支持 3.11、3.12、3.13不支持 3.14 及以上版本这是 90% 安装失败的根源后文会详细说明如何规避。二、前置准备确认你的 Python 环境1. 查看电脑已安装的所有 Python 版本打开 CMD执行以下命令py -0你会看到类似输出-V:3.14 * Python 3.14 (64-bit) -V:3.12 Python 3.12 (64-bit)带*的是系统默认 Python 版本你需要确认电脑上有3.11/3.12/3.13 版本推荐用 3.12兼容性最稳2. 可选安装符合要求的 Python 3.12如果电脑上没有 3.12直接去官网下载安装 Python 3.12 官方下载页安装时必须勾选Add Python to PATH其他默认即可。三、Step 1创建专用虚拟环境1. 进入你的工作目录cd D:\AIApplication\JiuwenClaw路径替换成你自己的项目文件夹2. 用 Python 3.12 创建虚拟环境⚠️ 不要直接用python -m venv必须指定 3.12 版本# 用 py -3.12 强制调用 Python 3.12 创建环境 py -3.12 -m venv jiuwenclaw为什么不能直接python -m venv因为系统默认 Python 是 3.14 的话创建的虚拟环境也会是 3.14直接装 JiuwenClaw 会失败。四、Step 2激活虚拟环境jiuwenclaw\Scripts\activate激活成功后命令行开头会出现(jiuwenclaw)代表当前环境是独立的虚拟环境。五、Step 3安装 JiuwenClaw官方推荐写法1. 先升级虚拟环境内的 pippython -m pip install --upgrade pip避免 pip 版本过低导致的安装卡死问题2. 安装 JiuwenClaw⚠️ 必须用python -m pip install不要直接用pip installpython -m pip install jiuwenclaw全程等待安装完成直到回到(jiuwenclaw) D:\...提示符看到Successfully installed jiuwenclaw-xxx才算成功中途报错要重新安装六、Step 4初始化 JiuwenClaw 工作空间安装完成后执行初始化命令jiuwenclaw-init执行过程中会提示[jiuwenclaw-init] Do you want to continue? (yes/no):直接输入yes回车即可它会在C:\Users\你的用户名\.jiuwenclaw目录下生成配置文件。七、Step 5微信 iLink Bot 通道配置Web 控制台版初始化完成后打开 JiuwenClaw 的 Web 控制台进入「微信频道参数配置」界面逐项说明如下参数名配置说明建议值/操作enabled是否启用该微信通道✅ 打开开关通道才会生效ilink_bot_id微信 iLink Bot 唯一标识绑定微信后自动生成无需手动填写allow_from允许发送消息的用户/群空值允许所有人调试阶段建议留空auto_login是否自动重连微信✅ 保持开启掉线自动重连enable_streaming是否启用流式回复调试阶段先关闭稳定后再开启qrcode_poll_interval_sec扫码轮询间隔默认 2无需修改long_poll_timeout_sec长连接超时时间默认 45无需修改backoff_base_sec/backoff_max_sec重连退避时间默认 1/30无需修改关键绑定步骤微信更新到最新版进入「我 → 设置 → 插件 → 开启「微信 iLink Bot」」控制台点击「解绑微信账号」弹出二维码用微信扫码授权绑定绑定成功后ilink_bot_id会自动填充打开enabled开关点击「保存」重启 JiuwenClaw 服务微信通道即可生效八、必踩坑与终极解法坑 1安装 JiuwenClaw 时提示「No matching distribution found」原因你的 Python 版本 ≥3.14超出了3.11,3.14的要求解法删除当前虚拟环境用 Python 3.12 重新创建deactivate rd /s /q jiuwenclaw py -3.12 -m venv jiuwenclaw jiuwenclaw\Scripts\activate python -m pip install jiuwenclaw坑 2安装过程中 pip 卡死、报错原因直接用pip install命令安装时 pip 自动升级导致进程卡死解法全程用python -m pip install代替pip install强制使用虚拟环境内的 pip# 正确写法 python -m pip install jiuwenclaw # 错误写法容易卡死 pip install jiuwenclaw坑 3jiuwenclaw-init命令找不到原因安装未完成或虚拟环境未刷新解法先确认安装完成再退出并重新激活虚拟环境deactivate jiuwenclaw\Scripts\activate jiuwenclaw-init