Naar hoofdinhoud gaan

​
Installatie

Als je voor het eerst instelt, begin met Aan de slag. Voor wizarddetails, zie Onboarding Wizard.
Laatst bijgewerkt: 2026-01-01

​
TL;DR

  • Aanpassing leeft buiten de repo: ~/.openclaw/workspace (werkruimte) + ~/.openclaw/openclaw.json (config).
  • Stabiele workflow: installeer de macOS-app; laat deze de gebundelde Gateway draaien.
  • Bleeding edge-workflow: draai de Gateway zelf via pnpm gateway:watch, en laat vervolgens de macOS-app in Lokale modus koppelen.

​
Vereisten (van bron)

  • Node >=22
  • pnpm
  • Docker (optioneel; alleen voor containerized setup/e2e — zie Docker)

​
Strategie voor maatwerk (zodat updates geen pijn doen)

Als je “100% op mij afgestemd” en eenvoudige updates wilt, houd je aanpassingen in:
  • Config: ~/.openclaw/openclaw.json (JSON/JSON5-achtig)
  • Werkruimte: ~/.openclaw/workspace (Skills, prompts, herinneringen; maak er een private git-repo van)
Eenmalig bootstrappen: 
openclaw setup
Gebruik vanuit deze repo de lokale CLI-ingang: 
openclaw setup
Als je nog geen globale installatie hebt, voer het uit via pnpm openclaw setup.

​
Draai de Gateway vanuit deze repo

Na pnpm build kun je de verpakte CLI direct uitvoeren: 
node openclaw.mjs gateway --port 18789 --verbose

​
Stabiele workflow (macOS-app eerst)

  1. Installeer + start OpenClaw.app (menubalk).
  2. Rond de onboarding-/rechtenchecklist af (TCC-prompts).
  3. Zorg dat de Gateway Local is en draait (de app beheert dit).
  4. Koppel surfaces (voorbeeld: WhatsApp):
openclaw channels login
  1. Sanity controle:
openclaw health
Als onboarding niet beschikbaar is in jouw build:
  • Voer openclaw setup uit, daarna openclaw channels login, en start vervolgens de Gateway handmatig (openclaw gateway).

​
Bleeding edge-workflow (Gateway in een terminal)

Doel: werken aan de TypeScript-Gateway, hot reload krijgen en de macOS-app-UI gekoppeld houden.

​
0. (Optioneel) Draai ook de macOS-app vanuit bron

Als je ook de macOS-app op bleeding edge wilt: 
./scripts/restart-mac.sh

​
1. Start de dev Gateway

pnpm install
pnpm gateway:watch
gateway:watch draait de gateway in watch-modus en herlaadt bij TypeScript-wijzigingen.

​
2. Richt de macOS-app op je draaiende Gateway

In OpenClaw.app:
  • Verbindingsmodus: Local De app koppelt aan de draaiende gateway op de geconfigureerde poort.

​
3. Verifiëren

  • De Gateway-status in de app moet “Using existing gateway …” tonen
  • Of via CLI:
openclaw health

​
Gemeenschappelijke voetgeweers

  • Verkeerde poort: Gateway WS staat standaard op ws://127.0.0.1:18789; houd app + CLI op dezelfde poort.
  • Waar staat de status:
    • Referenties: ~/.openclaw/credentials/
    • Sessies: ~/.openclaw/agents/<agentId>/sessions/
    • Logs: /tmp/openclaw/

​
Opslagkaart voor referenties

Gebruik dit bij het debuggen van authenticatie of om te bepalen wat je moet back-uppen:
  • WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
  • Telegram bot-token: config/env of channels.telegram.tokenFile
  • Discord bot-token: config/env (tokenbestand nog niet ondersteund)
  • Slack-tokens: config/env (channels.slack.*)
  • Koppelings-toelatingslijsten: ~/.openclaw/credentials/<channel>-allowFrom.json
  • Model-authprofielen: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Legacy OAuth-import: ~/.openclaw/credentials/oauth.json Meer details: Beveiliging.

​
Updaten (zonder je setup te slopen)

  • Houd ~/.openclaw/workspace en ~/.openclaw/ als “jouw spullen”; zet geen persoonlijke prompts/config in de openclaw-repo.
  • Bron bijwerken: git pull + pnpm install (wanneer het lockfile is gewijzigd) + blijf pnpm gateway:watch gebruiken.

​
Linux (systemd-gebruikersservice)

Linux-installaties gebruiken een systemd user service. Standaard stopt systemd user- services bij uitloggen/inactiviteit, wat de Gateway stopt. Onboarding probeert lingering voor je in te schakelen (kan om sudo vragen). Als het nog steeds uit staat, voer uit: 
sudo loginctl enable-linger $USER
Voor always-on of multi-user servers kun je een system service overwegen in plaats van een user service (geen lingering nodig). Zie het Gateway-runbook voor de systemd-notities.

​
Gerelateerde documentatie