OpenClaw installeren en OmniProxy configureren

OpenClaw is een AI-assistent die op je eigen computer wordt geïnstalleerd. Je kunt er rechtstreeks mee praten via Telegram, Discord, WhatsApp of Feishu zonder dat je een ander chatvenster open hoeft te houden. Gesprekken en gegevens blijven op deze computer staan en de assistent kan zelfstandig vervolgstappen lokaal uitvoeren.

Voordat je begint

OpenClaw vereist Node 24.16 of nieuwer. Je kunt ook Node 26.1 of nieuwer gebruiken; Node 26 wordt aanbevolen. Node levert de runtime-omgeving die OpenClaw nodig heeft.

Het kan worden geïnstalleerd op macOS, Linux en Windows. Als de computer niet over een geschikte versie van Node beschikt, zal het installatiescript er automatisch een voorbereiden: Node 26 op macOS en Node 24 LTS op Linux. pnpm is alleen vereist als je OpenClaw vanaf de broncode bouwt.

Als er al een oudere versie van Node is geïnstalleerd, hoef je deze niet eerst te verwijderen. Tijdens tests op 09-10-2026 was de systeemversie van Node op deze computer 24.2.0, lager dan de vereiste 24.16, en het niet-interactieve installatiescript bereidde automatisch Node 24.21.0 voor.

Wil je een venster

Desktop-metgezel

Gebruik de Hub-installer op Windows
Gebruik de GitHub DMG op macOS
De lokale Gateway kan tijdens de eerste installatie worden geïnstalleerd

Officieel aanbevolen

Installatiescript

macOS Linux WSL2
Gebruik PowerShell op Windows
Je kunt --no-onboard toevoegen

Node al geïnstalleerd

Pakketbeheerder

npm pnpm of bun
Voer daarna onboard uit
Zie de installatiepagina voor de Node-versie

Download de desktop-metgezel als je een venster wilt. Als je het alleen in de terminal wilt gebruiken, voer dan het officiële installatiescript uit.

Installeren en voor de eerste keer opstarten

Je kunt de desktop-metgezel met een grafisch venster installeren, of direct via de terminal. Gateway is de lokale service die verantwoordelijk is voor het ontvangen van berichten, het aanroepen van modellen en het retourneren van resultaten. Je kunt dit instellen wanneer je de desktop-metgezel voor de eerste keer opent.

Als je een venster wilt

Windows: Download en voer uit OpenClawCompanion-Setup-x64.exe of OpenClawCompanion-Setup-arm64.exe. De installer is ondertekend en bevat instellingen, status in het systeemvak, chat en node-modi.
macOS: Download de OpenClaw .dmg van de GitHub-releases van OpenClaw. Geef de voorkeur aan de dmg, hoewel je ook de .zipkunt gebruiken. Open OpenClaw.app na installatie. Als deze versie geen macOS-bestand bevat, volg dan de pagina voor de macOS-app.

Wanneer je het voor de eerste keer opent, kun je OpenClaw de Gateway op deze computer laten voorbereiden of verbinding laten maken met een bestaande externe Gateway.

Installeren via de terminal

Gebruik voor macOS, Linux en WSL2:

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

Gebruik voor Windows PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

Het script detecteert het huidige systeem, installeert Node indien nodig, installeert OpenClaw en start vervolgens het initiële onboarding-proces. De onboarding-flow leidt je door de eerste configuratie.

Als je de onboarding nog niet wilt starten, gebruik dan in plaats daarvan op macOS, Linux en WSL2:

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

Gebruik op Windows de officiële -NoOnboard optie:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Als je Node al zelf beheert, kun je ook npm, pnpm of bun gebruiken. Voer bij npm 12 of npm 11.16 en later uit:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Verwijder bij npm 11.15 en eerder --allow-scripts=openclaw. Voeg bij gebruik van pnpm --allow-build=openclawtoe. Raadpleeg de installatiepagina voor de exacte verschillen.

Voer na installatie deze drie commando’s achter elkaar uit:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version geeft de versie weer, openclaw doctor controleert op veelvoorkomende omgevingsproblemen en openclaw gateway status laat zien of de Gateway draait. De basisinstallatie is pas voltooid als alle drie de commando’s normale uitvoer geven.

Als de terminal meldt dat deze openclawniet kan vinden, ontbreekt meestal de npm global bin-directory in PATH. PATH is de lijst met locaties waar de terminal naar programma’s zoekt. Vergelijk de uitvoer van node -v, npm prefix -gen echo "$PATH", voeg de bijbehorende bin-directory toe aan PATH en open de terminal opnieuw.

Als ~/.openclaw al een configuratie bevat die momenteel in gebruik is, zal het standaard installatiescript die directory gebruiken. Om een aparte kopie te installeren zonder de bestaande configuratie te wijzigen, voer je het niet-interactieve script uit en specificeer je een nieuwe directory:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard is het standaardgedrag van dit script. Op 09-10-2026 installeerde dit commando OpenClaw 2026.9.9. Voer na installatie het openclaw uitvoerbare bestand uit vanuit de bin map van de directory.

Verbindingswaarden ophalen uit OmniProxy

Bevestig eerst dat OmniProxy draait, open vervolgens de modellijst en bereid de volgende drie waarden voor:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl is het adres waarnaar OpenClaw modelverzoeken stuurt, en dit moet eindigen op /v1. Gebruik bij verbinding met OmniProxy openai-completions voor api. Wijzig dit alleen naar openai-responses als het model daadwerkelijk werkt via /v1/responses.

De Model ID is de volledige identificatie van het model in de lijst. Kopieer deze exact zoals weergegeven, inclusief eventuele slashes. De volgende twee namen zijn slechts referenties uit de documentatie van de provider op 09-10-2026; gebruik ze niet als ze niet in de lijst voorkomen: claude-sonnet-5-5, gpt-6-luna.

Zelfs als de gateway de sleutel niet valideert, apiKey moet nog steeds een waarde bevatten. Je kunt een tijdelijke tekenreeks gebruiken die alleen op deze computer wordt gebruikt. Commit geen echte sleutel naar een repository.

De toolconfiguratie invoeren

Een Provider kan worden begrepen als een set verbindingsinstellingen die OpenClaw gebruikt om een modelservice te vinden. Hier is de Provider genaamd omniproxy.

Voer het volgende commando uit in de terminal en vervang het adres, de sleutel en de twee model-ID’s door je eigen waarden:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Dit commando schrijft de Provider en de modellijst naar de configuratie. Je hoeft de Gateway niet opnieuw op te starten nadat het commando is geslaagd.

Specificeer vervolgens het standaardmodel. De modelreferentie bestaat uit omniproxy/ gevolgd door de model-ID. Behoud elke slash die al in de ID aanwezig is. Als de ID in de modellijst langer is dan de korte naam hieronder, gebruik dan de volledige waarde uit de lijst:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindowen maxTokens kunnen allemaal worden weggelaten. Wanneer ze niet worden opgegeven, worden tekstmodellen afgehandeld met de standaardinstellingen.

Je kunt dezelfde instellingen ook rechtstreeks in het configuratiebestand schrijven. In de hoofdconfiguratie bevindt de Provider zich onder models.providers. Elke agent kan ook zijn eigen models.jsonhebben; een agent is een assistent-instantie die daadwerkelijk taken ontvangt en modellen aanroept. Het bestand bevindt zich op agent/models.json binnen de bijbehorende agent-directory onder ~/.openclaw/agents/.

Als deze models.json een niet-lege baseUrlbevat, overschrijft deze het adres in de hoofdconfiguratie.

Installatie controleren

Drie commando's

openclaw --version
openclaw doctor
gateway status

Configuratie

models.providers

baseUrl eindigt op /v1
Stel api in op completions
Specificeer ten minste de model-id

Selecteer

provider/model

Gebruik deze referentie voor primair
Geef de voorkeur aan een omgevingsvariabele voor de sleutel
Gebruik de gateway-lijst als bron van waarheid

Bevestig eerst dat het commando kan worden gevonden en voer vervolgens het adres en het model in. De modelreferentie moet de Provider-naam bevatten.

Een echte taak verifiëren

Ga naar een normale projectdirectory en stuur een heel kort bericht. Vervang de modelreferentie in het commando door je volledige Model ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local voert deze agent-taak lokaal uit, --model specificeert het model dat voor deze run moet worden gebruikt en --timeout 300 stelt de maximale wachttijd in op 300 seconden.

Een daadwerkelijke modelrespons moet in de terminal verschijnen. Op 09-10-2026 ontving OpenClaw 2026.9.9 een respons met dit commando. De eerste aanroep kan een of twee minuten duren.

Als de oorspronkelijke fout Request timed out before a response was generated verschijnt, verhoog dan --timeout en stuur het verzoek opnieuw. Dit betekent meestal dat de wachttijd onvoldoende was en duidt niet noodzakelijkerwijs op een onjuist adres.

Nadat de korte respons is geslaagd, vraag je de assistent om een lokaal bestand te lezen dat je specificeert. Open vervolgens de verzoekrecords van OmniProxy en bevestig de bron en de model-ID die in het record worden getoond. Uitvoer van alleen het versie-commando of doctor betekent niet dat de modelverbinding volledig is geconfigureerd.

Installatie

Het commando reageert

Het versienummer wordt weergegeven
doctor rapporteert geen blokkades
Gateway-status is leesbaar

Taak

Het voltooide een kleine taak

Lees bijvoorbeeld een lokaal bestand
De respons is geen fout
De modelreferentie is correct

Logboeken

Zichtbaar in de gateway

Bron is OpenClaw
Model-ID komt overeen
De sleutel is niet toegevoegd aan de repository

Nadat het versie-commando uitvoer geeft, moet je ook één echte respons ontvangen.

Veelvoorkomende fouten

Kan openclawniet vinden: Voeg de npm global bin-directory toe aan PATH en open de terminal opnieuw. Als je in een specifieke directory hebt geïnstalleerd, voer dan het uitvoerbare bestand uit vanuit de bin map van die directory.
node -v is lager dan 24.16: Je hoeft de oude versie niet eerst te verwijderen. Controleer de Node-versie die door het installatiescript is voorbereid, of gebruik 24.16+ of 26.1+ zoals beschreven op de installatiepagina. Node 26 wordt aanbevolen.
Het model verschijnt niet: Het model moet zijn opgenomen in de models array onder models.providers en moet ten minste dezelfde idhebben. Alleen agents.defaults.models instellen registreert niet uit zichzelf een nieuw model.
Een 400-respons vermeldt de developer-rol: Wanneer de adres-host niet api.openai.comis, behoud dan de standaardinstelling en zet supportsDeveloperRole niet op true. Zelfs als het op true is ingesteld, zal het nog steeds worden overschreven.
Het time-out snel: Verhoog --timeout naar meer dan 300 seconden voordat je het adres wijzigt.
Tool-aanroepen mislukken na het selecteren van gpt-6-luna: Het ondersteunt Chat Completions; functie-aanroepen in Chat Completions worden alleen ondersteund wanneer reasoning_effort is none. Als de ID in de lijst afwijkt van deze, gebruik dan de ID die in de lijst wordt getoond.
Het adres is onbereikbaar: Bevestig dat OmniProxy draait, dat baseUrl eindigt op /v1, en dat het adres dat naar de configuratie is geschreven toegankelijk is. Andere adressen in het privénetwerk moeten afzonderlijk worden toegestaan.
Verzoeken gaan na configuratie nog steeds naar een ander adres: Controleer of de models.json van die agent een andere baseUrl.

bevat.

Officiële referenties

Zie voor installatiestappen OpenClaw install. Zie voor aangepaste Provider-configuratie Custom providers en configuration fields. Vergelijk voor de model-ID’s die in de voorbeelden worden gebruikt met Claude model overview en GPT-6 Luna.

Vervang elke placeholder met waarden uit uw eigen OmniProxy-configuratie. Publiceer nooit een echte sleutel.

Een opgeslagen resultaat of HTTP 200 alleen bewijst geen volledige Agent-compatibiliteit. Controleer de bron en het model in het oproeprecord van OmniProxy.

Officiële bronnen · OpenClaw ↗