Overview
The OpenClaw auto installer provides a streamlined, one-click setup experience. It handles Docker installation, configuration, and deployment automatically — getting you from zero to a running AI chatbot in minutes.If you prefer more control over the installation process, see the OpenClaw Manual Installation guide.
Prerequisites
AihubMax API Key
An active AihubMax API key.
Linux Server
A fresh Linux server (Ubuntu 20.04+, Debian 11+, or CentOS 8+) with root access. Minimum 1 CPU core and 1 GB RAM.
Installation
1
Connect to Your Server
SSH into your server as root (or a user with sudo privileges):
2
Run the Auto Installer
Execute the one-click installation script:The installer will prompt you for:
The script will automatically:
- Install Docker and Docker Compose (if not present)
- Download the OpenClaw application
- Generate secure configuration values
- Start the application
3
Access the Application
Once the installer completes, access OpenClaw at:The installer will display the access URL and any generated credentials at the end.
Verify the Connection
- Open the OpenClaw web interface in your browser.
- Send a test message: “Hello, please confirm you are working.”
- If you receive an AI response, the installation is successful.
Post-Installation
Set Up a Custom Domain (Optional)
To access OpenClaw via a custom domain with HTTPS:- Point your domain’s DNS to your server IP.
- Install Nginx and Certbot:
- Configure Nginx as a reverse proxy and obtain an SSL certificate:
Enable Telegram or Feishu Integration
After the auto install completes, you can add bot integrations: Edit the.env file in the OpenClaw directory and restart:
Management Commands
Troubleshooting
Installer script fails to download
Installer script fails to download
- Ensure your server has internet access.
- Try downloading the script manually:
Docker installation fails
Docker installation fails
- Check your Linux distribution is supported (Ubuntu 20.04+, Debian 11+, CentOS 8+).
- Try installing Docker manually first:
curl -fsSL https://get.docker.com | sh - Then re-run the OpenClaw installer.
Port 3000 is already in use
Port 3000 is already in use
- Choose a different port when prompted by the installer.
- Or stop the existing service:
lsof -i :3000to find and stop it.
AI responses not working after install
AI responses not working after install
- Verify the API key and Base URL in the
.envfile. - Test the AihubMax connection:
- Check logs:
docker compose logs -f