Skip to main content
Moltbot (formerly Clawdbot) is a self-hosted personal AI assistant platform that can connect to multiple messaging channels (WhatsApp, Telegram, Slack, Discord, and more). This guide shows how to deploy Moltbot on your Veerhost VPS using Docker.

​
Requirements

​
What you need

  • A Veerhost VPS (Ubuntu/Debian recommended)
  • Root access (or a sudo user)
  • A domain is optional (IP access works fine)

​
Optional (for AI integrations)

  • OpenAI API key (optional)
  • Anthropic API key (optional)
1

Connect to your VPS

Use SSH from your computer and connect to your VPS IP using the credentials from your Veerhost VPS details.
2

Update your server

Run system updates to ensure packages are current before installing Docker.
3

Install Docker + Docker Compose

Install Docker Engine and Docker Compose on your VPS.
4

Create a Moltbot project folder

Create a folder such as:
sudo mkdir -p /opt/moltbot
cd /opt/moltbot
5

Create your environment file (.env)

Inside the project folder, create an environment file (commonly .env) and add:Required:
  • MOLTBOT_GATEWAY_TOKEN (generate a strong token and save it)
Optional:
  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY
Example:
MOLTBOT_GATEWAY_TOKEN=replace_with_a_strong_token
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
Important: Store your MOLTBOT_GATEWAY_TOKEN securely. You’ll need it to access and pair the Moltbot web interface.
6

Deploy Moltbot using Docker Compose

Create a Docker Compose configuration for Moltbot (using the official container image and recommended ports), then start the stack using Docker Compose.
7

Confirm the container is running

Check container status and logs to ensure Moltbot started successfully and the web port is exposed.

​
Installation Option 2: Install on an existing VPS

1

Check if Docker is installed

If Docker is already installed, confirm Docker and Compose are available and working.
2

Prepare a project directory

Use a dedicated folder for easier upgrades:
sudo mkdir -p /opt/moltbot
cd /opt/moltbot
3

Configure environment variables

Add your required token and any optional API keys in your .env file.
4

Deploy and verify

Start the containers and confirm the status is healthy and running.

​
Accessing Moltbot

​
Find your web interface port

Your Compose file defines the port for the web interface. Once running, access Moltbot using: http://YOUR-VPS-IP:PORT Tip: If you’re using a firewall, ensure the web interface port is allowed (and allow 80/443 if you later put it behind a reverse proxy).

​
Post-installation setup

1

Add your Gateway Token

Open the Moltbot web interface and go to Overview.
  • Paste your MOLTBOT_GATEWAY_TOKEN
  • Click Connect
  • You should see Connected when authentication succeeds
2

Connect messaging channels (example: WhatsApp)

Open the RAW configuration editor:
  • Go to Settings → Config
  • Open the RAW configuration editor
Add a WhatsApp section like this (replace the phone number with your real number in international format, e.g. +1234567890):
{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+1234567890"],
      "groupPolicy": "allowlist",
      "mediaMaxMb": 50,
      "debounceMs": 0
    }
  }
}
Apply and update:
  • Click Apply
  • Click Update
Pair WhatsApp:
  • Go to Channels and select Show QR
  • On your phone: WhatsApp → Settings → Linked devices → Link a device
  • Scan the QR code
Note: If you see a stream/login failure, return to Settings → Config, click Update, then check Channels again.
3

Configure your AI model provider (optional)

If you set OPENAI_API_KEY, you can specify a default model in the RAW config:
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-4o"
      },
      "maxConcurrent": 4
    },
    "subagents": {
      "maxConcurrent": 8
    }
  }
}
Apply and update:
  • Click Apply
  • Click Update
Note: Change the model name based on what you want to use and what your provider supports.

​
Managing your Moltbot instance

​
View logs

Use Docker to view container logs when troubleshooting startup issues, connection problems, or channel pairing failures.

​
Update Moltbot

To upgrade Moltbot:
  • Pull the latest image
  • Recreate/restart containers using Docker Compose
This updates the service while keeping your configuration and environment variables.

​
Security notes

​
Keep credentials private

  • Do not share MOLTBOT_GATEWAY_TOKEN
  • Never publish API keys (OpenAI/Anthropic)
  • Avoid committing .env files into Git repositories
  • Use a firewall and only open required ports
  • Use HTTPS via a reverse proxy if exposing Moltbot publicly
  • Keep your VPS updated regularly