How to Install OpenClaw on Mac, Windows, Linux, Docker, or VPS
To install OpenClaw (formerly ClawdBot): Run curl -sSL https://get.openclaw.ai/install.sh | bash on Mac or Linux. For Windows, use WSL2 first. For business use, deploy on a VPS with Docker for 24/7 uptime and security isolation. The installer handles all dependencies automatically — setup takes under 15 minutes.
This guide covers every installation method, compares local device vs VPS deployment, and includes security hardening, troubleshooting, and post-install configuration.
Why Does Your Installation Method Matter?
OpenClaw is a proactive AI agent — it sends reminders, follows up on leads, monitors your systems, and executes tasks around the clock. If it goes offline because your laptop sleeps, your automations stop. For business use, where you run OpenClaw determines your uptime, security, and reliability.
The Laptop Problem
Install on your daily machine and OpenClaw dies when you close the lid, lose WiFi, or restart for updates. Leads go cold. Automations break.
Dedicated Device
A Raspberry Pi or Mac Mini running 24/7 solves uptime — but you're responsible for power, networking, and security on your home connection.
VPS / Cloud (Best)
Datacenter-grade uptime, security isolation, and remote access from anywhere. Your AI agent runs independently of your personal devices.
How Do You Install OpenClaw on a VPS?
Deploy OpenClaw on a cloud server for 24/7 uptime, security isolation, and reliable business automation. Takes about 15 minutes.
Requirements
Step 1: Provision Your VPS
Create an Ubuntu 22.04 or 24.04 VPS with at least 2 GB RAM. DigitalOcean, Hostinger, and Oracle Cloud (free tier) all work. If your VPS has less than 2 GB RAM, allocate a 4 GB swap file.
Step 2: SSH Into Your Server
Open your terminal and connect to your VPS as root. Replace YOUR_SERVER_IP with the IP from your provider's dashboard.
ssh root@YOUR_SERVER_IPStep 3: Run the One-Line Installer
This script detects your OS, installs all dependencies (Node.js, Docker if needed), and launches the setup wizard. The --install-daemon flag registers OpenClaw as a background service so it survives reboots.
curl -sSL https://get.openclaw.ai/install.sh | bash --install-daemonStep 4: Complete the Setup Wizard
The wizard walks you through: choosing your AI provider (Anthropic recommended), entering your API key, selecting messaging platforms to connect, and pairing your accounts. Choose "quick start" to skip advanced options.
Step 5: Verify Everything Works
Check the daemon is running, access the web dashboard, and test basic functionality. Save your OPENCLAW_GATEWAY_TOKEN — you'll need it for the dashboard.
openclaw status && openclaw test && openclaw logs --followStep 6: Harden Security
Bind the gateway to localhost (not 0.0.0.0), set up a firewall, and use Tailscale or an SSH tunnel for remote access. Never expose port 18789 to the public internet.
sudo ufw allow 22 && sudo ufw enableWant Step-by-Step Guidance?
Our workshop walks you through setup, prompt configuration, and the 5 mistakes that trip up most people.
How Do You Install OpenClaw on a Local Device?
Install directly on your Mac, Linux machine, Windows PC, or Raspberry Pi. Great for experimenting and personal use.
Mac / Linux — One-Line Install
The fastest path. Detects your OS, installs dependencies, configures optimal settings, and starts the service.
curl -sSL https://get.openclaw.ai/install.sh | bashWorks on macOS (Apple Silicon), Ubuntu, Debian, and Raspberry Pi OS.
macOS — Homebrew
If you prefer Homebrew package management, install via the official tap.
brew install openclaw/tap/openclaw && openclaw init && openclaw startRequires macOS 12+ with Homebrew installed.
Windows — WSL2
Install Ubuntu via WSL2, then run the standard Linux installer inside the WSL terminal.
wsl --install -d Ubuntu && wsl
curl -sSL https://get.openclaw.ai/install.sh | bashRequires Windows 10/11. USB/serial hardware passthrough needs additional config.
Raspberry Pi (4 or 5)
Dedicated 24/7 hardware you control. The Pi 5 with 8 GB RAM is ideal — it can run local LLM models up to 7B parameters.
curl -sSL https://get.openclaw.ai/install.sh | bash --install-daemonInvest in a USB-C UPS (~$25-40) and NVMe SSD via M.2 HAT instead of microSD to prevent corruption from power outages.
Docker (Any Platform)
Maximum isolation. Docker mounts ~/.openclaw for config and ~/openclaw/workspace as the agent's sandbox.
git clone https://github.com/openclaw/openclaw.git && cd openclaw && bash docker-setup.shRecommended for VPS deployments. Container isolation limits blast radius if something goes wrong.
Important: Local Install Limitations
- ✕OpenClaw stops when your device sleeps, loses power, or restarts — missed automations and cold leads.
- ✕Running on your primary machine means the AI has access to all your files, API tokens, and personal data.
- ✕Home internet outages take your agent offline — no follow-ups, no monitoring, no lead capture.
- ✕Security researchers found 135,000+ exposed OpenClaw instances from users who didn't configure firewalls.
For business automation, VPS deployment eliminates all of these issues. Our walks you through the entire VPS setup step by step.
Should You Install OpenClaw Locally or on a VPS?
| Feature | Local Device | VPS / Cloud |
|---|---|---|
| 24/7 Uptime | Only while powered on | Guaranteed — datacenter-grade |
| Security Isolation | Shares your personal machine | Isolated container — limited blast radius |
| Setup Complexity | One command | SSH + installer + firewall |
| Monthly Cost | $0 (your hardware) | $5-24/month |
| Power & Network | Depends on your home internet/power | Redundant datacenter infrastructure |
| Scalability | Limited by your hardware | Upgrade RAM/CPU in minutes |
| Remote Access | Requires port forwarding | Native — accessible from anywhere |
| Best For | Personal use, experimenting | Business automation, client work |
VPS Cost Breakdown
What Should You Do After Installing OpenClaw?
After installing, connect your messaging platforms and verify everything works.
Verify the Daemon
- Run openclaw status to check the service
- Access dashboard at localhost:18789
- Test with openclaw test
- View logs: openclaw logs --follow
Connect Messaging
- Telegram: Create bot via @BotFather → paste token
- WhatsApp: Scan QR code or use Business API
- Slack/Discord: Add app via OAuth
- iMessage: Pair via the setup wizard
Configure Your Agent
- Run openclaw configure for guided setup
- Set user account and network preferences
- Choose which skills to enable
- Configure notification settings
Install Skills
- Browse 10,700+ skills on ClawHub
- Core integrations built-in
- Thousands of community-built skills
- Run openclaw skills list to see installed
How Do You Secure Your OpenClaw Installation?
OpenClaw is a high-privilege agent with shell access and API tokens. Treat it like a server, not a chatbot. Follow this checklist to stay safe.
For a deeper dive, read our complete OpenClaw Security Guide.
What If Something Goes Wrong During Installation?
"RPC probe: failed" error
Port 18789 is blocked or in use. Find the conflicting process: sudo lsof -i :18789 — then terminate it or change the OpenClaw port in config.
Gateway not responding or "0 tokens used"
The daemon stopped or API authentication failed. Run: openclaw gateway restart — then verify your API keys are correctly set in ~/.openclaw/config.
EACCES permission errors in Docker
The Node user (UID 1000) lacks permission to mounted volumes. Fix: sudo chown -R 1000:1000 ~/.openclaw ~/openclaw/workspace
Config files still say "clawdbot" not "openclaw"
Normal during the transition from ClawdBot to OpenClaw. Directories like ~/.clawdbot/ and CLAWDBOT_GATEWAY_TOKEN still work — the rename is cosmetic.
Installer fails on older Ubuntu
OpenClaw requires Node.js 22+. On older Ubuntu: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs
WhatsApp/Telegram pairing not working
Ensure the gateway is running (openclaw status), your internet is connected, and your bot token is correct. For Telegram, make sure you created the bot via @BotFather and haven't revoked the token.
Your Competitors Are Already Automating. Are You?
Every week we send one automation that saves 10+ hours of manual work — the same playbooks our clients use to run their businesses on autopilot. Miss a week, miss the edge.
Get the Automation Playbook (Free)
One deploy-ready automation every week. Same strategies our clients pay thousands for. 400+ business owners already inside.
Need it done for you?
Book a Free Strategy Call See what we've built for real businesses →