> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw Auto Install

> One-click installation of OpenClaw with AihubMax

## 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.

<Info>
  If you prefer more control over the installation process, see the [OpenClaw Manual Installation](/en/integration-guide/openclaw) guide.
</Info>

## Prerequisites

<CardGroup cols={2}>
  <Card title="AihubMax API Key" icon="key">
    An active AihubMax API key.
  </Card>

  <Card title="Linux Server" icon="server">
    A fresh Linux server (Ubuntu 20.04+, Debian 11+, or CentOS 8+) with root access. Minimum 1 CPU core and 1 GB RAM.
  </Card>
</CardGroup>

<Warning>
  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.
</Warning>

## Installation

<Steps>
  <Step title="Connect to Your Server">
    SSH into your server as root (or a user with sudo privileges):

    ```bash theme={null}
    ssh root@your-server-ip
    ```
  </Step>

  <Step title="Run the Auto Installer">
    Execute the one-click installation script:

    ```bash theme={null}
    bash <(curl -fsSL https://raw.githubusercontent.com/open-claw/open-claw/main/install.sh)
    ```

    The installer will prompt you for:

    | Prompt            | What to Enter                      |
    | ----------------- | ---------------------------------- |
    | **API Key**       | Your AihubMax API key (`sk-...`)   |
    | **API Base URL**  | `https://api.aihubmax.com/v1`      |
    | **Default Model** | e.g., `claude-sonnet-4-20250514`   |
    | **Port**          | Application 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
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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:
   ```bash theme={null}
   apt install nginx certbot python3-certbot-nginx -y
   ```
3. Configure Nginx as a reverse proxy and obtain an SSL certificate:
   ```bash theme={null}
   certbot --nginx -d your-domain.com
   ```

### Enable Telegram or Feishu Integration

After the auto install completes, you can add bot integrations:

* [OpenClaw + Telegram](/en/integration-guide/openclaw-telegram)
* [OpenClaw + Feishu](/en/integration-guide/openclaw-feishu)

Edit the `.env` file in the OpenClaw directory and restart:

```bash theme={null}
cd /opt/open-claw  # or wherever the installer placed the files
nano .env
docker compose down && docker compose up -d
```

## Management Commands

| Command                                       | Description              |
| --------------------------------------------- | ------------------------ |
| `docker compose ps`                           | Check container status   |
| `docker compose logs -f`                      | View real-time logs      |
| `docker compose down`                         | Stop OpenClaw            |
| `docker compose up -d`                        | Start OpenClaw           |
| `docker compose pull && docker compose up -d` | Update to latest version |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Installer script fails to download">
    * Ensure your server has internet access.
    * Try downloading the script manually:
      ```bash theme={null}
      curl -fsSL https://raw.githubusercontent.com/open-claw/open-claw/main/install.sh -o install.sh
      bash install.sh
      ```
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Port 3000 is already in use">
    * Choose a different port when prompted by the installer.
    * Or stop the existing service: `lsof -i :3000` to find and stop it.
  </Accordion>

  <Accordion title="AI responses not working after install">
    * Verify the API key and Base URL in the `.env` file.
    * Test the AihubMax connection:
      ```bash theme={null}
      curl https://api.aihubmax.com/v1/models \
        -H "Authorization: Bearer sk-your-foxapi-api-key"
      ```
    * Check logs: `docker compose logs -f`
  </Accordion>
</AccordionGroup>