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.
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.
doctor groen krijgen — geen open poort naar internet.ready.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.
- macOS 12 Monterey or later
- Windows 10 / 11 (64-bit)
- Ubuntu 20.04 LTS or higher
- Debian, Fedora, Arch (community support)
- Node.js v18.x LTS (minimum)
- Node.js v20.x or v22.x (recommended)
- npm v9+ or Yarn v1.22+
- pnpm v8+ (optional, faster)
- Hobby: 1 GB RAM · productie agents: 2–4 GB+
- Schijf voor
~/.openclaw/state + logs - Internet voor npm + upstream LLM API
- Poort
18789vrij (of expliciete mapping)
- systemd — Linux VPS, één Gateway-service
- Docker Compose — healthz, volumes, proxy
- Reverse proxy (Nginx/Traefik) voor TLS + WebSocket
open claw doctorna elke config-wijziging
Gateway installatie
Install OpenClaw:
CLI → config → Gateway ready.
Zelfde volgorde als in de Knowledge hub: daarna safety and workflows.
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.
OpenClaw CLI installeren
Globale CLI voor Gateway-beheer: status, doctor, logs, channels. Dit is geen aparte “pipeline CLI” — alles hangt aan de Gateway-node.
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.
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.
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.
Governance & monitoring
Schakel approvals in voor mutating tools. Stel logging/audit in (logs & monitoring) vóór mail of Browser automation in productie.
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.
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.
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.
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.
Docker Compose met healthz bespaarde uren debug. Belangrijkste les: niet npm-global én container op dezelfde VPS — één Gateway, één poort 18789.
systemd op Ubuntu werkte stabiel; browser automation pas na veiligheid-pagina en expliciete submit-approvals. Geen “autonome AI” in productie.
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: 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.