Jenkins工具路径配置本质是自主管理命令行工具位置，确保构建可复现：全局配置在“系统管理→全局工具配置”中设置JDK/Maven等根目录，节点级可覆盖，Git需填git命令路径而非安装目录。

jenkins 工具路径配置，本质是告诉 jenkins “去哪里找 jdk、maven、git、gradle、node.js 等命令行工具”。它不依赖系统全局环境变量，而是由 jenkins 自主管理并注入到构建环境中，确保构建可复现、节点间行为一致。

全局工具配置（推荐首选）

这是最规范、最易维护的方式，适用于所有任务共享同一套工具版本的场景：

• 进入 系统管理 → 全局工具配置
• 找到对应工具（如 JDK、Maven、Git、Gradle、NodeJS 等）
• 点击“新增 JDK”或“新增 Maven”等按钮
• 填写名称（如 jdk-17.0.2、maven-3.9.6），再指定JAVA_HOME 或 MAVEN_HOME 路径（不是 bin 目录，是安装根目录）
• 保存后，在 Pipeline 或自由风格任务中直接引用该名称即可，Jenkins 会自动设置 JAVA_HOME、PATH 等变量

节点级工具覆盖（按需定制）

当某台 Agent 需要不同版本或独立安装路径时，可在节点维度覆盖全局配置：

windows-healing-gateway

通过任务计划程序自动监控并自修复 Windows 上的 OpenClaw Gateway，具备 AI 诊断和 Telegram 报警功能。

下载

• 进入 系统管理 → 节点管理 → 选择目标节点 → 配置
• 展开“节点属性”，勾选“工具位置”
• 在下拉列表中选择工具类型（如 JDK），并填入该节点上实际的安装路径（例如：/opt/java/jdk-11.0.22）
• 该配置优先级高于全局工具，仅对该节点生效

路径填写注意事项

填错路径是常见失败原因，务必注意以下细节：

• Git 路径填的是 git 命令本身，不是 Git 安装目录：Linux 上通常是 /usr/bin/git，Windows 上是 C:\Program Files\Git\bin\git.exe
• JDK/Maven/Gradle 填的是安装根目录：例如 /opt/jdk-17.0.2（含 bin/java）、/opt/maven-3.9.6（含 bin/mvn）
• 路径中避免中文、空格、特殊符号，尤其 Windows 下不要用“Program Files”这类带空格路径
• 若使用 Docker Agent，确保镜像内已预装对应工具，或通过 tools 指令声明（Pipeline 中）：

pipeline {
  agent { label 'docker-node' }
  tools {
    jdk 'jdk-17.0.2'
    maven 'maven-3.9.6'
  }
  stages { ... }
}