Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Run a persistent OpenClaw Gateway on a DigitalOcean Droplet (~$6/month for the 1 GB Basic plan). DigitalOcean is the simplest paid VPS path. If you prefer cheaper or free options:
  • Hetzner — €3.79/mo, more cores/RAM per dollar.
  • Oracle Cloud — Always Free ARM (up to 4 OCPU, 24 GB RAM), but signup can be finicky and ARM-only.

​
Prerequisites

  • DigitalOcean account (signup)
  • SSH key pair (or willingness to use password auth)
  • About 20 minutes

​
Setup

1

Create a Droplet

Use a clean base image (Ubuntu 24.04 LTS). Avoid third-party Marketplace 1-click images unless you have reviewed their startup scripts and firewall defaults.
  1. Log into DigitalOcean.
  2. Click Create > Droplets.
  3. Choose:
    • Region: Closest to you
    • Image: Ubuntu 24.04 LTS
    • Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
    • Authentication: SSH key (recommended) or password
  4. Click Create Droplet and note the IP address.
2

Connect and install

ssh root@YOUR_DROPLET_IP

apt update && apt upgrade -y

# Install Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
3

Run onboarding

openclaw onboard --install-daemon
The wizard walks you through model auth, channel setup, gateway token generation, and daemon installation (systemd).
4

Add swap (recommended for 1 GB Droplets)

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
5

Verify the gateway

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
6

Access the Control UI

The gateway binds to loopback by default. Pick one of these options.Option A: SSH tunnel (simplest)
# From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
Then open http://localhost:18789.Option B: Tailscale Serve
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
Then open https://<magicdns>/ from any device on your tailnet.Tailscale Serve authenticates Control UI and WebSocket traffic via tailnet identity headers, which assumes the gateway host itself is trusted. HTTP API endpoints follow the gateway’s normal auth mode (token/password) regardless. To require explicit shared-secret credentials over Serve, set gateway.auth.allowTailscale: false and use gateway.auth.mode: "token" or "password".Option C: Tailnet bind (no Serve)
openclaw config set gateway.bind tailnet
openclaw gateway restart
Then open http://<tailscale-ip>:18789 (token required).

​
Persistence and backups

OpenClaw state lives under:
  • ~/.openclaw/ — openclaw.json, per-agent auth-profiles.json, channel/provider state, and session data.
  • ~/.openclaw/workspace/ — the agent workspace (SOUL.md, memory, artifacts).
These survive Droplet reboots. To take a portable snapshot: 
openclaw backup create
DigitalOcean snapshots back the whole Droplet up; openclaw backup create is portable across hosts.

​
1 GB RAM tips

The $6 Droplet only has 1 GB RAM. To keep things smooth:
  • Make sure the swap step above is in /etc/fstab so it survives reboots.
  • Prefer API-based models (Claude, GPT) over local ones — local LLM inference does not fit in 1 GB.
  • Set agents.defaults.model.primary to a smaller model if you hit OOMs on large prompts.
  • Monitor with free -h and htop.

​
Troubleshooting

Gateway will not start — Run openclaw doctor --non-interactive and check logs with journalctl --user -u openclaw-gateway.service -n 50. Port already in use — Run lsof -i :18789 to find the process, then stop it. Out of memory — Verify swap is active with free -h. If still hitting OOM, use API-based models (Claude, GPT) rather than local models, or upgrade to a 2 GB Droplet.

​
Next steps