A specialized automation for macOS that manages multiple OpenJDK versions, handles Homebrew installations, and configures environment variables automatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install java-switch
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install java-switch using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Java Version Switcher for macOS?
The java-switch skill is designed to solve the common developer pain point of managing multiple Java environments on macOS. By integrating with the native /usr/libexec/java_home utility and Homebrew, this skill allows users to switch between versions like Java 8, 11, 17, or 21 with simple natural language commands. Using Openclaw Skills for environment management ensures that your development workspace remains consistent and properly configured without manual shell editing.
Beyond just switching, the skill proactively checks for missing dependencies. If a requested Java version is not present, it will use Homebrew to fetch and install the correct OpenJDK package, link it to the system, and update your configuration files. This makes it an essential tool for developers working on polyglot projects or legacy systems that require specific JDK runtimes.
Java Version Switcher for macOS Use Cases
- Rapidly switching between Java 8 for legacy maintenance and Java 17 for modern microservices.
- Automated setup of a new macOS development machine with all required JDK versions.
- Resolving JAVA_HOME path conflicts caused by multiple manual installations.
- Ensuring the correct Java version is active before running build tools like Maven or Gradle.
How Java Version Switcher for macOS Works
- The skill identifies the requested Java version from the user's prompt.
- It verifies if Homebrew is installed on the macOS system, installing it if necessary.
- It queries the system using /usr/libexec/java_home -V to see if the requested version is already present.
- If the version is missing, it executes a brew install command for the specific OpenJDK version.
- It dynamically sets the JAVA_HOME environment variable for the current session.
- It appends the configuration to the ~/.zshrc file to ensure the change persists across terminal restarts.
- It performs a final validation by checking the output of java -version.
Java Version Switcher for macOS Setup
To use this within your environment, ensure you are on a macOS system. The skill handles the heavy lifting via Openclaw Skills integration. If you need to manually prepare the environment, you can ensure Homebrew is ready:
# Install Homebrew if not already present
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# The skill will then handle the following via its internal logic:
brew install openjdk@17
Java Version Switcher for macOS Data Schema & Taxonomy
The skill manages data across the following macOS system locations:
| Feature | Path / Command | Description |
|---|---|---|
| Version Discovery | /usr/libexec/java_home |
Used to locate all installed JDKs |
| Shell Configuration | ~/.zshrc |
Stores the persistent JAVA_HOME export |
| Installation Path | /opt/homebrew/opt/ |
Default location for OpenJDK on Apple Silicon |
| Metadata | java -version |
Used to verify the active runtime version |
Java Version Switcher for macOS Advanced Features
- Multi-architecture support for both Apple Silicon (M1/M2/M3) and Intel Mac binaries.
- Automatic symbolic linking for OpenJDK to ensure macOS system tools recognize Homebrew-installed versions.
- Intelligent shell source management that refreshes the environment without requiring a logout.
- Error handling for network timeouts during Homebrew taps and installations.
SKILL.md
Loading
Related Openclaw Skills
Skill Merge and Republish
A technical workflow for consolidating redundant AI agent skills into a single, canonical version and synchronizing changes with ClawHub.
Job Application Automation Skill
A sophisticated AI-driven automation system that handles job discovery, resume tailoring, and ATS application submission.
Propel Code Review
An asynchronous code review skill that uses the Propel Review API to analyze Git diffs and provide actionable feedback for AI agents.
Auto-Coding
An autonomous programming system that decomposes requirements, performs deep analysis, and iterates through self-reflection to deliver production-ready code.
Feishu Sheet Tabs
A specialized skill for programmatically creating and renaming worksheet tabs within Feishu spreadsheets through intelligent browser automation.
Article Idea Capture
A streamlined workflow for capturing, organizing, and expanding article inspirations into structured drafts and content pools.
Featured*
