QoderWake项目需配置Temurin JDK 21 LTS、Maven 3.6+（避开3.9.0~3.9.8）、腾讯镜像源、指定本地仓库并禁用系统代理，且Python版本须为3.8–3.10；执行qoder-cli doctor --full-report验证各组件协同状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在为QoderWake项目配置Java开发环境，但遇到JDK版本不兼容、Maven依赖解析失败或镜像源响应缓慢等问题，则很可能是由于基础工具链配置不当所致。以下是针对QoderWake场景的精准配置步骤：
一、安装并验证Temurin JDK 21 LTS
QoderWake明确要求使用经验证的Temurin JDK 21 LTS，而非OpenJDK 17或其他JDK发行版，因其与OneCode-RAD类注解处理器存在已知兼容性保障。
1、访问 https://adoptium.net/，在下载页面选择“Temurin JDK 21 LTS”对应Windows x64 Installer版本。
2、运行安装程序，保持默认路径，完成安装后打开命令提示符。
立即学习“Java免费学习笔记（深入）”；
3、执行 java -XshowSettings:properties -version 2>&1 | grep "java.vendor"，确认输出中包含 Eclipse Foundation 字样。
4、若系统已存在其他Java版本，需确保 JAVA_HOME 指向Temurin JDK 21安装目录（如 C:\Program Files\Eclipse Adoptium\jdk-21.0.2+13），且 %JAVA_HOME%\bin 已加入系统Path。
二、安装Maven 3.6+并规避3.9.x早期版本风险
Maven 3.9.x早期版本存在与QoderWake CLI部分插件的解析冲突，必须选用3.6.x稳定分支或3.9.9+以上修复版本，以保障依赖树构建一致性。
1、前往 https://maven.apache.org/download.cgi 下载 apache-maven-3.6.3-bin.zip 或更高但非3.9.0~3.9.8区间版本。
2、解压至无中文、无空格路径（例如 D:\tools\apache-maven-3.6.3）。
3、新建系统变量 MAVEN_HOME，值设为解压根目录；在Path中新增 %MAVEN_HOME%\bin。
4、执行 mvn dependency:resolve -X | grep "Resolving"，观察日志中是否出现连续解析动作，无异常退出即表示基础能力就绪。
三、配置腾讯镜像源加速依赖拉取
QoderWake初始化时需下载大量模型适配器及OpenClaw Skill依赖，使用默认中央仓库易因网络波动导致超时中断，腾讯镜像源提供稳定低延迟的国内节点服务。
发布后文档同步技能，自动将 README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 与实际变更对齐，清理待办事项，完善变更记录。
1、定位到 %MAVEN_HOME%\conf\settings.xml 文件，用文本编辑器打开。
2、在 <mirrors> 标签内（若不存在则手动创建该标签对），插入以下镜像配置：
<mirror>
<id>tencent</id>
<mirrorOf>central</mirrorOf>
<name>Tencent Maven Mirror</name>
<url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
</mirror>
3、保存文件，执行 mvn help:effective-settings 验证生效，输出中应显示 tencent 作为 active mirror。
四、设置本地仓库路径并禁用系统代理
QoderWake模型端点注册与CLI诊断过程会高频读写本地仓库，统一指定路径可避免多用户权限冲突；同时系统级代理会干扰CLI与本地模型服务（如qwake指令绑定模块）的直连通信。
1、在Maven安装目录下新建文件夹，例如 D:\qoder-repo，作为专属本地仓库。
2、在 settings.xml 的 <settings> 根节点内添加：
<localRepository>D:\qoder-repo</localRepository>
3、在 settings.xml 中查找或新增 <proxies> 节点，确保其内容为空或显式设置为 <proxy><active>false</active></proxy>。
4、执行 qoder-cli doctor --full-report，确认报告中 Local repository path 显示为所设路径，且无 proxy-related 错误项。
五、验证Python与JDK协同状态
QoderWake CLI底层依赖Python调用Java子进程，若Python解释器无法正确识别JDK 21的模块路径或版本标识，将导致技能注册失败或模型加载卡顿。
1、执行 python --version，确认输出为 3.8 至 3.10 之间版本；若为3.11+，须单独安装Python 3.10并设为默认。
2、运行 qoder-cli doctor --full-report，重点检查报告顶部的 Java Runtime Version 是否显示 21.0.2+13 及 Vendor: Eclipse Foundation。
3、若报告中出现 openssl version too old 或 CUDA driver mismatch 等红色错误项，须按提示逐一修复对应组件，不可跳过。
