How To Install OpenClaw on Linux Mint 22

8 minutes read

If you’ve been looking for a powerful, self-hosted AI automation assistant that runs quietly in the background and integrates with your messaging apps, OpenClaw is the answer. Installing it on Linux Mint 22 is straightforward — but only if you follow the right steps from the start. In this guide, you’ll learn exactly how to install OpenClaw on Linux Mint 22, configure it as a persistent background service, and get it running reliably with minimal friction. Whether you’re a developer automating workflows or a sysadmin setting up a local AI agent, this tutorial has everything you need.

Table of Contents

What Is OpenClaw and Why Run It on Linux Mint 22?

OpenClaw (formerly known as Clawdbot/Moltbot) is a free, open-source, self-hosted AI assistant that runs locally on your machine or a VPS. It connects to messaging platforms like WhatsApp, Telegram, and Slack, and integrates with AI models from providers like OpenAI, Anthropic, and Google Gemini via API keys.

Think of it as a personal automation engine: it can browse the web, send reminders, run shell commands, fetch articles, organize files, and execute scheduled jobs — all triggered through a chat message.

Linux Mint 22 is based on Ubuntu 24.04 LTS Noble, which makes it a first-class environment for OpenClaw. The Ubuntu-based package ecosystem, full systemd support, and compatibility with the NodeSource repository make Mint 22 one of the smoothest platforms to run OpenClaw on.

OpenClaw is still in beta, so the developers themselves recommend running it on a dedicated machine or VPS rather than your primary personal computer — this reduces the risk of exposing personal files if a vulnerability is ever discovered. Keep that in mind as you follow along.

Prerequisites

Before you begin the OpenClaw on Linux Mint 22 setup, confirm the following requirements are in place.

Operating System:

Linux Mint 22 (Cinnamon, MATE, or XFCE edition — all supported)
Based on Ubuntu 24.04 LTS — fully compatible with OpenClaw

User Permissions:

A non-root user with sudo privileges
Avoid running the install script as root directly

Required Tools:

curl — used to download and execute the install script
git — auto-detected and installed by the script if missing
Node.js v22+ — the installer handles this automatically via NodeSource
An API key from at least one AI provider (OpenAI, Anthropic, or Google Gemini)

Hardware Minimum:

x86_64 or arm64 processor
1 GB RAM (4 GB recommended for smooth operation)
~500 MB free disk space

Optional:

Chromium browser (required only for browser automation skills)
A Telegram or WhatsApp account (for messaging channel integration)

Step 1: Update Your Linux Mint 22 System

The first thing you should always do before installing any new software on a Linux server tutorial is update your package lists and upgrade existing packages. This prevents dependency conflicts and ensures you’re pulling from fresh repositories.

Open your terminal (Ctrl+Alt+T) and run:

sudo apt update && sudo apt upgrade -y

What this does:

sudo apt update — refreshes your local package index from all configured repositories
sudo apt upgrade -y — upgrades all installed packages to their latest versions without asking for confirmation

Expected output: You’ll see a list of packages being fetched and upgraded. The process may take 1–3 minutes depending on your internet speed. Once it completes, your system is clean and ready for the installation.

Step 1.1 — Install curl (If Not Already Present)

curl is the command-line tool the OpenClaw installer uses to download and run the setup script. Check if it’s already installed:

curl --version

If you see a version number, you’re good to go. If not, install it:

sudo apt install -y curl

Step 1.2 — Verify Git Is Available

git --version

If Git isn’t installed, add it manually:

sudo apt install -y git

The OpenClaw install script will also detect and install Git automatically, but verifying upfront saves time.

Step 2: Run the OpenClaw One-Liner Install Script

Now comes the core step of this how to install OpenClaw on Linux Mint 22 guide. The OpenClaw team provides an official installation script that handles almost everything for you: OS detection, Node.js installation, dependency management, and onboarding setup.

Run this single command in your terminal:

curl -fsSL https://openclaw.ai/install.sh | bash

What this command does, step by step:

Detects your OS — Linux Mint 22 is recognized as Ubuntu-based
Updates the local package index — equivalent to running apt update
Installs Node.js 22 from the official NodeSource repository
Installs prerequisite packages — git, curl, gnupg, ca-certificates
Installs the OpenClaw npm package globally
Launches the onboarding text-based UI (TUI) automatically

Important: The installer will display a security disclaimer at the beginning. Read it carefully before proceeding. It outlines the risks of running OpenClaw on a personal machine and recommends a dedicated server environment.

Select Yes to acknowledge and continue.

Step 2.1 — Alternative Install via npm (Advanced Users)

If you already have Node.js v22+ installed, skip the script and install directly via npm:

npm i -g openclaw@latest

Use this method if you prefer granular control over your Node.js environment or manage multiple Node versions via nvm.

Step 2.2 — Verify the Installation

Once the script finishes, confirm OpenClaw installed correctly:

openclaw --version

Expected output:

🦞 OpenClaw 2026.x.x

If you see a version number, the installation succeeded. If you get a “command not found” error, jump to the Troubleshooting section below.

Step 3: Complete the OpenClaw Onboarding Setup

After installation, the onboarding text-based UI launches automatically. This is where you configure OpenClaw on Linux Mint 22’s core settings. Work through each section carefully.

Step 3.1 — Select Onboarding Mode

Choose Manual mode. This gives you full control over gateway settings, AI model selection, and channel configuration.

Step 3.2 — Configure the Gateway

When prompted for Gateway type, select Local Gateway on loopback address (127.0.0.1). This binds the gateway to your local machine only — the safest configuration for a desktop setup.

For the workspace directory, press Enter to accept the default path (~/workspace).

Step 3.3 — Set Your AI Provider and API Key

Select your preferred AI provider. The options include:

OpenAI (GPT-4o, GPT-4 Turbo)
Anthropic (Claude 3.5 Sonnet, Claude 3 Opus)
Google (Gemini 1.5 Pro, Gemini Flash)

When prompted for authentication, select API Key and paste in your provider’s key. For the model, pressing Enter accepts the default for your selected provider.

Step 3.4 — Configure the Gateway Port and Auth Token

Gateway port: Press Enter to accept the default port 18789
Gateway bind: Select Loopback (127.0.0.1)
Gateway auth: Press Enter to auto-generate a secure access token

Save this token. You’ll need it to log into the OpenClaw web dashboard.

Step 3.5 — Skip Optional Configuration for Now

The installer will prompt you to configure a Chat Channel (Telegram, WhatsApp, Slack), install Skills, and enable Hooks. You can safely skip all of these during the initial setup. You can add them later using openclaw channels add.

Step 4: Install the OpenClaw Gateway as a systemd Service

The gateway is the brain of your OpenClaw setup. It listens for inbound traffic from messaging channels, routes commands to agents, and manages your session state. Running it as a systemd service ensures it starts automatically on boot and restarts if it ever crashes.

During the onboarding process, you’ll be prompted to install the Gateway service. Select Yes. This is the simplest path.

Alternatively, run either of these commands to install or reinstall the daemon:

openclaw onboard --install-daemon

Or:

openclaw gateway install

Step 4.1 — Manual systemd Unit (Advanced Configuration)

If you prefer to set up the systemd unit manually, create the service file:

mkdir -p ~/.config/systemd/user
nano ~/.config/systemd/user/openclaw-gateway.service

Paste in the following configuration:

[Unit]
Description=OpenClaw Gateway
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Save the file (Ctrl+O, then Enter, then Ctrl+X), then enable and start the service:

systemctl --user enable --now openclaw-gateway.service

Step 4.2 — Verify the Gateway Is Running

Check the service status:

openclaw gateway status

Expected output includes:

Service state: enabled/active
PID and bind address: 127.0.0.1:18789
Location of main config file (~/.openclaw.json)
Dashboard URL with your access token

You can also confirm the port is listening:

ss -pnltu | grep openclaw

To restart the gateway at any time:

openclaw gateway restart

Step 5: Access the OpenClaw Web UI Dashboard

With the gateway running, open Firefox (default browser on Linux Mint) and navigate to:

http://127.0.0.1:18789/

Paste your access token from Step 3.4 to log in.

The dashboard gives you a central view of:

Overview — gateway health, uptime, and connected status (green indicator = healthy)
Agents — configure AI agent personalities and skills
Channels — manage connected messaging apps
Skills — browse and install automation capabilities from Clawhub
Cron jobs — schedule recurring automated tasks

Step 5.1 — Remote Access via SSH Tunnel

If you’re running OpenClaw on a remote VPS or a headless server, use an SSH tunnel to access the dashboard from your local machine:

ssh -N -L 18789:127.0.0.1:18789 your-user@your-server-ip

Open http://127.0.0.1:18789/ in your local browser while the tunnel is active. You’ll get the full dashboard without exposing the port publicly.

Step 6: Connect a Messaging Channel (Optional but Recommended)

OpenClaw’s real power comes from chatting with it through WhatsApp, Telegram, or Slack. To add a channel after setup:

openclaw channels add

For WhatsApp:

Select WhatsApp (QR Link)
Select default (primary account)
Scan the QR code with your phone
Enter your full phone number with country code
Press Enter to finish

To verify connected channels:

openclaw channels list

Expected output:

🦞 OpenClaw 2026.x.x — curl for conversations.

Chat channels:
- WhatsApp default (Your Name): linked, enabled

Send a test message from the CLI:

openclaw message send --channel whatsapp --target "+62xxxxxxxxxx" --message "Hello from OpenClaw"

You should receive the message on your phone immediately. From that point, you can chat with OpenClaw, assign tasks, and receive AI-generated responses directly from WhatsApp.

Troubleshooting Common Errors on Linux Mint 22

Even with a smooth installer, things can go wrong. Here are the five most common issues and how to fix them on your Linux Mint 22 machine.

Error 1: “openclaw: command not found”

Cause: The npm global binary path is not in your shell’s PATH.

Fix:

export PATH="$PATH:$(npm bin -g)"

To make this permanent, add the line to your shell config:

echo 'export PATH="$PATH:$(npm bin -g)"' >> ~/.bashrc
source ~/.bashrc

Error 2: Node.js Version Too Old (Requires v22+)

Cause: Linux Mint’s default repositories ship an older Node.js version.

Fix: Remove the old version and install Node.js 22 from NodeSource:

sudo apt remove nodejs -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs
node --version

Error 3: Gateway Service Fails to Start

Cause: Misconfigured systemd unit, stale PID, or config file corruption.

Fix: Run the built-in OpenClaw repair tool:

openclaw doctor

To check detailed logs:

journalctl --user -u openclaw-gateway.service -f

Error 4: Permission Denied During Installation

Cause: Running the install script as root, or your user account lacks sudo access.

Fix: Confirm your user can use sudo:

sudo whoami

Expected output: root. If you get a permission error, add your user to the sudo group:

usermod -aG sudo your-username

Log out and back in for the change to take effect.

Error 5: Browser Automation Skills Not Working

Cause: Chromium or its required system libraries are missing.

Fix: Install Chromium and all required dependencies:

sudo apt install -y chromium-browser \
  libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 \
  libxcomposite1 libxdamage1 libxfixes3 libxrandr2 \
  libgbm1 libasound2

Verify:

which chromium-browser

How to Update or Uninstall OpenClaw

Updating OpenClaw

Always keep OpenClaw updated to receive the latest security patches and features:

npm update -g openclaw

Or re-run the original install script to pull the latest version fresh:

curl -fsSL https://openclaw.ai/install.sh | bash

Verify your version after updating:

openclaw --version

Uninstalling OpenClaw

To completely remove OpenClaw from your system:

# Step 1: Stop and disable the gateway service
systemctl --user stop openclaw-gateway.service
systemctl --user disable openclaw-gateway.service

# Step 2: Remove the npm package
npm uninstall -g openclaw

# Step 3: Delete configuration files and workspace
rm -rf ~/.openclaw ~/.openclaw.json

Congratulations! You have successfully installed OpenClaw. Thanks for using this tutorial for installing the OpenClaw Personal AI Assistant on your Linux Mint 22 system. For additional help or useful information, we recommend you check the official OpenClaw website.

VPS Manage Service Offer

If you don’t have time to do all of this stuff, or if this is not your area of expertise, we offer a service to do “VPS Manage Service Offer”, starting from $10 (Paypal payment). Please contact us to get the best deal!