For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/bare-metal-cloud/vps/install-openclaw-agent.md.
  • English

How to install an OpenClaw agent on a VPS

View as Markdown

OpenClaw (successor to Moltbot and Clawdbot) is the new evolved version of the autonomous AI assistant. This guide uses Docker to protect your host system while ensuring your assistant remains online 24/7.

 

Requirements

 

Instructions

Table of contents:

 

Step 1 - Install Docker

On your VPS, install Docker and its Compose plugin:

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

Note: Log out and log back in via SSH for the Docker group addition to take effect.

 

Step 2 - Prepare directories

Docker needs folders on your VPS to store data permanently (WhatsApp sessions, memory).

mkdir -p ~/openclaw/data
cd ~/openclaw

 

Step 3 - Deployment configuration

Create a file named docker-compose.yml in this folder:

nano docker-compose.yml

Copy the following configuration into it:

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: always
    ports:
      - "127.0.0.1:18789:18789"
    volumes:
      - ~/openclaw/data:/home/node/.openclaw
    environment:
      - NODE_ENV=production
Warning

Security: By using 127.0.0.1:18789:18789, the port is exposed only within the VPS. No one can access it from the outside without the SSH tunnel.

 

Step 4 - Launch

Start your agent:

docker compose up -d

 

Step 5 - Secure access via an SSH tunnel

  1. On your personal computer, create the tunnel.

    The method remains the same. From your personal computer, open a terminal:

    • Windows: PowerShell or Command Prompt (cmd).
    • Linux / macOS: Terminal.
    ssh -L 18789:127.0.0.1:18789 user@YOUR_VPS_IP

    Keep this terminal window open for the entire duration of your use.

  2. On your VPS (another terminal window), retrieve your access token:

    cat ~/openclaw/data/openclaw.json | grep '"token":'

    Open your browser and go to: http://127.0.0.1:18789.

Tip: If the interface remains disconnected, you can force the connection by using your token directly in the URL: http://127.0.0.1:18789/?token=YOUR_GATEWAY_TOKEN

The rest takes place in the Overview menu: enter your Gateway Token to log in.

 

Go further

Secure an OVHcloud VPS

Official OpenClaw documentation

Browse all the Virtual Private Servers guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about VPS on the OVHcloud US website.