Veelgestelde vragen: installatie bij eerste gebruik

Gebruik een lokale AI-agent die je machine kan zien. Dat is veel effectiever dan vragen in Discord, omdat de meeste "ik zit vast"-gevallen lokale configuratie- of omgevingsproblemen zijn die externe helpers niet kunnen inspecteren.

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Deze tools kunnen de repo lezen, opdrachten uitvoeren, logs inspecteren en helpen je machineconfiguratie op te lossen (PATH, services, permissies, auth-bestanden). Geef ze de volledige source checkout via de hackbare (git) installatie:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Dit installeert OpenClaw vanuit een git checkout, zodat de agent de code + docs kan lezen en kan redeneren over de exacte versie die je uitvoert. Je kunt later altijd terugschakelen naar stable door de installer opnieuw uit te voeren zonder --install-method git.

Tip: vraag de agent om de fix te plannen en te begeleiden (stap voor stap), en voer daarna alleen de noodzakelijke opdrachten uit. Dat houdt wijzigingen klein en gemakkelijker te auditen.

Als je een echte bug of fix ontdekt, maak dan een GitHub-issue aan of stuur een PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls

Begin met deze opdrachten (deel uitvoer wanneer je om hulp vraagt):

openclaw statusopenclaw models statusopenclaw doctor

Wat ze doen:

• openclaw status: snelle snapshot van gateway-/agentstatus + basisconfiguratie.
• openclaw models status: controleert provider-auth + modelbeschikbaarheid.
• openclaw doctor: valideert en repareert veelvoorkomende config-/statusproblemen.

Andere nuttige CLI-controles: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose.

Snelle debugloop: Eerste 60 seconden als iets kapot is. Installatiedocs: Installeren, Installer-flags, Bijwerken.

Veelvoorkomende redenen waarom Heartbeat overslaat:

• quiet-hours: buiten het geconfigureerde venster voor actieve uren
• empty-heartbeat-file: HEARTBEAT.md bestaat, maar bevat alleen lege/header-only scaffolding
• no-tasks-due: HEARTBEAT.md-taakmodus is actief, maar geen van de taakintervallen is al aan de beurt
• alerts-disabled: alle Heartbeat-zichtbaarheid is uitgeschakeld (showOk, showAlerts en useIndicator staan allemaal uit)

In taakmodus worden due-timestamps alleen bijgewerkt nadat een echte Heartbeat-run is voltooid. Overgeslagen runs markeren taken niet als voltooid.

Docs: Heartbeat, Automatisering.

De repo raadt aan om vanuit source te draaien en onboarding te gebruiken:

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

De wizard kan ook automatisch UI-assets bouwen. Na onboarding draai je de Gateway doorgaans op poort 18789.

Vanuit source (contributors/dev):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

Als je nog geen globale installatie hebt, voer je deze uit via pnpm openclaw onboard.

De wizard opent je browser met een schone (niet-getokeniseerde) dashboard-URL direct na onboarding en print de link ook in de samenvatting. Houd dat tabblad open; als het niet is gestart, kopieer/plak dan de geprinte URL op dezelfde machine.

Localhost (dezelfde machine):

• Open http://127.0.0.1:18789/.
• Als om shared-secret-auth wordt gevraagd, plak dan het geconfigureerde token of wachtwoord in de Control UI-instellingen.
• Tokenbron: gateway.auth.token (of OPENCLAW_GATEWAY_TOKEN).
• Wachtwoordbron: gateway.auth.password (of OPENCLAW_GATEWAY_PASSWORD).
• Als er nog geen shared secret is geconfigureerd, genereer dan een token met openclaw doctor --generate-gateway-token.

Niet op localhost:

• Tailscale Serve (aanbevolen): houd bind op loopback, voer openclaw gateway --tailscale serve uit, open https://<magicdns>/. Als gateway.auth.allowTailscale true is, voldoen identity headers voor Control UI-/WebSocket-auth (geen geplakte shared secret, gaat uit van vertrouwde gatewayhost); HTTP-API's vereisen nog steeds shared-secret-auth, tenzij je bewust private-ingress none of trusted-proxy HTTP-auth gebruikt. Slechte gelijktijdige Serve-authpogingen vanaf dezelfde client worden geserialiseerd voordat de failed-auth-limiter ze registreert, dus de tweede slechte retry kan al retry later tonen.
• Tailnet bind: voer openclaw gateway --bind tailnet --token "<token>" uit (of configureer wachtwoord-auth), open http://<tailscale-ip>:18789/ en plak daarna de overeenkomende shared secret in de dashboardinstellingen.
• Identity-aware reverse proxy: houd de Gateway achter een vertrouwde proxy, configureer gateway.auth.mode: "trusted-proxy" en open daarna de proxy-URL. Same-host loopback-proxy's vereisen expliciet gateway.auth.trustedProxy.allowLoopback = true.
• SSH-tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host en open daarna http://127.0.0.1:18789/. Shared-secret-auth geldt nog steeds via de tunnel; plak het geconfigureerde token of wachtwoord als daarom wordt gevraagd.

Zie Dashboard en Web-oppervlakken voor bindmodi en auth-details.

Ze sturen verschillende lagen aan:

• approvals.exec: stuurt goedkeuringsprompts door naar chatbestemmingen
• channels.<channel>.execApprovals: laat dat kanaal optreden als native goedkeuringsclient voor exec-goedkeuringen

Het host-execbeleid blijft de echte goedkeuringspoort. Chatconfiguratie bepaalt alleen waar goedkeuringsprompts verschijnen en hoe mensen ze kunnen beantwoorden.

In de meeste setups heb je niet beide nodig:

• Als de chat al opdrachten en antwoorden ondersteunt, werkt /approve in dezelfde chat via het gedeelde pad.
• Als een ondersteund native kanaal veilig approvers kan afleiden, schakelt OpenClaw nu automatisch DM-first native goedkeuringen in wanneer channels.<channel>.execApprovals.enabled niet is ingesteld of "auto" is.
• Wanneer native goedkeuringskaarten/knoppen beschikbaar zijn, is die native UI het primaire pad; de agent moet alleen een handmatige /approve-opdracht opnemen als het toolresultaat zegt dat chatgoedkeuringen niet beschikbaar zijn of handmatige goedkeuring het enige pad is.
• Gebruik approvals.exec alleen wanneer prompts ook moeten worden doorgestuurd naar andere chats of expliciete ops-rooms.
• Gebruik channels.<channel>.execApprovals.target: "channel" of "both" alleen wanneer je expliciet wilt dat goedkeuringsprompts terug worden gepost in de oorspronkelijke room/topic.
• Plugin-goedkeuringen zijn opnieuw apart: ze gebruiken standaard /approve in dezelfde chat, optionele approvals.plugin-doorsturing, en alleen sommige native kanalen houden native Plugin-goedkeuringsafhandeling daarbovenop.

Korte versie: doorsturen is voor routering, native clientconfiguratie is voor rijkere kanaalspecifieke UX. Zie Exec-goedkeuringen.

Node >= 22 is vereist. pnpm wordt aanbevolen. Bun wordt niet aanbevolen voor de Gateway.

Ja. De Gateway is lichtgewicht - de docs vermelden 512MB-1GB RAM, 1 core en ongeveer 500MB schijf als genoeg voor persoonlijk gebruik, en merken op dat een Raspberry Pi 4 het kan draaien.

Als je extra ruimte wilt (logs, media, andere services), wordt 2GB aanbevolen, maar het is geen harde minimumvereiste.

Tip: een kleine Pi/VPS kan de Gateway hosten, en je kunt nodes op je laptop/telefoon koppelen voor lokaal scherm/camera/canvas of opdrachtuitvoering. Zie Nodes.

Korte versie: het werkt, maar verwacht ruwe randjes.

• Gebruik een 64-bit OS en houd Node >= 22.
• Geef de voorkeur aan de hackbare (git) installatie, zodat je logs kunt zien en snel kunt bijwerken.
• Start zonder kanalen/Skills en voeg ze daarna één voor één toe.
• Als je vreemde binaire problemen tegenkomt, is het meestal een ARM-compatibiliteitsprobleem.

Docs: Linux, Installeren.

Dat scherm is afhankelijk van of de Gateway bereikbaar en geauthenticeerd is. De TUI verstuurt ook automatisch "Wake up, my friend!" bij de eerste hatch. Als je die regel ziet met geen antwoord en tokens op 0 blijven, is de agent nooit uitgevoerd.

1. Herstart de Gateway:

openclaw gateway restart

2. Controleer status + auth:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Als het nog steeds hangt, voer uit:

openclaw doctor

Als de Gateway remote is, zorg er dan voor dat de tunnel-/Tailscale-verbinding actief is en dat de UI naar de juiste Gateway wijst. Zie Remote toegang.

Ja. Kopieer de statusdirectory en workspace, en voer daarna Doctor één keer uit. Dit houdt je bot "exact hetzelfde" (geheugen, sessiegeschiedenis, auth en kanaalstatus) zolang je beide locaties kopieert:

1. Installeer OpenClaw op de nieuwe machine.
2. Kopieer $OPENCLAW_STATE_DIR (standaard: ~/.openclaw) vanaf de oude machine.
3. Kopieer je workspace (standaard: ~/.openclaw/workspace).
4. Voer openclaw doctor uit en herstart de Gateway-service.

Dat bewaart configuratie, auth-profielen, WhatsApp-creds, sessies en geheugen. Als je in remote modus zit, onthoud dan dat de gatewayhost eigenaar is van de sessiestore en workspace.

Belangrijk: als je alleen je workspace commit/pusht naar GitHub, maak je een back-up van geheugen + bootstrapbestanden, maar niet van sessiegeschiedenis of auth. Die staan onder ~/.openclaw/ (bijvoorbeeld ~/.openclaw/agents/<agentId>/sessions/).

Gerelateerd: Migreren, Waar dingen op schijf staan, Agent-workspace, Doctor, Remote modus.

Bekijk de GitHub-changelog: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

De nieuwste vermeldingen staan bovenaan. Als de bovenste sectie is gemarkeerd als Unreleased, is de volgende gedateerde sectie de nieuwste uitgebrachte versie. Vermeldingen zijn gegroepeerd op Highlights, Changes en Fixes (plus docs/andere secties wanneer nodig).

Sommige Comcast-/Xfinity-verbindingen blokkeren docs.openclaw.ai ten onrechte via Xfinity Advanced Security. Schakel het uit of zet docs.openclaw.ai op de allowlist, en probeer het daarna opnieuw. Help ons dit te deblokkeren door het hier te melden: https://spa.xfinity.com/check_url_status.

Als je de site nog steeds niet kunt bereiken, zijn de docs gespiegeld op GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Stabiel en beta zijn npm dist-tags, geen afzonderlijke coderegels:

• latest = stabiel
• beta = vroege build om te testen

Meestal komt een stabiele release eerst op beta terecht, waarna een expliciete promotiestap diezelfde versie naar latest verplaatst. Maintainers kunnen indien nodig ook rechtstreeks naar latest publiceren. Daarom kunnen beta en stabiel na promotie naar dezelfde versie verwijzen.

Bekijk wat er is gewijzigd: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Voor installatieregels en het verschil tussen beta en dev, zie de accordeon hieronder.

Beta is de npm dist-tag beta (kan na promotie overeenkomen met latest). Dev is de bewegende kop van main (git); bij publicatie gebruikt die de npm dist-tag dev.

Eénregelige opdrachten (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Windows-installatieprogramma (PowerShell): https://openclaw.ai/install.ps1

Meer details: Ontwikkelkanalen en Installatieprogramma-vlaggen.

Twee opties:

1. Dev-kanaal (git checkout):

openclaw update --channel dev

Dit schakelt over naar de main-branch en werkt bij vanuit de broncode.

2. Aanpasbare installatie (vanaf de installatiesite):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Dat geeft je een lokale repo die je kunt bewerken en daarna via git kunt bijwerken.

Als je liever handmatig een schone kloon gebruikt, gebruik dan:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Documentatie: Bijwerken, Ontwikkelkanalen, Installeren.

Grove richtlijn:

• Installatie: 2-5 minuten
• Onboarding: 5-15 minuten, afhankelijk van hoeveel kanalen/modellen je configureert

Als het blijft hangen, gebruik dan Installatieprogramma vastgelopen en de snelle debuglus in Ik zit vast.

Voer het installatieprogramma opnieuw uit met uitgebreide uitvoer:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

Beta-installatie met uitgebreide uitvoer:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

Voor een aanpasbare (git-)installatie:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

Windows-equivalent (PowerShell):

# install.ps1 has no dedicated -Verbose flag yet.Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0

Meer opties: Installatieprogramma-vlaggen.

Twee veelvoorkomende Windows-problemen:

1) npm-fout spawn git / git niet gevonden

• Installeer Git for Windows en zorg dat git op je PATH staat.
• Sluit PowerShell en open het opnieuw, en voer daarna het installatieprogramma opnieuw uit.

2) openclaw wordt na installatie niet herkend

• Je globale npm-binmap staat niet op PATH.

• Controleer het pad:

  npm config get prefix

• Voeg die map toe aan je gebruikers-PATH (geen \bin-suffix nodig op Windows; op de meeste systemen is dit %AppData%\npm).

• Sluit PowerShell en open het opnieuw nadat je PATH hebt bijgewerkt.

Als je de soepelste Windows-installatie wilt, gebruik dan WSL2 in plaats van native Windows. Documentatie: Windows.

Dit is meestal een mismatch in de console-codepagina op native Windows-shells.

Symptomen:

• system.run/exec-uitvoer geeft Chinees weer als mojibake
• Dezelfde opdracht ziet er goed uit in een ander terminalprofiel

Snelle workaround in PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Herstart daarna de Gateway en probeer je opdracht opnieuw:

openclaw gateway restart

Als je dit nog steeds reproduceert op de nieuwste OpenClaw, volg/meld het in:

• Issue #30640

Gebruik de aanpasbare (git-)installatie zodat je de volledige broncode en documentatie lokaal hebt, en vraag het daarna je bot (of Claude/Codex) vanuit die map zodat die de repo kan lezen en precies kan antwoorden.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Meer details: Installeren en Installatieprogramma-vlaggen.

Kort antwoord: volg de Linux-gids en voer daarna onboarding uit.

• Snel Linux-pad + service-installatie: Linux.
• Volledige walkthrough: Aan de slag.
• Installatieprogramma + updates: Installeren en bijwerken.

Elke Linux-VPS werkt. Installeer op de server en gebruik daarna SSH/Tailscale om de Gateway te bereiken.

Gidsen: exe.dev, Hetzner, Fly.io. Externe toegang: Gateway op afstand.

We onderhouden een hostinghub met de gangbare providers. Kies er een en volg de gids:

• VPS-hosting (alle providers op één plek)
• Fly.io
• Hetzner
• exe.dev

Zo werkt het in de cloud: de Gateway draait op de server, en je krijgt toegang vanaf je laptop/telefoon via de Control UI (of Tailscale/SSH). Je status + werkruimte leven op de server, dus behandel de host als de bron van waarheid en maak er back-ups van.

Je kunt nodes (Mac/iOS/Android/headless) koppelen aan die cloud-Gateway om toegang te krijgen tot lokaal scherm/camera/canvas of opdrachten op je laptop uit te voeren terwijl de Gateway in de cloud blijft.

Hub: Platformen. Externe toegang: Gateway op afstand. Nodes: Nodes, Nodes CLI.

Kort antwoord: mogelijk, niet aanbevolen. De updateflow kan de Gateway herstarten (waardoor de actieve sessie wegvalt), kan een schone git-checkout nodig hebben en kan om bevestiging vragen. Veiliger: voer updates vanuit een shell uit als operator.

Gebruik de CLI:

openclaw updateopenclaw update statusopenclaw update --channel stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Als je vanuit een agent moet automatiseren:

openclaw update --yes --no-restartopenclaw gateway restart

Documentatie: Bijwerken, Bijwerken.

openclaw onboard is het aanbevolen installatiepad. In lokale modus leidt het je door:

• Model-/auth-installatie (provider-OAuth, API-sleutels, Anthropic setup-token, plus lokale modelopties zoals LM Studio)
• Werkruimte-locatie + bootstrapbestanden
• Gateway-instellingen (bind/port/auth/tailscale)
• Kanalen (WhatsApp, Telegram, Discord, Mattermost, Signal, iMessage, plus gebundelde kanaalplugins zoals QQ Bot)
• Daemon-installatie (LaunchAgent op macOS; systemd-gebruikerseenheid op Linux/WSL2)
• Health checks en selectie van Skills

Het waarschuwt ook als je geconfigureerde model onbekend is of auth mist.

Nee. Je kunt OpenClaw draaien met API-sleutels (Anthropic/OpenAI/anderen) of met alleen-lokale modellen zodat je gegevens op je apparaat blijven. Abonnementen (Claude Pro/Max of OpenAI Codex) zijn optionele manieren om die providers te authenticeren.

Voor Anthropic in OpenClaw is de praktische verdeling:

• Anthropic API-sleutel: normale Anthropic API-facturering
• Claude CLI / Claude-abonnementsauth in OpenClaw: Anthropic-medewerkers vertelden ons dat dit gebruik weer is toegestaan, en OpenClaw behandelt claude -p-gebruik als goedgekeurd voor deze integratie tenzij Anthropic een nieuw beleid publiceert

Voor langdurig draaiende gatewayhosts blijven Anthropic API-sleutels de meer voorspelbare installatie. OpenAI Codex OAuth wordt expliciet ondersteund voor externe tools zoals OpenClaw.

OpenClaw ondersteunt ook andere gehoste abonnementsachtige opties, waaronder Qwen Cloud Coding Plan, MiniMax Coding Plan en Z.AI / GLM Coding Plan.

Documentatie: Anthropic, OpenAI, Qwen Cloud, MiniMax, GLM Models, Lokale modellen, Modellen.

Ja.

Anthropic-medewerkers vertelden ons dat OpenClaw-achtig Claude CLI-gebruik weer is toegestaan, dus OpenClaw behandelt Claude-abonnementsauth en claude -p-gebruik als goedgekeurd voor deze integratie tenzij Anthropic een nieuw beleid publiceert. Als je de meest voorspelbare server-side installatie wilt, gebruik dan in plaats daarvan een Anthropic API-sleutel.

Ja.

Anthropic-medewerkers vertelden ons dat dit gebruik weer is toegestaan, dus OpenClaw behandelt hergebruik van Claude CLI en claude -p-gebruik als goedgekeurd voor deze integratie tenzij Anthropic een nieuw beleid publiceert.

Anthropic setup-token is nog steeds beschikbaar als ondersteund OpenClaw-tokenpad, maar OpenClaw geeft nu de voorkeur aan hergebruik van Claude CLI en claude -p wanneer beschikbaar. Voor productie- of multi-user workloads blijft Anthropic API-sleutelauth de veiligere, voorspelbaardere keuze. Als je andere gehoste abonnementsachtige opties in OpenClaw wilt, zie OpenAI, Qwen / Model Cloud, MiniMax en GLM Models.

Dat betekent dat je Anthropic-quota/rate limit voor het huidige venster is opgebruikt. Als je Claude CLI gebruikt, wacht dan tot het venster reset of upgrade je abonnement. Als je een Anthropic API-sleutel gebruikt, controleer dan de Anthropic Console voor gebruik/facturering en verhoog limieten waar nodig.

Als het bericht specifiek is: Extra usage is required for long context requests, dan probeert de aanvraag Anthropic's 1M-contextbeta (context1m: true) te gebruiken. Dat werkt alleen wanneer je credential in aanmerking komt voor long-context-facturering (API-sleutelfacturering of het OpenClaw Claude-loginpad met Extra Usage ingeschakeld).

Tip: stel een fallbackmodel in zodat OpenClaw kan blijven antwoorden terwijl een provider door rate-limits wordt beperkt. Zie Modellen, OAuth, en /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Ja. OpenClaw heeft een meegeleverde Amazon Bedrock (Converse)-provider. Wanneer AWS-env-markeringen aanwezig zijn, kan OpenClaw de streaming-/tekst-Bedrock-catalogus automatisch ontdekken en samenvoegen als een impliciete amazon-bedrock-provider; anders kun je plugins.entries.amazon-bedrock.config.discovery.enabled expliciet inschakelen of een handmatige providervermelding toevoegen. Zie Amazon Bedrock en Modelproviders. Als je liever een beheerde sleutelstroom gebruikt, blijft een OpenAI-compatibele proxy voor Bedrock een geldige optie.

OpenClaw ondersteunt OpenAI Code (Codex) via OAuth (ChatGPT-aanmelding). Gebruik openai/gpt-5.5 voor de gebruikelijke setup: ChatGPT/Codex-abonnementsauthenticatie plus native Codex-appserveruitvoering. openai-codex/gpt-*-modelrefs zijn verouderde configuratie die wordt gerepareerd door openclaw doctor --fix. Directe OpenAI API-sleuteltoegang blijft beschikbaar voor niet-agent-OpenAI API-oppervlakken en voor agentmodellen via een geordend openai-codex API-sleutelprofiel. Zie Modelproviders en Onboarding (CLI).

openai-codex is de provider- en auth-profiel-id voor ChatGPT/Codex OAuth. Oudere configuraties gebruikten het ook als modelprefix:

• openai/gpt-5.5 = ChatGPT/Codex-abonnementsauthenticatie met native Codex-runtime voor agentbeurten
• openai-codex/gpt-5.5 = verouderde modelroute die wordt gerepareerd door openclaw doctor --fix
• openai/gpt-5.5 plus een geordend openai-codex API-sleutelprofiel = API-sleutelauthenticatie voor een OpenAI-agentmodel
• openai-codex:... = auth-profiel-id, geen modelref

Als je het directe pad voor OpenAI Platform-facturering/-limieten wilt, stel dan OPENAI_API_KEY in. Als je ChatGPT/Codex-abonnementsauthenticatie wilt, meld je dan aan met openclaw models auth login --provider openai-codex. Houd de modelref op openai/gpt-5.5; openai-codex/*-modelrefs zijn verouderde configuratie die openclaw doctor --fix herschrijft.

Codex OAuth gebruikt door OpenAI beheerde, planafhankelijke quotavensters. In de praktijk kunnen die limieten verschillen van de ervaring op de ChatGPT-website/-app, zelfs wanneer beide aan hetzelfde account zijn gekoppeld.

OpenClaw kan de momenteel zichtbare providergebruiks-/quotavensters tonen in openclaw models status, maar het verzint of normaliseert ChatGPT-webrechten niet naar directe API-toegang. Als je het directe pad voor OpenAI Platform-facturering/-limieten wilt, gebruik dan openai/* met een API-sleutel.

Ja. OpenClaw ondersteunt OpenAI Code (Codex)-abonnements-OAuth volledig. OpenAI staat abonnements-OAuth-gebruik expliciet toe in externe tools/workflows zoals OpenClaw. Onboarding kan de OAuth-flow voor je uitvoeren.

Zie OAuth, Modelproviders, en Onboarding (CLI).

Gemini CLI gebruikt een Plugin-authenticatiestroom, geen client-id of geheim in openclaw.json.

Stappen:

1. Installeer Gemini CLI lokaal zodat gemini op PATH staat
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Schakel de Plugin in: openclaw plugins enable google
3. Log in: openclaw models auth login --provider google-gemini-cli --set-default
4. Standaardmodel na login: google-gemini-cli/gemini-3-flash-preview
5. Als aanvragen mislukken, stel GOOGLE_CLOUD_PROJECT of GOOGLE_CLOUD_PROJECT_ID in op de gatewayhost

Dit slaat OAuth-tokens op in auth-profielen op de gatewayhost. Details: Modelproviders.

Meestal niet. OpenClaw heeft een grote context en sterke veiligheid nodig; kleine kaarten kappen af en lekken. Als het moet, draai dan lokaal de grootste modelbuild die je kunt (LM Studio) en zie /gateway/local-models. Kleinere/gekwantiseerde modellen verhogen het risico op promptinjectie - zie Beveiliging.

Kies regiogebonden endpoints. OpenRouter biedt in de VS gehoste opties voor MiniMax, Kimi en GLM; kies de in de VS gehoste variant om data in de regio te houden. Je kunt Anthropic/OpenAI nog steeds naast deze vermelden door models.mode: "merge" te gebruiken, zodat fallbacks beschikbaar blijven terwijl de geregionaliseerde provider die je selecteert wordt gerespecteerd.

Nee. OpenClaw draait op macOS of Linux (Windows via WSL2). Een Mac mini is optioneel - sommige mensen kopen er een als always-on host, maar een kleine VPS, homeserver of Raspberry Pi-klasse machine werkt ook.

Je hebt alleen een Mac nodig voor tools die alleen op macOS werken. Gebruik voor iMessage iMessage met imsg op een Mac die bij Berichten is aangemeld. Als de Gateway op Linux of elders draait, stel channels.imessage.cliPath in op een SSH-wrapper die imsg op die Mac uitvoert. Als je andere tools wilt die alleen op macOS werken, draai de Gateway dan op een Mac of koppel een macOS-node.

Docs: iMessage, Nodes, Mac-modus op afstand.

Je hebt een macOS-apparaat nodig dat bij Berichten is aangemeld. Dat hoeft geen Mac mini te zijn - elke Mac werkt. Gebruik iMessage met imsg; de Gateway kan op die Mac draaien, of elders met een SSH-wrapper cliPath.

Veelvoorkomende setups:

• Draai de Gateway op Linux/VPS en stel channels.imessage.cliPath in op een SSH-wrapper die imsg uitvoert op een Mac die bij Berichten is aangemeld.
• Draai alles op de Mac als je de eenvoudigste setup met één machine wilt.

Docs: iMessage, Nodes, Mac-modus op afstand.

Ja. De Mac mini kan de Gateway draaien, en je MacBook Pro kan verbinding maken als node (begeleidend apparaat). Nodes draaien de Gateway niet - ze bieden extra mogelijkheden zoals scherm/camera/canvas en system.run op dat apparaat.

Veelvoorkomend patroon:

• Gateway op de Mac mini (always-on).
• MacBook Pro draait de macOS-app of een nodehost en koppelt met de Gateway.
• Gebruik openclaw nodes status / openclaw nodes list om die te zien.

Docs: Nodes, Nodes CLI.

Bun wordt niet aanbevolen. We zien runtimebugs, vooral met WhatsApp en Telegram. Gebruik Node voor stabiele gateways.

Als je toch met Bun wilt experimenteren, doe dat dan op een niet-productiegateway zonder WhatsApp/Telegram.

channels.telegram.allowFrom is de Telegram-gebruikers-ID van de menselijke afzender (numeriek). Het is niet de botgebruikersnaam.

Setup vraagt alleen om numerieke gebruikers-ID's. Als je al verouderde @username-vermeldingen in de configuratie hebt, kan openclaw doctor --fix proberen ze op te lossen.

Veiliger (geen bot van derden):

• Stuur je bot een DM, voer daarna openclaw logs --follow uit en lees from.id.

Officiële Bot API:

• Stuur je bot een DM, roep daarna https://api.telegram.org/bot<bot_token>/getUpdates aan en lees message.from.id.

Derde partij (minder privé):

• Stuur een DM naar @userinfobot of @getidsbot.

Zie /channels/telegram.

Ja, via routering met meerdere agents. Bind de WhatsApp-DM van elke afzender (peer kind: "direct", afzender E.164 zoals +15551234567) aan een andere agentId, zodat iedereen een eigen workspace en sessieopslag krijgt. Antwoorden komen nog steeds van hetzelfde WhatsApp-account, en DM-toegangscontrole (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) is globaal per WhatsApp-account. Zie Routering met meerdere agents en WhatsApp.

Ja. Gebruik routering met meerdere agents: geef elke agent een eigen standaardmodel en bind vervolgens inkomende routes (provideraccount of specifieke peers) aan elke agent. Een voorbeeldconfiguratie staat in Routering met meerdere agents. Zie ook Modellen en Configuratie.

Ja. Homebrew ondersteunt Linux (Linuxbrew). Snelle setup:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

Als je OpenClaw via systemd draait, zorg er dan voor dat de service-PATH /home/linuxbrew/.linuxbrew/bin bevat (of je brew-prefix), zodat met brew geïnstalleerde tools worden gevonden in niet-login shells. Recente builds voegen ook veelvoorkomende gebruikers-binmappen vooraan toe aan Linux-systemd-services (bijvoorbeeld ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) en respecteren PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR en FNM_DIR wanneer ze zijn ingesteld.

• Hackbare (git)-installatie: volledige source-checkout, bewerkbaar, het beste voor contributors. Je draait builds lokaal en kunt code/docs patchen.
• npm-installatie: globale CLI-installatie, geen repo, het beste voor "gewoon draaien." Updates komen uit npm-dist-tags.

Docs: Aan de slag, Bijwerken.

Ja. Gebruik openclaw update --channel ... wanneer OpenClaw al is geïnstalleerd. Dit verwijdert je data niet - het verandert alleen de OpenClaw-code-installatie. Je status (~/.openclaw) en workspace (~/.openclaw/workspace) blijven onaangeroerd.

Van npm naar git:

openclaw update --channel dev

Van git naar npm:

openclaw update --channel stable

Voeg --dry-run toe om eerst de geplande moduswissel te bekijken. De updater voert Doctor-opvolgstappen uit, vernieuwt Plugin-bronnen voor het doelkanaal en herstart de gateway tenzij je --no-restart meegeeft.

De installer kan beide modi ook afdwingen:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Back-uptips: zie Back-upstrategie.

Kort antwoord: als je 24/7 betrouwbaarheid wilt, gebruik dan een VPS. Als je de minste frictie wilt en slaapstand/herstarts geen probleem vindt, draai hem dan lokaal.

Laptop (lokale Gateway)

• Voordelen: geen serverkosten, directe toegang tot lokale bestanden, live browservenster.
• Nadelen: slaapstand/netwerkuitval = verbroken verbindingen, OS-updates/herstarts onderbreken, moet wakker blijven.

VPS / cloud

• Voordelen: altijd actief, stabiel netwerk, geen problemen met laptop-slaapstand, makkelijker actief te houden.
• Nadelen: draait vaak zonder grafische interface (gebruik screenshots), alleen externe bestandstoegang, je moet SSH gebruiken voor updates.

OpenClaw-specifieke opmerking: WhatsApp/Telegram/Slack/Mattermost/Discord werken allemaal prima vanaf een VPS. De enige echte afweging is browser zonder zichtbare interface versus een zichtbaar venster. Zie Browser.

Aanbevolen standaard: VPS als je eerder Gateway-verbindingen bent kwijtgeraakt. Lokaal is uitstekend wanneer je de Mac actief gebruikt en lokale bestandstoegang of UI-automatisering met een zichtbare browser wilt.

Niet vereist, maar aanbevolen voor betrouwbaarheid en isolatie.

• Dedicated host (VPS/Mac mini/Pi): altijd actief, minder onderbrekingen door slaapstand/herstarts, schonere machtigingen, makkelijker actief te houden.
• Gedeelde laptop/desktop: helemaal prima voor testen en actief gebruik, maar verwacht pauzes wanneer de machine in slaapstand gaat of updates uitvoert.

Als je het beste van beide werelden wilt, houd de Gateway dan op een dedicated host en koppel je laptop als een Node voor lokale tools voor scherm/camera/uitvoering. Zie Nodes. Lees Beveiliging voor beveiligingsrichtlijnen.

OpenClaw is lichtgewicht. Voor een basis-Gateway + één chatkanaal:

• Absoluut minimum: 1 vCPU, 1GB RAM, ~500MB schijf.
• Aanbevolen: 1-2 vCPU, 2GB RAM of meer voor extra ruimte (logs, media, meerdere kanalen). Node-tools en browserautomatisering kunnen veel resources vragen.

Besturingssysteem: gebruik Ubuntu LTS (of een moderne Debian/Ubuntu). Het Linux-installatiepad is daar het best getest.

Documentatie: Linux, VPS-hosting.

Ja. Behandel een VM hetzelfde als een VPS: deze moet altijd actief en bereikbaar zijn, en genoeg RAM hebben voor de Gateway en alle kanalen die je inschakelt.

Basisrichtlijnen:

• Absoluut minimum: 1 vCPU, 1GB RAM.
• Aanbevolen: 2GB RAM of meer als je meerdere kanalen, browserautomatisering of mediatools draait.
• Besturingssysteem: Ubuntu LTS of een andere moderne Debian/Ubuntu.

Als je Windows gebruikt, is WSL2 de eenvoudigste VM-achtige setup en heeft het de beste toolingcompatibiliteit. Zie Windows, VPS-hosting. Als je macOS in een VM draait, zie macOS-VM.