Skip to main content

Installer for OpenClaw - installs OpenClaw and starts the gateway

Reason this release was yanked:

cleanup

Project description

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:

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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openclaw_installer-1.0.30.tar.gz (61.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openclaw_installer-1.0.30-py3-none-any.whl (28.6 kB view details)

Uploaded Python 3

File details

Details for the file openclaw_installer-1.0.30.tar.gz.

File metadata

  • Download URL: openclaw_installer-1.0.30.tar.gz
  • Upload date:
  • Size: 61.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for openclaw_installer-1.0.30.tar.gz
Algorithm Hash digest
SHA256 a62570fe6670aa6723b5e1b1603340fee6e8af3812aa4e7efa890f0feeeb8a2d
MD5 61be0ff552c0d0000679dfaec955112f
BLAKE2b-256 cac9e2d2cd1c9dacf2989e60157bbbbfa750893d960d6601ccd3b214eda281bc

See more details on using hashes here.

File details

Details for the file openclaw_installer-1.0.30-py3-none-any.whl.

File metadata

File hashes

Hashes for openclaw_installer-1.0.30-py3-none-any.whl
Algorithm Hash digest
SHA256 dabab9851c8032872ca4340f087f80ee03db906863e2a8490d6489be2272ad21
MD5 52a8082d9f7c3f8aa99aeccc2d827ebc
BLAKE2b-256 3be1b0919c95aa8ead70a807c6389fccc73be6ae959ec36fee5e53e6c9dd8938

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page