FAQ: configuratie bij eerste keer uitvoeren

Gebruik een lokale AI-agent die je machine kan zien. Dat is veel effectiever dan vragen in Discord, omdat de meeste gevallen van "ik zit vast" 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, commando's uitvoeren, logs inspecteren en helpen je configuratie op machineniveau te repareren (PATH, services, rechten, authenticatiebestanden). 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 draait. Je kunt later altijd terugschakelen naar stable door de installer opnieuw uit te voeren zonder --install-method git.

Tip: vraag de agent om de oplossing te plannen en te begeleiden (stap voor stap), en voer daarna alleen de noodzakelijke commando's uit. Zo blijven wijzigingen klein en makkelijker 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 commando's (deel de uitvoer wanneer je om hulp vraagt):

openclaw statusopenclaw models statusopenclaw doctor

Wat ze doen:

• openclaw status: snelle momentopname van gateway-/agent-gezondheid + basisconfiguratie.
• openclaw models status: controleert provider-authenticatie + beschikbaarheid van modellen.
• openclaw doctor: valideert en repareert veelvoorkomende configuratie-/statusproblemen.

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

Snelle debuglus: Eerste 60 seconden als er iets stuk is. Installatiedocs: Installeren, Installer-flags, Bijwerken.

Veelvoorkomende Heartbeat-overslaanredenen:

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

In taakmodus worden verschuldigde tijdstempels pas vooruitgezet 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 dit uit via pnpm openclaw onboard.

De wizard opent direct na onboarding je browser met een schone (niet-getokeniseerde) dashboard-URL 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-authenticatie wordt gevraagd, plak je 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 gedeeld geheim is geconfigureerd, genereer dan een token met openclaw doctor --generate-gateway-token.

Niet op localhost:

• Tailscale Serve (aanbevolen): houd bind op local loopback, voer openclaw gateway --tailscale serve uit, open https://<magicdns>/. Als gateway.auth.allowTailscale true is, voldoen identity-headers aan Control UI-/WebSocket-authenticatie (geen geplakt gedeeld geheim, gaat uit van vertrouwde gatewayhost); HTTP-API's vereisen nog steeds shared-secret-authenticatie, tenzij je bewust private-ingress none of trusted-proxy HTTP-authenticatie gebruikt. Slechte gelijktijdige Serve-authenticatiepogingen 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 wachtwoordauthenticatie), open http://<tailscale-ip>:18789/ en plak daarna het bijbehorende gedeelde geheim 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-authenticatie geldt nog steeds via de tunnel; plak het geconfigureerde token of wachtwoord als daarom wordt gevraagd.

Zie Dashboard en Weboppervlakken voor bind-modi en authenticatiedetails.

Ze beheren verschillende lagen:

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

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

In de meeste configuraties heb je niet allebei nodig:

• Als de chat al commando's en antwoorden ondersteunt, werkt /approve in dezelfde chat via het gedeelde pad.
• Als een ondersteund native kanaal approvers veilig 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 mag alleen een handmatig /approve-commando opnemen als het toolresultaat zegt dat chatgoedkeuringen niet beschikbaar zijn of dat 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 in de oorspronkelijke room/topic worden geplaatst.
• Plugin-goedkeuringen zijn opnieuw afzonderlijk: ze gebruiken standaard /approve in dezelfde chat, optionele approvals.plugin-doorsturing, en alleen sommige native kanalen behouden native afhandeling voor Plugin-goedkeuringen daarbovenop.

Korte versie: doorsturen is voor routing, 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 noemen 512MB-1GB RAM, 1 core en ongeveer 500MB schijf als genoeg voor persoonlijk gebruik, en vermelden dat een Raspberry Pi 4 dit kan draaien.

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

Tip: een kleine Raspberry Pi/VPS kan de Gateway hosten, en je kunt knooppunten op je laptop/telefoon koppelen voor lokaal scherm/camera/canvas of commando-uitvoering. Zie Knooppunten.

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.
• Begin zonder kanalen/Skills en voeg ze daarna een voor een toe.
• Als je vreemde binaire problemen tegenkomt, is het meestal een ARM-compatibiliteitsprobleem.

Docs: Linux, Installeren.

Dat scherm is afhankelijk van een bereikbare en geauthenticeerde Gateway. 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 + authenticatie:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Als het nog steeds hangt, voer uit:

openclaw doctor

Als de Gateway remote is, zorg dan 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 "exactly the same" (geheugen, sessiegeschiedenis, authenticatie 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 behoudt configuratie, authenticatieprofielen, WhatsApp-credentials, sessies en geheugen. Als je in remote modus werkt, 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 authenticatie. 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, Wijzigingen en Fixes (plus docs/andere secties wanneer nodig).

Sommige Comcast-/Xfinity-verbindingen blokkeren docs.openclaw.ai onterecht via Xfinity Advanced Security. Schakel dit uit of zet docs.openclaw.ai op de allowlist en probeer het 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, worden de docs gespiegeld op GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Stable en beta zijn npm dist-tags, geen afzonderlijke codelijnen:

• latest = stable
• beta = vroege build voor testen

Meestal komt een stable 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 stable na promotie naar dezelfde versie verwijzen.

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

Zie de accordion hieronder voor installatieregels 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); wanneer gepubliceerd, gebruikt deze de npm dist-tag dev.

One-liners (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. Hackbare installatie (vanaf de installatiesite):

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

Daarmee krijg je een lokale repo die je kunt bewerken en daarna via git kunt bijwerken.

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

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

Docs: Bijwerken, Ontwikkelkanalen, Installeren.

Ruwe richtlijn:

• Installatie: 2-5 minuten
• QuickStart-onboarding: meestal een paar minuten
• Volledige onboarding: langer wanneer provider-aanmelding, kanaalkoppeling, daemon-installatie, netwerkdownloads, Skills of optionele plugins extra configuratie nodig hebben

De CLI-wizard toont deze tijdlijn vooraf. Je kunt optionele stappen overslaan en later terugkomen met openclaw configure.

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 hackbare (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 ervoor 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 directory 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.

Gebruik voor desktopconfiguratie de native Windows Hub-app. Voor configuratie alleen via de terminal worden zowel het PowerShell-installatieprogramma als WSL2 Gateway-paden ondersteund. Docs: Windows.

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

Symptomen:

• system.run/exec-uitvoer rendert Chinees 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 kunt reproduceren op de nieuwste OpenClaw, volg/rapporteer het dan in:

• Issue #30640

Gebruik de hackbare (git-)installatie zodat je de volledige broncode en docs lokaal hebt, en vraag daarna je bot (of Claude/Codex) vanuit die map zodat die de repo kan lezen en nauwkeurig 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.

• Linux-snelpad + service-installatie: Linux.
• Volledige walkthrough: Aan de slag.
• Installatieprogramma + updates: Installatie en updates.

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 houden een hostinghub bij 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 opent deze vanaf je laptop/telefoon via de Control UI (of Tailscale/SSH). Je status + werkruimte staan 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 uit te voeren op je laptop 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 uit vanuit een shell 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

Docs: Bijwerken, Bijwerken.

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

• Model-/auth-configuratie (provider-OAuth, API-sleutels, Anthropic setup-token, plus lokale modelopties zoals LM Studio)
• Workspace-locatie + bootstrapbestanden
• Gateway-instellingen (bind/poort/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)
• Healthchecks en skills-selectie

Het stelt ook duurverwachtingen voordat de hoofdprompts beginnen en waarschuwt als je geconfigureerde model onbekend is of auth mist.

Nee. Je kunt OpenClaw uitvoeren 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 langlevende gatewayhosts zijn Anthropic API-sleutels nog steeds de voorspelbaardere configuratie. 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.

Docs: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), 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 configuratie 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 is Anthropic API-sleutelauth nog steeds 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 uitgeput. Als je Claude CLI gebruikt, wacht dan tot het venster wordt gereset of upgrade je abonnement. Als je een Anthropic API key gebruikt, controleer dan de Anthropic Console op gebruik/facturering en verhoog de limieten waar nodig.

Als het bericht specifiek dit is: Extra usage is required for long context requests, probeert de aanvraag Anthropic's 1M-contextvenster te gebruiken (een GA-geschikt 1M Claude 4.x-model of legacy context1m: true-config). Dat werkt alleen wanneer je referentie in aanmerking komt voor long-context-facturering (API key-facturering of het OpenClaw Claude-loginpad met Extra Usage ingeschakeld).

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

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

OpenClaw ondersteunt OpenAI Code (Codex) via OAuth (ChatGPT-aanmelding). Gebruik openai/gpt-5.5 voor de gangbare setup: ChatGPT/Codex-abonnementsauthenticatie plus native Codex-app-serveruitvoering. Legacy Codex GPT-referenties zijn legacy config die wordt gerepareerd door openclaw doctor --fix. Directe OpenAI API-key- toegang blijft beschikbaar voor niet-agent OpenAI API-oppervlakken en voor agent- modellen via een geordend openai API-key-profiel. Zie Modelproviders en Onboarding (CLI).

openai is de provider- en auth-profiel-id voor zowel OpenAI API keys als ChatGPT/Codex OAuth. Je kunt de legacy OpenAI Codex-prefix nog zien in legacy config en migratiewaarschuwingen. Oudere configs gebruikten die ook als modelprefix:

• openai/gpt-5.5 = ChatGPT/Codex-abonnementsauthenticatie met native Codex-runtime voor agentbeurten
• legacy Codex GPT-5.5-ref = legacy modelroute gerepareerd door openclaw doctor --fix
• openai/gpt-5.5 plus een geordend openai API-key-profiel = API-key-authenticatie voor een OpenAI-agentmodel
• legacy Codex-authprofiel-id's = legacy authprofiel-id gemigreerd door openclaw doctor --fix

Als je het directe OpenAI Platform-facturerings-/limietpad wilt, stel dan OPENAI_API_KEY in. Als je ChatGPT/Codex-abonnementsauthenticatie wilt, meld je dan aan met openclaw models auth login --provider openai. Houd de modelreferentie op openai/gpt-5.5; legacy Codex-modelreferenties zijn legacy config die openclaw doctor --fix herschrijft.

Codex OAuth gebruikt door OpenAI beheerde, abonnementsafhankelijke 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 gebruiks-/quotavensters van providers tonen in openclaw models status, maar het bedenkt of normaliseert geen ChatGPT-web- rechten naar directe API-toegang. Als je het directe OpenAI Platform- facturerings-/limietpad wilt, gebruik dan openai/* met een API key.

Ja. OpenClaw ondersteunt OpenAI Code (Codex) abonnements-OAuth volledig. OpenAI staat expliciet abonnements-OAuth-gebruik 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-authflow, geen client-id of secret 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 dan GOOGLE_CLOUD_PROJECT of GOOGLE_CLOUD_PROJECT_ID in op de gatewayhost

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

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

Kies regio-vastgezette 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, thuisserver of Raspberry Pi-klasse apparaat 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 is aangemeld bij Berichten. Als de Gateway op Linux of elders draait, stel dan channels.imessage.cliPath in op een SSH-wrapper die imsg op die Mac uitvoert. Als je andere macOS-only tools wilt, draai de Gateway dan op een Mac of koppel een macOS-node.

Docs: iMessage, Nodes, Mac remote mode.

Je hebt een macOS-apparaat nodig dat is aangemeld bij Berichten. Dat hoeft geen Mac mini te zijn - elke Mac werkt. Gebruik iMessage met imsg; de Gateway kan op die Mac draaien, of ergens anders 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 is aangemeld bij Berichten.
• Draai alles op de Mac als je de eenvoudigste setup op één machine wilt.

Docs: iMessage, Nodes, Mac remote mode.

Ja. De Mac mini kan de Gateway draaien, en je MacBook Pro kan verbinden 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 deze 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-productie-gateway 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 legacy @username-vermeldingen in config hebt, kan openclaw doctor --fix proberen deze 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.

Derden (minder privé):

• Stuur een DM naar @userinfobot of @getidsbot.

Zie /channels/telegram.

Ja, via multi-agent-routering. Bind de WhatsApp-DM van elke afzender (peer kind: "direct", afzender E.164 zoals +15551234567) aan een andere agentId, zodat iedereen zijn 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 Multi-Agent-routering en WhatsApp.

Ja. Gebruik multi-agent-routering: geef elke agent zijn eigen standaardmodel en bind vervolgens inkomende routes (provideraccount of specifieke peers) aan elke agent. Voorbeeldconfig staat in Multi-Agent-routering. 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 dan dat de service-PATH /home/linuxbrew/.linuxbrew/bin (of je brew-prefix) bevat, zodat met brew geïnstalleerde tools worden gevonden in non-login shells. Recente builds voegen ook algemene gebruikers-binmappen vooraan toe op 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 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 van 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 state (~/.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 moduswisseling te bekijken. De updater voert Doctor-vervolgacties uit, vernieuwt Plugin-bronnen voor het doelkanaal en herstart de Gateway tenzij je --no-restart meegeeft.

Het installatieprogramma 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 laagste drempel wilt en slaapstand/herstarts acceptabel vindt, draai hem 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 aan, stabiel netwerk, geen problemen met laptopslaapstand, makkelijker draaiend te houden.
• Nadelen: vaak headless draaien (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 headless browser versus een zichtbaar venster. Zie Browser.

Aanbevolen standaard: VPS als je eerder Gateway-verbindingsverbrekingen had. 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/Raspberry Pi): altijd aan, minder onderbrekingen door slaapstand/herstart, schonere rechten, makkelijker draaiend 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 scherm-/camera-/exec-tools. 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 marge (logs, media, meerdere kanalen). Node-tools en browserautomatisering kunnen veel resources vragen.

OS: 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: hij moet altijd aan staan, 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.
• OS: Ubuntu LTS of een andere moderne Debian/Ubuntu.

Als je Windows gebruikt, gebruik dan Windows Hub voor desktopinstallatie, of WSL2 wanneer je specifiek een Linux-achtige Gateway-VM wilt met brede compatibiliteit met tooling. Zie Windows, VPS-hosting. Als je macOS in een VM draait, zie macOS-VM.