Skip to main content
Vragen en antwoorden over de snelle start en de eerste uitvoering. Zie voor dagelijks gebruik, modellen, authenticatie, sessies en probleemoplossing de hoofd-FAQ.

​
Snelle start en configuratie voor de eerste uitvoering

Gebruik een lokale AI-agent die je machine kan zien. De meeste gevallen waarin iemand vastzit, worden veroorzaakt door lokale configuratie- of omgevingsproblemen die een externe helper niet kan inspecteren. Dit werkt daarom beter dan om hulp vragen in Discord.Geef de agent via de aanpasbare (git-)installatie toegang tot de volledige broncodecheckout, zodat deze de code en documentatie kan lezen en kan redeneren over de exacte versie die je gebruikt:
Vraag de agent de oplossing stap voor stap te plannen en begeleiden en daarna alleen de noodzakelijke opdrachten uit te voeren. Kleinere wijzigingen zijn gemakkelijker te controleren.Deel deze uitvoer wanneer je om hulp vraagt (in Discord of een GitHub-issue):Een echte bug of oplossing gevonden? Dien een issue in of stuur een PR: Issues / Pull requests.Snelle foutopsporingscyclus: De eerste 60 seconden als er iets defect is. Installatiedocumentatie: Installatie, Installatieprogramma-opties, Bijwerken.
Oudere Heartbeat-blokken tasks: worden met openclaw doctor --fix gemigreerd naar onafhankelijk geplande Cron-taken.Documentatie: Heartbeat, Automatisering.
Vanuit de broncode (bijdragers/ontwikkelaars):
Nog geen globale installatie? Voer in plaats daarvan pnpm openclaw onboard uit. Als onderdelen van de Control UI ontbreken, probeert de onboarding ze zelf te bouwen, met pnpm ui:build als terugvaloptie.
Direct na de configuratie opent de onboarding je browser met een schone dashboard-URL (zonder token) en wordt de link in het overzicht weergegeven. Houd dat tabblad open. Als het niet is geopend, kopieer en plak je de weergegeven URL op dezelfde machine.
Localhost (dezelfde machine):
  • Open http://127.0.0.1:18789/.
  • Als om authenticatie met een gedeeld geheim wordt gevraagd, plak je het geconfigureerde token of wachtwoord in de instellingen van de Control UI.
  • Bron van het token: gateway.auth.token (of OPENCLAW_GATEWAY_TOKEN).
  • Bron van het wachtwoord: gateway.auth.password (of OPENCLAW_GATEWAY_PASSWORD).
  • Nog geen gedeeld geheim geconfigureerd? Voer openclaw doctor --generate-gateway-token (of openclaw doctor --fix --generate-gateway-token) uit.
Niet op localhost:
  • Tailscale Serve (aanbevolen): houd de binding op loopback, voer openclaw gateway --tailscale serve uit en open https://<magicdns>/. Met gateway.auth.allowTailscale: true voldoen identiteitsheaders aan de authenticatievereisten van de Control UI/WebSocket (er hoeft geen gedeeld geheim te worden geplakt; hierbij wordt uitgegaan van een vertrouwde Gateway-host). HTTP-API’s vereisen nog steeds authenticatie met een gedeeld geheim, tenzij je bewust private ingress via none of HTTP-authenticatie via een vertrouwde proxy gebruikt. Gelijktijdige Serve-pogingen met onjuiste authenticatie vanaf dezelfde client worden serieel verwerkt voordat de mislukte-authenticatiebegrenzer ze registreert. Daardoor kan een tweede onjuiste poging al retry later tonen.
  • Tailnet-binding: voer openclaw gateway --bind tailnet --token "<token>" uit (of configureer wachtwoordauthenticatie), open http://<tailscale-ip>:18789/ en plak het bijbehorende gedeelde geheim in de dashboardinstellingen.
  • Identiteitsbewuste reverse proxy: houd de Gateway achter een vertrouwde proxy, stel gateway.auth.mode: "trusted-proxy" in en open de proxy-URL. Loopbackproxy’s op dezelfde host vereisen expliciet gateway.auth.trustedProxy.allowLoopback: true.
  • SSH-tunnel: ssh -N -L 18789:127.0.0.1:18789 user@gateway-host, open vervolgens http://127.0.0.1:18789/. Authenticatie met een gedeeld geheim blijft ook via de tunnel van toepassing. Plak het geconfigureerde token of wachtwoord als daarom wordt gevraagd.
Zie Dashboard en Weboppervlakken voor bindingsmodi en authenticatiedetails.
Ze regelen verschillende lagen:
  • approvals.exec - stuurt goedkeuringsverzoeken door naar chatbestemmingen.
  • channels.<channel>.execApprovals - maakt van dat kanaal een systeemeigen goedkeuringsclient voor uitvoeringsgoedkeuringen.
Het uitvoeringsbeleid van de host blijft de daadwerkelijke goedkeuringspoort. De chatconfiguratie bepaalt alleen waar verzoeken verschijnen en hoe mensen erop reageren.Je hebt ze zelden allebei nodig:
  • Als de chat al opdrachten en antwoorden ondersteunt, werkt /approve in dezelfde chat via het gedeelde pad.
  • Wanneer een ondersteund systeemeigen kanaal goedkeurders veilig kan afleiden, schakelt OpenClaw automatisch systeemeigen goedkeuringen met privéberichten als eerste optie in als channels.<channel>.execApprovals.enabled niet is ingesteld of "auto" is.
  • Wanneer systeemeigen goedkeuringskaarten/-knoppen beschikbaar zijn, is die interface leidend. Vermeld een handmatige opdracht /approve alleen als het gereedschapsresultaat aangeeft dat chatgoedkeuringen niet beschikbaar zijn.
  • Gebruik approvals.exec alleen als verzoeken ook andere chats of expliciete operationele ruimtes moeten bereiken.
  • Gebruik channels.<channel>.execApprovals.target: "channel" of "both" alleen als je goedkeuringsverzoeken terug wilt plaatsen in de oorspronkelijke ruimte of het oorspronkelijke onderwerp.
  • Plugin-goedkeuringen staan hiervan los: standaard /approve in dezelfde chat, optioneel doorsturen via approvals.plugin, en slechts enkele systeemeigen kanalen behouden ook daarvoor de systeemeigen verwerking.
Kort gezegd: doorsturen dient voor routering; de configuratie van de systeemeigen client biedt een rijkere, kanaalspecifieke gebruikerservaring. Zie Uitvoeringsgoedkeuringen.
Node 22.22.3+, 24.15+ of 25.9+ is vereist (Node 24 wordt aanbevolen). pnpm is de pakketbeheerder van de repository. Bun kan afhankelijkheden installeren en pakketscripts uitvoeren, maar kan de OpenClaw CLI of Gateway niet uitvoeren omdat node:sqlite ontbreekt.
Ja, maar controleer eerst het RAM-geheugen: Pi 5 en Pi 4 (2 GB+) zijn ideaal; Pi 3B+ (1 GB) werkt maar is traag; Pi Zero 2 W (512 MB) wordt niet aanbevolen.Absoluut minimum: 1 GB RAM, 1 kern, 500 MB vrije schijfruimte en een 64-bits besturingssysteem. Omdat de Pi alleen de Gateway uitvoert (modellen roepen cloud-API’s aan), kan zelfs een bescheiden Pi de belasting aan.Een kleine Pi/VPS kan ook alleen de Gateway hosten, terwijl je nodes op je laptop/telefoon koppelt voor lokaal scherm-, camera- of canvasgebruik of voor het uitvoeren van opdrachten. Zie Nodes.Volledige configuratiehandleiding: Raspberry Pi.
  • Gebruik een 64-bits besturingssysteem; gebruik geen 32-bits Raspberry Pi OS.
  • Voeg swap toe op systemen met 2 GB of minder.
  • Geef voor prestaties en levensduur de voorkeur aan een USB-SSD boven een SD-kaart.
  • Geef de voorkeur aan de aanpasbare (git-)installatie, zodat je logboeken kunt bekijken en snel kunt bijwerken.
  • Begin zonder kanalen/Skills en voeg ze één voor één toe.
  • Vreemde fouten met binaire bestanden (“exec format error”) worden meestal veroorzaakt doordat een ARM64-build voor een optioneel Skill-gereedschap ontbreekt.
Volledige handleiding: Raspberry Pi. Zie ook Linux.
Dat scherm vereist dat de Gateway bereikbaar en geauthenticeerd is. De TUI verzendt bij de eerste keer uitkomen ook automatisch “Wake up, my friend!” wanneer een modelprovider is geconfigureerd. Als je de configuratie van het model/de authenticatie hebt overgeslagen, toont de onboarding de melding “Model auth missing” en wordt de TUI geopend zonder iets te verzenden. Voeg een provider toe met openclaw configure --section model. Als je de wekregel ziet maar geen antwoord krijgt en het aantal tokens op 0 blijft, is de agent nooit uitgevoerd.
  1. Start de Gateway opnieuw:
  1. Controleer de status en authenticatie:
  1. Blijft het hangen? Voer dit uit:
Als de Gateway extern is, controleer je of de tunnel-/Tailscale-verbinding actief is en de UI naar de juiste Gateway verwijst. Zie Externe toegang.
Ja. Kopieer de statusmap en werkruimte en voer Doctor vervolgens eenmaal uit:
  1. Installeer OpenClaw op de nieuwe machine.
  2. Kopieer $OPENCLAW_STATE_DIR (standaard: ~/.openclaw) van de oude machine.
  3. Kopieer je werkruimte (standaard: ~/.openclaw/workspace).
  4. Voer openclaw doctor uit en start de Gateway-service opnieuw.
Hiermee blijven de configuratie, authenticatieprofielen, WhatsApp-referenties, sessies en het geheugen behouden. Je bot blijft exact hetzelfde, zolang je beide locaties kopieert. In de externe modus beheert de Gateway-host de sessieopslag en werkruimte.Belangrijk: als je alleen je werkruimte naar GitHub commit en pusht, maak je een back-up van geheugen en bootstrapbestanden, maar niet van de sessiegeschiedenis of authenticatie. Die bevinden zich onder ~/.openclaw/ (bijvoorbeeld ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite).Gerelateerd: Migreren, Waar gegevens op schijf worden opgeslagen, Agentwerkruimte, Doctor, Externe modus.
Bekijk het wijzigingslogboek op GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.mdDe nieuwste vermeldingen staan bovenaan. Als de bovenste sectie Niet uitgebracht is, is de volgende sectie met een datum de nieuwste uitgebrachte versie. Vermeldingen zijn gegroepeerd onder Hoogtepunten, Wijzigingen en Oplossingen (plus documentatie-/andere secties wanneer nodig).
Sommige verbindingen van Comcast/Xfinity blokkeren docs.openclaw.ai ten onrechte via Xfinity Advanced Security. Schakel dit uit of voeg docs.openclaw.ai toe aan de toelatingslijst en probeer het opnieuw. Help ons de blokkering op te heffen: https://spa.xfinity.com/check_url_status.Nog steeds geblokkeerd? De documentatie wordt gespiegeld op GitHub: https://github.com/openclaw/openclaw/tree/main/docs
Stable en beta zijn npm dist-tags, geen afzonderlijke codetakken:
  • latest = stable
  • beta = vroege build om te testen (valt terug op latest wanneer beta ontbreekt of ouder is dan de huidige stabiele release)
Een stabiele release komt meestal eerst op beta terecht, waarna een expliciete promotiestap diezelfde versie naar latest verplaatst zonder het versienummer te wijzigen. Onderhouders kunnen ook rechtstreeks naar latest publiceren. Daarom kunnen beta en stable na promotie naar dezelfde versie verwijzen.Bekijk wat er is gewijzigd: CHANGELOG.md.Zie het volgende uitklapgedeelte voor installatieregels van één regel en het verschil tussen beta en dev.
Beta is de npm-dist-tag beta (kan na promotie overeenkomen met latest). Dev is de bewegende kop van main (git); bij publicatie naar npm gebruikt deze dist-tag dev.Opdrachten van één regel (macOS/Linux):
Windows-installatieprogramma (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iexMeer informatie: Ontwikkelingskanalen en Opties voor het installatieprogramma.
Twee opties:
  1. Dev-kanaal (bestaande installatie):
Hiermee schakel je over naar een git-checkout van main, voer je een rebase uit op upstream, bouw je de code en installeer je de CLI vanuit die checkout.
  1. Aanpasbare (git-)installatie (nieuwe machine):
Gebruik bij voorkeur een handmatige kloon:
Documentatie: Bijwerken, Ontwikkelingskanalen, Installeren.
Globale indicatie:
  • Installatie: 2-5 minuten.
  • QuickStart-onboarding: enkele minuten (loopback-Gateway, automatisch token, standaardwerkruimte).
  • Geavanceerde/volledige onboarding: langer wanneer aanmelden bij de provider, kanaalkoppeling, installatie van de daemon, netwerkdownloads of Skills extra configuratie vereisen.
De wizard toont deze tijdlijn vooraf. Sla optionele stappen over en keer later terug met openclaw configure.Blijft het proces hangen? Zie hierboven Ik zit vast.
Voer het opnieuw uit met --verbose:
install.ps1 heeft geen afzonderlijke uitgebreide-uitvoeroptie; verpak het in plaats daarvan in Set-PSDebug -Trace 1 / -Trace 0. Volledig overzicht van opties: Opties voor het installatieprogramma.
Twee veelvoorkomende Windows-problemen:1) npm-fout spawn git / git niet gevonden
  • Installeer Git for Windows en zorg dat git in PATH staat.
  • Sluit PowerShell, open het opnieuw en voer het installatieprogramma nogmaals uit.
2) openclaw wordt na installatie niet herkend
  • De globale npm-binmap staat niet in PATH.
  • Controleer dit: npm config get prefix.
  • Voeg die map toe aan je gebruikers-PATH (het achtervoegsel \bin is niet nodig; op de meeste systemen is dit %AppData%\npm).
  • Sluit PowerShell en open het opnieuw.
Liever een desktopapp? Gebruik Windows Hub. Voor een installatie uitsluitend via de terminal worden zowel het PowerShell- installatieprogramma als WSL2 Gateway-paden ondersteund. Documentatie: Windows.
Dit komt doorgaans door een niet-overeenkomende consolecodepagina in systeemeigen Windows-shells.Symptomen: uitvoer van system.run/exec geeft Chinees als onleesbare tekens weer; dezelfde opdracht ziet er in een ander terminalprofiel wel goed uit.Tijdelijke oplossing in PowerShell:
Start daarna de Gateway opnieuw en probeer het nogmaals:
Treedt dit nog steeds op met de nieuwste OpenClaw? Volg of meld het hier: Issue #30640.
Gebruik de aanpasbare (git-)installatie zodat je de volledige broncode en documentatie lokaal hebt. Stel vervolgens je vraag aan je bot (of Claude/Codex) vanuit die map, zodat deze de repository kan lezen en nauwkeurig kan antwoorden.
Meer informatie: Installeren en Opties voor het installatieprogramma.
Elke Linux-VPS is geschikt. Installeer OpenClaw op de server en maak vervolgens via SSH/Tailscale verbinding met de Gateway.Handleidingen: exe.dev, Hetzner, Fly.io. Externe toegang: Externe Gateway.
Hostingoverzicht met veelgebruikte providers:In de cloud draait de Gateway op de server en open je deze vanaf je laptop/telefoon via de Control UI (of Tailscale/SSH). Je status en werkruimte bevinden zich op de server, dus beschouw de host als de primaire bron en maak er een back-up van.Koppel nodes (Mac/iOS/Android/headless) aan die Gateway in de cloud voor lokale scherm-/camera-/canvasfuncties of opdrachtuitvoering op je laptop, terwijl de Gateway in de cloud blijft.Overzicht: Platforms. Externe toegang: Externe Gateway. Nodes: Nodes, Nodes-CLI.
Het is mogelijk, maar niet aanbevolen. Het updateproces kan de Gateway opnieuw starten (waardoor de actieve sessie wordt verbroken), kan een schone git-checkout vereisen en kan om bevestiging vragen. Het is veiliger om updates als beheerder vanuit een shell uit te voeren.
Automatiseren vanuit een agent:
Documentatie: Bijwerken, Updates installeren.
openclaw onboard is het aanbevolen configuratiepad. In de lokale modus doorloop je:
  1. Model/authenticatie - OAuth van de provider, API-sleutels of handmatige authenticatie (inclusief lokale opties zoals LM Studio); kies een standaardmodel.
  2. Werkruimte - locatie + bootstrapbestanden.
  3. Gateway - poort, bindadres, authenticatiemodus, beschikbaarstelling via Tailscale.
  4. Kanalen - ingebouwde chatkanalen en chatkanalen van officiële Plugins: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp en meer.
  5. Daemon - LaunchAgent (macOS), systemd-gebruikerseenheid (Linux/WSL2) of een systeemeigen geplande Windows-taak.
  6. Statuscontrole - start de Gateway en controleert of deze actief is.
  7. Skills - installeert aanbevolen Skills en optionele afhankelijkheden.
De verwachte duur wordt vooraf aangegeven en je krijgt een waarschuwing als je geconfigureerde model onbekend is of authenticatie ontbreekt. Volledig overzicht: Onboarding (CLI).
Nee. Voer OpenClaw uit met API-sleutels (Anthropic/OpenAI/andere) of uitsluitend lokale modellen, zodat je gegevens op je apparaat blijven. Abonnementen (Claude Pro/Max, ChatGPT/Codex) zijn optionele manieren om je bij die providers te authenticeren.Voor Anthropic: een API-sleutel biedt standaardfacturering op basis van gebruik; Claude CLI hergebruikt een bestaande Claude Code-aanmelding op dezelfde host. Anthropic behandelt momenteel het niet-interactieve claude -p-pad van Claude CLI als Agent SDK-/programmatisch gebruik dat nog steeds meetelt voor de limieten van je abonnement. Raadpleeg de actuele facturatiedocumentatie van Anthropic voordat je op abonnementsgedrag vertrouwt. Voor langdurig actieve Gateway-hosts en gedeelde automatisering is een Anthropic-API-sleutel de voorspelbaardere keuze.OpenAI Codex OAuth (ChatGPT/Codex-abonnement) wordt volledig ondersteund voor agentmodellen. OpenClaw ondersteunt ook gehoste abonnementsopties, waaronder Qwen Cloud Coding Plan, MiniMax Coding Plan en Z.AI / GLM Coding Plan.Documentatie: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Lokale modellen, Modellen.
Ja. OpenClaw ondersteunt hergebruik van Claude CLI voor Pro-/Max-/Team-/Enterprise-abonnementen. Anthropic behandelt het claude -p-pad dat OpenClaw gebruikt momenteel als gebruik binnen het abonnement, onderhevig aan de limieten van je abonnement, en niet als een afzonderlijke gratis toelage. Zie Anthropic voor de actuele factureringsinformatie en links naar de eigen ondersteuningsartikelen van Anthropic. Gebruik voor de meest voorspelbare serverconfiguratie in plaats daarvan een Anthropic-API-sleutel.
Ja, via hergebruik van Claude CLI. De factureringswijze van Anthropic voor claude -p/Agent SDK-gebruik is in de loop van de tijd gewijzigd; zie Anthropic voor de actuele status en gedateerde links naar de ondersteuningsartikelen van Anthropic voordat je op specifiek factureringsgedrag vertrouwt.Authenticatie met een Anthropic-installatietoken is ook nog steeds een ondersteund tokenpad, maar OpenClaw geeft waar mogelijk de voorkeur aan hergebruik van de Claude CLI en claude -p. Voor productie- of multi-userworkloads blijft een Anthropic API-sleutel de veiligere, voorspelbaardere keuze. Andere gehoste opties in abonnementsvorm: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM).
Je Anthropic-quotum/snelheidslimiet is voor het huidige tijdvenster opgebruikt. Wacht bij Claude CLI tot het tijdvenster opnieuw wordt ingesteld of upgrade je abonnement. Controleer bij een Anthropic API-sleutel het gebruik en de facturering in de Anthropic Console en verhoog zo nodig de limieten.Als het bericht specifiek Extra usage is required for long context requests is, probeert de aanvraag het contextvenster van 1M van Anthropic te gebruiken (een voor GA geschikt Claude 4.x-model met 1M, of verouderde configuratie params.context1m: true) en komen je huidige referenties niet in aanmerking voor facturering van lange context.Stel een fallbackmodel in, zodat OpenClaw blijft antwoorden terwijl de snelheidslimiet van een provider is bereikt. Zie Modellen, OAuth en Anthropic 429: extra gebruik vereist voor lange context.
Ja. OpenClaw heeft een gebundelde Amazon Bedrock (Converse)-provider. Als AWS-omgevingsmarkeringen aanwezig zijn (AWS_ACCESS_KEY_ID, AWS_PROFILE, AWS_BEARER_TOKEN_BEDROCK), schakelt OpenClaw automatisch de impliciete Bedrock-provider in voor modeldetectie; stel anders plugins.entries.amazon-bedrock.config.discovery.enabled: true in of voeg handmatig een providervermelding toe. Zie Amazon Bedrock en Modelproviders. Een OpenAI-compatibele proxy vóór Bedrock blijft een geldige optie als je de voorkeur geeft aan een beheerde sleutelstroom.
OpenClaw ondersteunt OpenAI Codex via OAuth (aanmelden bij ChatGPT). Een nieuwe installatie zonder primair model gebruikt exact openai/gpt-5.6-sol voor ChatGPT/Codex-abonnementsauthenticatie plus systeemeigen uitvoering via de Codex-appserver. Bij herauthenticatie blijft een bestaand expliciet model behouden, waaronder openai/gpt-5.5. Als de Codex-werkruimte GPT-5.6 niet beschikbaar stelt, selecteer dan expliciet openai/gpt-5.5; OpenClaw voert geen stille downgrade uit. Verouderde modelverwijzingen met een Codex-voorvoegsel zijn verouderde configuratie die door openclaw doctor --fix wordt hersteld. Rechtstreekse toegang met een OpenAI API-sleutel blijft beschikbaar voor niet-agentgebonden OpenAI API-oppervlakken en, via een geordend openai-API-sleutelprofiel, ook voor agentmodellen. Zie Modelproviders en Onboarding (CLI).
openai is de huidige provider- en authenticatieprofiel-id voor zowel OpenAI API-sleutels als ChatGPT/Codex OAuth; OpenAI Codex is erin opgenomen. Mogelijk zie je nog een verouderd voorvoegsel openai-codex in oudere configuratie- en migratiewaarschuwingen:
  • openai/gpt-5.6-sol = nieuwe ChatGPT/Codex-abonnementsinstallatie met de systeemeigen Codex-runtime voor agentbeurten.
  • openai/gpt-5.5 = expliciete ondersteunde selectie voor bestaande configuraties of accounts zonder toegang tot GPT-5.6.
  • Verouderde modelverwijzingen openai-codex/* = verouderde route die door openclaw doctor --fix wordt hersteld.
  • openai/gpt-5.5 plus een geordend openai-API-sleutelprofiel = API-sleutelauthenticatie voor een OpenAI-agentmodel.
  • Verouderde authenticatieprofiel-id’s openai-codex = verouderde id’s die door openclaw doctor --fix worden gemigreerd.
Wil je rechtstreekse facturering via OpenAI Platform? Stel OPENAI_API_KEY in. Wil je ChatGPT/Codex- abonnementsauthenticatie? Voer openclaw models auth login --provider openai uit. Houd modelverwijzingen onder de canonieke provider openai/*. Een nieuwe abonnementsinstallatie gebruikt exact openai/gpt-5.6-sol; doctor herstelt verouderde verwijzingen met een Codex-voorvoegsel zonder een expliciete selectie van openai/gpt-5.5 te upgraden.
Codex OAuth gebruikt door OpenAI beheerde, abonnementsafhankelijke quotumvensters die kunnen verschillen van de ervaring op de ChatGPT-website of in de app, zelfs met hetzelfde account.openclaw models status toont de momenteel zichtbare gebruiks- en quotumvensters van de provider, maar verzint of normaliseert ChatGPT-webrechten niet naar rechtstreekse API-toegang. Gebruik voor het rechtstreekse facturerings- en limietpad van OpenAI Platform openai/* met een API-sleutel.
Ja, volledig. OpenAI staat expliciet het gebruik van abonnements-OAuth toe in externe tools en workflows zoals OpenClaw. Onboarding kan de OAuth-stroom voor je uitvoeren.Zie OAuth, Modelproviders en Onboarding (CLI).
Gemini CLI gebruikt een Plugin-authenticatiestroom, geen client-id of geheim in openclaw.json.
  1. Installeer Gemini CLI lokaal, zodat gemini zich op PATH bevindt:
    • Homebrew: brew install gemini-cli
    • npm: npm install -g @google/gemini-cli
  2. Schakel de Plugin in: openclaw plugins enable google
  3. Meld je aan: openclaw models auth login --provider google-gemini-cli --set-default
  4. Standaardmodel na aanmelding: google/gemini-3.1-pro-preview (runtime google-gemini-cli)
  5. Mislukken aanvragen na aanmelding? Stel GOOGLE_CLOUD_PROJECT of GOOGLE_CLOUD_PROJECT_ID in op de Gateway-host en probeer het opnieuw.
OAuth-tokens worden opgeslagen in authenticatieprofielen op de Gateway-host. Details: Google, Modelproviders.
Meestal niet. OpenClaw heeft een grote context en sterke beveiliging nodig; kleine kaarten kappen de context af en slaan beveiligingsfilters aan de providerzijde over. Als het echt moet, voer dan lokaal de grootste modelbuild uit die je kunt gebruiken (LM Studio) — zie Lokale modellen. Kleinere/gekwantiseerde modellen verhogen het risico op promptinjectie — zie Beveiliging.
Kies regiogebonden eindpunten. OpenRouter biedt in de VS gehoste opties voor MiniMax, Kimi en GLM; kies de in de VS gehoste variant om gegevens binnen de regio te houden. Je kunt daarnaast nog steeds Anthropic/OpenAI vermelden met models.mode: "merge", zodat fallbacks beschikbaar blijven terwijl de door jou geselecteerde regionale provider wordt gerespecteerd.
Nee. OpenClaw draait op macOS of Linux (Windows via WSL2). Een Mac mini is een populaire keuze als altijd actieve host, maar een kleine VPS, thuisserver of Raspberry Pi-achtige machine werkt ook.Je hebt alleen een Mac nodig voor tools die uitsluitend op macOS werken. Gebruik voor iMessage iMessage met imsg op elke Mac die bij Berichten is aangemeld. Als de Gateway op Linux of elders draait, stel dan channels.imessage.cliPath in op een SSH-wrapper die imsg op die Mac uitvoert. Voer voor andere tools die uitsluitend op macOS werken de Gateway uit op een Mac of koppel een macOS-node.Documentatie: iMessage, Nodes, Externe Mac-modus.
Je hebt een macOS-apparaat nodig dat bij Berichten is aangemeld — niet noodzakelijk een Mac mini; elke Mac werkt. Gebruik iMessage met imsg; de Gateway kan op die Mac draaien, of elders met een SSH-wrapper cliPath.Veelgebruikte configuraties:
  • Gateway op Linux/VPS, waarbij channels.imessage.cliPath is ingesteld op een SSH-wrapper die imsg uitvoert op een Mac die bij Berichten is aangemeld.
  • Alles op één Mac voor de eenvoudigste configuratie met één machine.
Documentatie: iMessage, Nodes, Externe Mac-modus.
Ja. De Mac mini kan de Gateway uitvoeren en je MacBook Pro maakt verbinding als node (begeleidend apparaat). Nodes voeren de Gateway niet uit; ze voegen mogelijkheden toe zoals scherm/camera/canvas en system.run op dat apparaat.Veelgebruikt patroon: de Gateway op de altijd actieve Mac mini; de MacBook Pro voert de macOS-app of een nodehost uit en wordt aan de Gateway gekoppeld. Controleer dit met openclaw nodes status / openclaw nodes list.Documentatie: Nodes, Nodes-CLI.
Je kunt Bun gebruiken om afhankelijkheden te installeren of pakketscripts uit te voeren. De OpenClaw CLI en Gateway vereisen Node, omdat de canonieke statusopslag node:sqlite gebruikt; Bun biedt die API niet.
channels.telegram.allowFrom is de Telegram-gebruikers-id van de menselijke afzender (numeriek), niet de gebruikersnaam van de bot. De installatie vraagt uitsluitend om numerieke gebruikers-id’s; openclaw doctor --fix kan proberen verouderde vermeldingen van @username om te zetten.Veiliger (geen bot van derden): stuur je bot een privébericht, voer openclaw logs --follow uit en lees from.id.Officiële Bot API: stuur je bot een privébericht, roep https://api.telegram.org/bot<bot_token>/getUpdates aan en lees message.from.id.Derde partij (minder privé): stuur @userinfobot of @getidsbot een privébericht.Zie Telegram-toegangsbeheer.
Ja, via multi-agentroutering. Koppel het WhatsApp-privébericht van elke afzender (peer: { kind: "direct", id: "+15551234567" }) aan een andere agentId, zodat elke persoon een eigen werkruimte en sessieopslag heeft. Antwoorden komen nog steeds van hetzelfde WhatsApp-account; toegangsbeheer voor privéberichten (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) is globaal per account. Zie Multi-agentroutering en WhatsApp.
Ja. Gebruik multi-agentroutering: geef elke agent een eigen standaardmodel en koppel vervolgens inkomende routes (provideraccount of specifieke peers) aan elke agent. Voorbeeldconfiguratie: Multi-agentroutering. Zie ook Modellen en Configuratie.
Ja, via Linuxbrew:
OpenClaw uitvoeren via systemd: zorg ervoor dat het PATH van de service /home/linuxbrew/.linuxbrew/bin (of je brew-voorvoegsel) bevat, zodat met brew geïnstalleerde tools in niet-aanmeldingss shells worden gevonden. Recente builds voegen ook veelgebruikte gebruikersmappen met binaire bestanden 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 deze zijn ingesteld.
  • Aanpasbare installatie (git): volledige broncodecheckout, bewerkbaar, het meest geschikt voor bijdragers. Je bouwt lokaal en kunt code/documentatie aanpassen.
  • npm-installatie: globale CLI-installatie, zonder repository, het meest geschikt om het “gewoon uit te voeren”. Updates komen via npm-dist-tags.
Documentatie: Aan de slag, Bijwerken.
Ja, met openclaw update --channel ... op een bestaande installatie. Hierdoor worden je gegevens niet verwijderd — alleen de installatie van de OpenClaw-code verandert. De status (~/.openclaw) en werkruimte (~/.openclaw/workspace) blijven onaangeroerd.Van npm naar git:
Van git naar npm:
Voeg --dry-run toe om eerst een voorbeeld van de geplande moduswisseling te bekijken. De updater voert vervolgacties van Doctor uit, vernieuwt Plugin-bronnen voor het doelkanaal en start de Gateway opnieuw, tenzij je --no-restart meegeeft.Het installatieprogramma kan beide modi ook afdwingen:
Back-uptips: Waar onderdelen op schijf staan.
Wil je 24/7 betrouwbaarheid? Gebruik een VPS. Wil je zo min mogelijk gedoe en vind je de slaapstand en herstarts geen probleem? Voer de Gateway lokaal uit.Laptop (lokale Gateway)
  • Voordelen: geen serverkosten, directe toegang tot lokale bestanden, een zichtbaar browservenster.
  • Nadelen: de slaapstand of netwerkuitval verbreekt de verbinding, OS-updates en herstarts onderbreken de Gateway, de laptop moet actief blijven.
VPS / cloud
  • Voordelen: altijd actief, stabiel netwerk, geen problemen door de slaapstand van de laptop, eenvoudiger continu actief te houden.
  • Nadelen: vaak headless (gebruik schermafbeeldingen), alleen externe bestandstoegang, SSH vereist voor updates.
WhatsApp/Telegram/Slack/Mattermost/Discord werken allemaal prima vanaf een VPS — de werkelijke afweging is een headless browser tegenover een zichtbaar venster. Zie Browser.Standaardaanbeveling: gebruik een VPS als de verbinding met de Gateway eerder is verbroken; lokaal werkt uitstekend wanneer je de Mac actief gebruikt en toegang tot lokale bestanden of UI-automatisering met een zichtbare browser wilt.
Dit is niet vereist, maar wordt aanbevolen voor betrouwbaarheid en isolatie.
  • Aparte host (VPS/Mac mini/Raspberry Pi): altijd actief, minder onderbrekingen door de slaapstand of herstarts, overzichtelijkere machtigingen, eenvoudiger continu actief te houden.
  • Gedeelde laptop/desktop: prima voor tests en actief gebruik, maar verwacht pauzes wanneer de machine in de slaapstand gaat of wordt bijgewerkt.
Het beste van beide werelden: laat de Gateway op een aparte host draaien en koppel je laptop als een Node voor lokale scherm-, camera- en uitvoeringstools. Zie Nodes en Beveiliging.
  • Absoluut minimum: 1 vCPU, 1 GB RAM, ~500 MB schijfruimte.
  • Aanbevolen: 1-2 vCPU, 2 GB+ RAM voor extra capaciteit (logboeken, media, meerdere kanalen). Node-tools en browserautomatisering kunnen veel systeembronnen gebruiken.
OS: Ubuntu LTS (of een moderne versie van Debian/Ubuntu) — het uitvoerigst geteste installatiepad voor Linux.Documentatie: Linux, VPS-hosting.
Ja. Behandel een VM als een VPS: deze moet altijd actief en bereikbaar zijn en voldoende RAM hebben voor de Gateway en alle kanalen die je inschakelt.
  • Absoluut minimum: 1 vCPU, 1 GB RAM.
  • Aanbevolen: 2 GB+ RAM voor meerdere kanalen, browserautomatisering of mediatools.
  • OS: Ubuntu LTS of een andere moderne versie van Debian/Ubuntu.
Gebruik op Windows Windows Hub voor de desktopconfiguratie, of WSL2 voor een Linux-achtige Gateway-VM met brede compatibiliteit met tools. Zie Windows, VPS-hosting. macOS uitvoeren in een VM: zie macOS-VM.

​
Gerelateerd