Skip to main content

​
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

FoxAPI API Key

An active FoxAPI 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.
The auto installer is designed for fresh servers. Running it on a server with existing Docker installations or web services on port 3000/80/443 may cause conflicts.

​
Installation

1

Connect to Your Server

SSH into your server as root (or a user with sudo privileges):
ssh root@your-server-ip
2

Run the Auto Installer

Execute the one-click installation script:
bash <(curl -fsSL https://raw.githubusercontent.com/open-claw/open-claw/main/install.sh)
The installer will prompt you for:
PromptWhat to Enter
API KeyYour FoxAPI API key (sk-...)
API Base URLhttps://api.foxapi.cc/v1
Default Modele.g., claude-sonnet-4-20250514
PortApplication port (default: 3000)
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:
http://your-server-ip:3000
The installer will display the access URL and any generated credentials at the end.

​
Verify the Connection

  1. Open the OpenClaw web interface in your browser.
  2. Send a test message: “Hello, please confirm you are working.”
  3. 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:
  1. Point your domain’s DNS to your server IP.
  2. Install Nginx and Certbot: 
    apt install nginx certbot python3-certbot-nginx -y
  3. Configure Nginx as a reverse proxy and obtain an SSL certificate: 
    certbot --nginx -d your-domain.com

​
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: 
cd /opt/open-claw  # or wherever the installer placed the files
nano .env
docker compose down && docker compose up -d

​
Management Commands

CommandDescription
docker compose psCheck container status
docker compose logs -fView real-time logs
docker compose downStop OpenClaw
docker compose up -dStart OpenClaw
docker compose pull && docker compose up -dUpdate to latest version

​
Troubleshooting

  • Ensure your server has internet access.
  • Try downloading the script manually: 
    curl -fsSL https://raw.githubusercontent.com/open-claw/open-claw/main/install.sh -o install.sh
bash install.sh
  • 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.
  • Choose a different port when prompted by the installer.
  • Or stop the existing service: lsof -i :3000 to find and stop it.
  • Verify the API key and Base URL in the .env file.
  • Test the FoxAPI connection: 
    curl https://api.foxapi.cc/v1/models \
  -H "Authorization: Bearer sk-your-foxapi-api-key"
  • Check logs: docker compose logs -f