Skip to main content

Vanilla 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.15.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.15-py3-none-any.whl (25.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openclaw_installer-1.0.15.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.15.tar.gz
Algorithm Hash digest
SHA256 fd058bcdfc7e8e4e02006e365b3b03c93aa968a045116b2d8f29e6a447b27652
MD5 01de3e2065f8fd1be57792635e89fdfa
BLAKE2b-256 15da052a271766d66985070ed75c84207e04222f5c88667352cfb0ab70e9aa3d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for openclaw_installer-1.0.15-py3-none-any.whl
Algorithm Hash digest
SHA256 78bd226c398382314fd6456aa87f2b89a6d9e29124bf14e70c0d909572ff51d8
MD5 2db312f5f85fe90d606098d08b60b50d
BLAKE2b-256 c97f12078b2677f6cec62831ad26249c0b6c6581f0c2fb2c70eefb2e8653dce6

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