openclaw-installer 1.0.29

Installer for OpenClaw - installs OpenClaw and starts the gateway

OpenClaw Vanilla Installer

A simple, zero-configuration installer for OpenClaw that works on Windows, macOS, and Linux.

What It Does

This installer:

1. Downloads and installs Node.js v22.16.0 (isolated, doesn't affect system)
2. Installs OpenClaw from npm
3. Creates a wrapper script for the openclaw command
4. Starts the OpenClaw gateway on port 18789

That's it. No configuration files, no provider setup, no complexity.

Installation

Prerequisites

• Python 3.10+
• Internet connection

Install via pipx (Recommended)

# Install pipx if you don't have it
pip install pipx
pipx ensurepath

# Install OpenClaw
pipx install openclaw-installer

# Install OpenClaw
openclaw-installer install

Install from Source

git clone https://github.com/yourusername/openclaw-installer.git
cd openclaw-installer
pipx install .

# Run installer
openclaw-installer install

Usage

Install OpenClaw

openclaw-installer install

This will:

• Set up Node.js in an isolated directory
• Install OpenClaw
• Start the gateway on http://localhost:18789

Open Dashboard

openclaw dashboard

Or manually open http://localhost:18789 in your browser.

Uninstall

openclaw-installer uninstall

What Happens After Install?

1. Gateway is running on port 18789
2. Open dashboard and configure your AI providers there
3. No config files are managed by this installer

OpenClaw stores its own configuration in ~/.openclaw/ - the installer doesn't touch these files.

Installation Locations

• Windows: %LOCALAPPDATA%\openclaw-installer\
• macOS/Linux: ~/.local/share/openclaw-installer/

Everything is isolated in these directories. No system files are modified.

Commands

Command	Description
openclaw-installer install	Install OpenClaw and start gateway
openclaw-installer uninstall	Remove OpenClaw installation
openclaw-installer dashboard	Open the OpenClaw dashboard
openclaw-installer --help	Show help

Requirements

• Windows 10/11, macOS 12+, or Linux
• ~200MB free space
• Internet connection for initial download

Troubleshooting

Port 18789 in use

If port 18789 is already in use, stop the existing process:

# Find what's using the port
lsof -i :18789  # macOS/Linux
netstat -ano | findstr 18789  # Windows

# Or use a different port in OpenClaw's dashboard after install

Gateway not starting

Check if the gateway is running:

openclaw gateway status

If not running, start it manually:

openclaw gateway start

Wrapper not found

Make sure the bin directory is in your PATH:

# macOS/Linux
export PATH="$HOME/.local/share/openclaw-installer/bin:$PATH"

# Windows (PowerShell)
$env:PATH = "$env:LOCALAPPDATA\openclaw-installer\bin;$env:PATH"

License

MIT