Hetzner

Maak de VPS aan

Maak een Ubuntu- of Debian-VPS aan bij Hetzner en maak vervolgens als root verbinding:

ssh root@YOUR_VPS_IP

Behandel de VPS als stateful infrastructuur, niet als wegwerpinfrastructuur.

Installeer Docker (op de VPS)

apt-get updateapt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sh

Controleer:

docker --versiondocker compose version

Kloon de OpenClaw-repository

git clone https://github.com/openclaw/openclaw.gitcd openclaw

Deze handleiding bouwt een aangepaste image, zodat alle ingebouwde binaire bestanden behouden blijven na herstarts.

Maak permanente hostmappen

Docker-containers zijn tijdelijk; alle langdurige status moet op de host worden opgeslagen.

mkdir -p /root/.openclaw/workspace # Stel de eigenaar in op de containergebruiker (uid 1000):chown -R 1000:1000 /root/.openclaw

Configureer omgevingsvariabelen

Maak .env in de hoofdmap van de repository:

OPENCLAW_IMAGE=openclaw:latestOPENCLAW_GATEWAY_TOKEN=OPENCLAW_GATEWAY_BIND=lanOPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/root/.openclawOPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace GOG_KEYRING_PASSWORD=XDG_CONFIG_HOME=/home/node/.openclaw

Stel OPENCLAW_GATEWAY_TOKEN in om het stabiele gatewaytoken te beheren via .env; configureer anders gateway.auth.token voordat je erop vertrouwt dat clients na herstarts verbonden blijven. Als geen van beide is ingesteld, gebruikt OpenClaw alleen voor die opstart een runtime-token. Genereer een sleutelringwachtwoord voor GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Commit dit bestand niet. Het bevat omgevingsvariabelen voor de container/runtime, zoals OPENCLAW_GATEWAY_TOKEN. Opgeslagen OAuth-/API-sleutelauthenticatie van providers bevindt zich in de gekoppelde ~/.openclaw/agents/<agentId>/agent/auth-profiles.json.

Docker Compose-configuratie

Maak of werk docker-compose.yml bij:

services:  openclaw-gateway:    image: ${OPENCLAW_IMAGE}    build: .    restart: unless-stopped    env_file:      - .env    environment:      - HOME=/home/node      - NODE_ENV=production      - TERM=xterm-256color      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin    volumes:      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace    ports:      # Aanbevolen: houd de Gateway op de VPS beperkt tot de loopback-interface; gebruik een SSH-tunnel voor toegang.      # Verwijder het voorvoegsel `127.0.0.1:` om deze openbaar beschikbaar te maken en configureer de firewall dienovereenkomstig.      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"    command:      [        "node",        "dist/index.js",        "gateway",        "--bind",        "${OPENCLAW_GATEWAY_BIND}",        "--port",        "${OPENCLAW_GATEWAY_PORT}",        "--allow-unconfigured",      ]

--allow-unconfigured is alleen bedoeld voor eenvoudig opstarten en vervangt geen echte gatewayconfiguratie. Stel nog steeds authenticatie (gateway.auth.token of een wachtwoord) en een veilige bindingsmodus in voor je implementatie.

Gedeelde runtimestappen voor een Docker-VM

Volg de gedeelde runtimehandleiding voor de algemene Docker-hostprocedure:

• Bouw vereiste binaire bestanden in de image in
• Bouwen en starten
• Wat waar permanent wordt opgeslagen
• Updates

Hetzner-specifieke toegang

Open de tunnel na de gedeelde stappen voor bouwen en starten.

Voorwaarde: controleer of de sshd-configuratie van je VPS TCP-doorsturing toestaat. Als je de SSH-configuratie hebt aangescherpt, controleer dan /etc/ssh/sshd_config en stel het volgende in:

AllowTcpForwarding local

local staat lokale ssh -L-doorsturing vanaf je laptop toe en blokkeert tegelijkertijd externe doorsturing vanaf de server. Als je dit instelt op no, mislukt de tunnel met: channel 3: open failed: administratively prohibited: open failed

Start na bevestiging dat TCP-doorsturing is ingeschakeld de SSH-service (systemctl restart ssh) opnieuw en voer de tunnel uit vanaf je laptop:

ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP

Open http://127.0.0.1:18789/ en plak het geconfigureerde gedeelde geheim. Deze handleiding gebruikt standaard het gatewaytoken; gebruik in plaats daarvan je geconfigureerde wachtwoord als je bent overgeschakeld op wachtwoordauthenticatie.