OpenClaw Gateway
Install

Self-hosted AI agents via de OpenClaw Gateway: CLI op Node.js, daarna openclaw.json + .env, systemd of Docker Compose, en verificatie met gateway status and /healthz.

✓ Gateway :18789 · healthz
✓ systemd of Docker
✓ approvals vóór mutating tools

direct answer

Hoe installeer je
de OpenClaw Gateway?

In short: installeer Node.js v20+ → npm install -g openclaw → vul ~/.openclaw/openclaw.json and .env in (gateway.mode=local, upstream API keys, gateway.auth) → start de Gateway via systemd (Linux VPS) of Docker Compose → controleer met openclaw gateway status and curl http://127.0.0.1:18789/healthz.

Docker nodig? Nee voor een eerste lokale test. Wel aanbevolen voor reproduceerbare productie-deploy, health checks en volume-backups. Gebruik niet tegelijk npm-global Gateway én een compose-stack op dezelfde host zonder poortscheiding.

Veilig lokaal? Ja met localhost-bind, chmod 600 .env and approvals vóór mail/browser/shell in productie. Zie safety. Hub: OpenClaw overzicht.

🧪
Hobby-setup
Laptop, CLI, lokale Gateway, beperkte tools. Doel: leren en doctor groen krijgen — geen open poort naar internet.
🏭
Productie-setup
VPS, systemd of Docker, reverse proxy, logging, approvals, gepinde image-tags.
✅
human-in-the-loop
Mutating acties (mail send, shell, browser submit) horen niet “autonoom” aan — configureer policies na eerste ready.
🌐
Browser-risico
Browser automation deelt sessies en injection-risico’s. Lees Browser automation vóór productie-CRM flows.

Gateway node — vereisten

What do you need
vóór de Gateway start?

Hobby vs productie: meer RAM en logging zodra browser tools en mail kanalen actief zijn.

🖥 Operating system
  • macOS 12 Monterey or later
  • Windows 10 / 11 (64-bit)
  • Ubuntu 20.04 LTS or higher
  • Debian, Fedora, Arch (community support)
⚙️ Runtime & package management
  • Node.js v18.x LTS (minimum)
  • Node.js v20.x or v22.x (recommended)
  • npm v9+ or Yarn v1.22+
  • pnpm v8+ (optional, faster)
💾 Hardware
  • Hobby: 1 GB RAM · productie agents: 2–4 GB+
  • Schijf voor ~/.openclaw/ state + logs
  • Internet voor npm + upstream LLM API
  • Poort 18789 vrij (of expliciete mapping)
📦 Deploy-paden
  • systemd — Linux VPS, één Gateway-service
  • Docker Compose — healthz, volumes, proxy
  • Reverse proxy (Nginx/Traefik) voor TLS + WebSocket
  • open claw doctor na elke config-wijziging

Gateway installatie

Install OpenClaw:
CLI → config → Gateway ready.

Zelfde volgorde als in de Knowledge hub: daarna safety and workflows.

01

Node.js (Gateway runtime)

De OpenClaw Gateway draait op Node.js. Gebruik v20 LTS op productie (minimum v18). Op Linux VPS is dit dezelfde runtime als voor systemd of Docker sidecars.

$ node --version && npm --version
02

OpenClaw CLI installeren

Globale CLI voor Gateway-beheer: status, doctor, logs, channels. Dit is geen aparte “pipeline CLI” — alles hangt aan de Gateway-node.

$ npm install -g openclaw && openclaw --version
03

Gateway config & .env

Zet gateway.mode=local, vul upstream keys (ANTHROPIC_API_KEY, OpenAI-compatible, of OLLAMA_HOST) en configureer gateway.auth vóór je bindt op LAN. Eén bron van waarheid: dezelfde user als systemd User= of Docker volume.

$ openclaw doctor && chmod 600 .env
04

Gateway starten (systemd of Docker)

systemd: service-unit op Linux VPS. Docker: see Docker Compose — publish alleen 127.0.0.1:18789, TLS op reverse proxy. Niet twee Gateways op één host.

$ sudo systemctl enable --now openclaw
05

Verificatie: status & healthz

Gateway moet Runtime: running and RPC probe: ok tonen. HTTP /healthz op localhost bevestigt dat de listener klaar is vóór je kanalen koppelt.

$ openclaw gateway status && curl -sS http://127.0.0.1:18789/healthz
06

Governance & monitoring

Schakel approvals in voor mutating tools. Stel logging/audit in (logs & monitoring) vóór mail of Browser automation in productie.

$ openclaw logs --follow
07

Install-debug (compact)

Gateway blijft op starting of Docker unhealthy? Eerst logs — geen volume-wipe. Docker: docker compose ps → logs. systemd: journalctl -u openclaw-gateway -n 80 --no-pager.

$ openclaw doctor && openclaw logs --follow
08

Herstart na config-fix

after .env or openclaw.json-fix: gerichte restart. Bij Docker recreate; bij systemd systemctl restart openclaw. Blijft het falen? OpenClaw Problems.

$ docker compose restart  # of: sudo systemctl restart openclaw

SEO variants & search intent

Frequently asked searches
about OpenClaw.

People search for different variations of "install OpenClaw". This page answers them all.

Keyword Search intent Volume CPC PD Difficulty Covered on this page
Install OpenClaw Informative — €0,00 1 17 ✓ Gateway stappen 1–8, direct antwoord
OpenClaw tutorial Informative 10 €0,00 2 19 ✓ Step section
OpenClaw setup Informative 10 €0,00 5 20 ✓ System requirements, step 2
configuring OpenClaw Informative — €0,00 1 15 ✓ Step 5, FAQ
openclaw download Transactional — €0,00 1 16 ✓ Hero, step 1 & 2
OpenClaw manual Informative — €0,00 1 14 ✓ Full page
What is OpenClaw Informative — €0,00 1 12 ✓ Direct antwoord (Gateway)
OpenClaw step by step Informative — €0,00 1 13 ✓ Step section
OpenClaw Beginners Informative — €0,00 1 11 ✓ Intro, steps, FAQ
openclaw node.js Informative — €0,00 1 18 ✓ Requirements, step 1

Na Gateway ready

Realistische flows
(niet alles autonoom).

Pas na gateway status + governance: zie workflows voor MKB-voorbeelden.

📬
Mail triage
Lezen en classificeren met approvals op send/reply — geen volledige mailbox zonder policy.
🌐
Browser automation
DOM-stappen met session isolation; submit altijd via human-in-the-loop.
✅
Approvals queue
Shell, mail en browser mutaties in queue — anders lijkt de agent “kapot” terwijl hij wacht.
📋
Audit & logs
Correlation-id per tool-call; essentieel vóór productie-debug.
🐳
Docker deploy
Compose + healthz + volume-backups — zelfde config als bare-metal.
🔒
Hardening
Least privilege, geen open Gateway, prompt-injection awareness op actieve agents.

Deploy-keuze

systemd vs Docker
voor de Gateway.

Geen “beste tool”-hype — wanneer past welk pad bij self-hosted agents?

Criterion systemd (bare metal) Docker Compose Hobby (lokaal)
Linux VPS productie ✔ ✔ ~
healthz / container isolation ~ ✔ ✗
journalctl / compose logs ✔ ✔ ~
Volume-backup vóór upgrade ~ ✔ ✗
Eén Gateway per host ✔ ✔ ✔
Approvals + audit verplicht ✔ ✔ ~
Reverse proxy + WebSocket ✔ ✔ ✗

Productie-ervaring

Wat teams leren na
Gateway deploy.

★★★★★

Eerst doctor groen, daarna pas mail-tool. De approval-queue voelde als “bug” tot we logging hadden staan — daarna was het duidelijk human-in-the-loop.

JV
Jeroen V.
Fullstack developer, Utrecht
★★★★★

Docker Compose met healthz bespaarde uren debug. Belangrijkste les: niet npm-global én container op dezelfde VPS — één Gateway, één poort 18789.

SK
Sara K.
Tech Lead, Amsterdam
★★★★☆

systemd op Ubuntu werkte stabiel; browser automation pas na veiligheid-pagina en expliciete submit-approvals. Geen “autonome AI” in productie.

TM
Thomas M.
Backend engineer, Rotterdam

Install FAQ

Gateway setup
en eerste debug.

Kort antwoord eerst — daarna oorzaak en vervolgstap. Incidenten: problems.

Ask your question →

Short answer: Node.js v20+ → npm install -g openclaw → configureer ~/.openclaw/openclaw.json + .env (gateway.mode=local, API keys) → start Gateway (systemd of Docker Compose) → openclaw gateway status must running are.

Nuance: de CLI installeert de Gateway-node; agents en tools hangen daar aan — geen los openclaw init-project voor productie-agents.

Follow-up: safety · Knowledge hub

Short answer: Nee — bare-metal met systemd op Linux/VPS is gangbaar. Docker is handig voor reproduceerbare deploy, healthz en volume-backups.

Cause of choice: hobby op laptop = CLI + lokale Gateway; productie = vaak Docker + reverse proxy op 127.0.0.1:18789.

Follow-up: OpenClaw Docker · vermijd twee Gateways (npm + container) op één host.

Short answer: systemd op een dedicated Linux VPS met één Gateway-service. Docker Compose als je stack al container-first is of je sidecars (Ollama, proxy) in één compose-project wilt.

Nuance: zelfde .env-discipline; split-brain tussen host-user en container-user is een veelvoorkomende fout.

Follow-up: logs via journalctl -u openclaw-gateway -f or logs & monitoring.

Short answer: Ja, mits Gateway niet open op 0.0.0.0 zonder auth, .env op chmod 600, en mutating tools via approvals.

Cause of risk: mail/browser/shell-tools — niet het LLM-antwoord alleen. Lokaal ≠ “geen governance”.

Follow-up: safety vóór productie-mailbox of Browser automation.

Short answer: Zonder human-in-the-loop op send/write/submit lijkt de Gateway “werkend” terwijl mutating acties ongecontroleerd blijven.

Nuance: readonly triage mag lichter; mail send, shell en browser submit niet.

Follow-up: approvals + workflows per stap.

Short answer: De OpenClaw Gateway (Node.js), channel-connectors, tool-runtime (shell, browser, mail), approval queue en state onder ~/.openclaw/ (of Docker volume).

Nuance: LLM-calls gaan naar upstream (Anthropic, OpenAI-compatible, Ollama) — keys in .env, niet in git.

Follow-up: health check curl http://127.0.0.1:18789/healthz · open claw doctor.

Short answer: openclaw gateway status → open claw doctor → openclaw logs --follow (systemd: journalctl -u openclaw-gateway -n 80; Docker: docker compose logs -f --tail=80).

Cause: ontbrekende gateway.auth, poort 18789 bezet, .env incompleet.

Follow-up: problems — geen volume-wipe vóór log-analyse.

Gateway ready,
maar stuck op auth of Docker?

Stuur open claw doctor, gateway status en 20–30 logregels. We helpen met productie-hardening — geen “autonome AI”-verkooppraat.

✓ Free conversation
✓ Response within 24 hours
✓ Gateway · Docker · approvals
✓ Dutch & European hosting