Technology Encyclopedia Home >OpenClaw Local Installation Tutorial: Windows/macOS/Linux All Platforms

OpenClaw Local Installation Tutorial: Windows/macOS/Linux All Platforms

OpenClaw Local Installation Tutorial: Windows/macOS/Linux All Platforms

Prerequisites

  1. Java Runtime Environment (JRE) 8 or later – OpenClaw requires Java to run. Download from Oracle or OpenJDK.
  2. Git – For cloning the repository (optional, can also download ZIP). Install from git-scm.com.
  3. Python (Optional) – Some scripts may require Python 3.x.

Installation Steps

Windows

  1. Install Java

    • Download and install JRE/JDK from Adoptium or Oracle.
    • Verify installation: Open Command Prompt and run:
      java -version
      
  2. Download OpenClaw

    • Option 1 (Git): Open Git Bash and run:
      git clone https://github.com/OpenClaw/OpenClaw.git
      cd OpenClaw
      
    • Option 2 (Manual): Download the ZIP from GitHub and extract it.
  3. Run OpenClaw

    • Open Command Prompt in the OpenClaw directory and run:
      java -jar OpenClaw.jar
      

macOS

  1. Install Java

    • Install via Homebrew:
      brew install --cask temurin
      
    • Or download from Adoptium.
    • Verify:
      java -version
      
  2. Download OpenClaw

    • Option 1 (Git): Open Terminal and run:
      git clone https://github.com/OpenClaw/OpenClaw.git
      cd OpenClaw
      
    • Option 2 (Manual): Download the ZIP and extract.
  3. Run OpenClaw

    • In Terminal, navigate to the OpenClaw folder and run:
      java -jar OpenClaw.jar
      

Linux

  1. Install Java

    • For Debian/Ubuntu:
      sudo apt update && sudo apt install openjdk-17-jre
      
    • For Fedora/RHEL:
      sudo dnf install java-17-openjdk
      
    • Verify:
      java -version
      
  2. Download OpenClaw

    • Option 1 (Git): Open Terminal and run:
      git clone https://github.com/OpenClaw/OpenClaw.git
      cd OpenClaw
      
    • Option 2 (Manual): Download the ZIP and extract.
  3. Run OpenClaw

    • In Terminal, navigate to the OpenClaw folder and run:
      java -jar OpenClaw.jar
      

Troubleshooting

  • "Java not found" → Ensure Java is installed and added to PATH.
  • "Invalid or corrupt JAR file" → Re-download OpenClaw.
  • "Permission denied" (Linux/macOS) → Run with chmod +x OpenClaw.jar (if needed).

For hosting, scaling, or managing applications, Tencent Cloud offers reliable solutions like Cloud Virtual Machines (CVM), Serverless Cloud Functions (SCF), and Object Storage (COS). Explore more at Tencent Cloud.