OpenClaw installeren en OmniProxy configureren

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

Voordat je begint

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

Het kan worden geïnstalleerd op macOS, Linux en Windows. Als de computer geen geschikte versie van Node heeft, zal het installatiescript er automatisch een voorbereiden: Node 26 op macOS en Node 24 LTS op Linux. pnpm is alleen vereist bij het bouwen van OpenClaw vanuit de broncode.

Als er al een oudere versie van Node is geïnstalleerd, hoef je deze niet eerst te verwijderen. Tijdens het testen op 9 oktober 2026 was de systeem-Node-versie 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 rechtstreeks via de terminal. Gateway is de lokale service die verantwoordelijk is voor het ontvangen van berichten, het aanroepen van modellen en het retourneren van de resultaten. Je kunt dit instellen wanneer je de desktop-metgezel voor de eerste keer opent.

Als je een venster wilt

Windows: Download en voer OpenClawCompanion-Setup-x64.exe of OpenClawCompanion-Setup-arm64.exeuit. De installer is ondertekend en bevat instellingen, systeemvakstatus, chat- en node-modi.
macOS: Download de OpenClaw .dmg van OpenClaw’s GitHub-releases. 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 macOS-app-pagina.

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 begeleidt je door de eerste installatie.

Als je nog niet met onboarding wilt beginnen, gebruik dan in plaats daarvan het volgende 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 nieuwer 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 opdrachten achter elkaar uit:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version toont de versie, openclaw doctor controleert op veelvoorkomende omgevingsproblemen en openclaw gateway status laat zien of Gateway draait. De basisinstallatie is pas voltooid wanneer alle drie de opdrachten normale uitvoer produceren.

Als de terminal meldt dat deze openclawniet kan vinden, ontbreekt meestal de npm globale bin-map 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-map toe aan PATH en open de terminal opnieuw.

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

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 9 oktober 2026 installeerde deze opdracht 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 verzendt en het moet eindigen op /v1. Gebruik bij verbinding met OmniProxy openai-completions voor api. Wijzig dit alleen in 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 9 oktober 2026; gebruik ze niet als ze niet in de lijst staan: claude-sonnet-5-5, gpt-6-luna.

Zelfs als de gateway de sleutel niet valideert, moet apiKey nog steeds een waarde bevatten. Je kunt een placeholder-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 lokaliseren. Hier is de Provider genaamd omniproxy.

Voer de volgende opdracht 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

Deze opdracht schrijft de Provider en de modellijst naar de configuratie. Je hoeft Gateway niet opnieuw op te starten nadat de opdracht 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 verstrekt, 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-map onder ~/.openclaw/agents/. Als deze models.json een niet-lege baseUrlbevat, overschrijft deze het adres in de hoofdconfiguratie.

Installatie controleren

Drie opdrachten

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 de bron van waarheid

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

Een echte taak verifiëren

Ga naar een normale projectmap en stuur een heel kort bericht. Vervang de modelreferentie in de opdracht 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 daadwerkelijk modelantwoord moet in de terminal verschijnen. Op 9 oktober 2026 ontving OpenClaw 2026.9.9 een antwoord met deze opdracht. 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 het korte antwoord is geslaagd, vraag je het om een lokaal bestand te lezen dat je specificeert. Open vervolgens de verzoekrecords van OmniProxy en bevestig de bron en model-ID die in het record worden getoond. Uitvoer van alleen de versie-opdracht of doctor betekent niet dat de modelverbinding volledig is geconfigureerd.

Installatie

De opdracht reageert

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

Taak

Het voltooide een kleine taak

Lees bijvoorbeeld een lokaal bestand
Het antwoord 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 de versie-opdracht uitvoer produceert, moet je ook één echt antwoord ontvangen.

Veelvoorkomende fouten

Kan openclawniet vinden: Voeg de npm globale bin-map toe aan PATH en open de terminal opnieuw. Als je in een opgegeven map 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-antwoord noemt de ontwikkelaarsrol: Wanneer de adres-host niet api.openai.comis, behoud dan de standaardinstelling en stel supportsDeveloperRole niet in 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 hiervan afwijkt, gebruik dan de ID die in de lijst wordt getoond.
Het adres is niet bereikbaar: Bevestig dat OmniProxy draait, dat baseUrl eindigt op /v1en 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 OpenClaw install voor installatiestappen. Zie Custom providers en configuration fields voor aangepaste Provider-configuratie. Vergelijk 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 niet volledige agentcompatibiliteit. Controleer de bron en het model in de verzoeklog van OmniProxy.

Officiële bronnen · OpenClaw ↗