Installere OpenClaw og konfigurere OmniProxy

OpenClaw er en AI-assistent som installeres på din egen datamaskin. Du kan snakke direkte med den via Telegram, Discord, WhatsApp eller Feishu uten å måtte holde et eget chat-vindu åpent. Samtaler og logger forblir på denne datamaskinen, og den kan fortsette å utføre påfølgende trinn lokalt.

Før du starter

OpenClaw krever Node 24.16 eller nyere. Du kan også bruke Node 26.1 eller nyere, hvor Node 26 anbefales. Node leverer kjøretidsmiljøet som OpenClaw trenger.

Den kan installeres på macOS, Linux og Windows. Hvis datamaskinen ikke har en passende versjon av Node, vil installasjonsskriptet klargjøre en automatisk: Node 26 på macOS og Node 24 LTS på Linux. pnpm er kun påkrevd hvis du bygger OpenClaw fra kildekode.

Hvis en eldre versjon av Node allerede er installert, trenger du ikke å avinstallere den først. Under testing 2026-10-09 var systemets Node-versjon på denne datamaskinen 24.2.0, som er under kravet på 24.16, og det ikke-interaktive installasjonsskriptet klargjorde Node 24.21.0 automatisk.

Vil du ha et vindu

Skrivebordsfølge

• Bruk Hub-installasjonsprogrammet på Windows
• Bruk GitHub DMG på macOS
• Den lokale Gateway-en kan installeres under førstegangsoppsettet

Offisielt anbefalt

Installasjonsskript

• macOS Linux WSL2
• Bruk PowerShell på Windows
• Du kan legge til --no-onboard

Node er allerede installert

Pakkebehandler

• npm pnpm eller bun
• Kjør deretter onboard
• Se installasjonssiden for Node-versjon

Installer og start for første gang

Du kan installere skrivebordsfølget med et grafisk vindu, eller installere direkte via terminalen. Gateway er den lokale tjenesten som er ansvarlig for å motta meldinger, kalle opp modeller og returnere resultater. Du kan sette den opp når du åpner skrivebordsfølget for første gang.

Hvis du vil ha et vindu

• Windows: Last ned og kjør OpenClawCompanion-Setup-x64.exe eller OpenClawCompanion-Setup-arm64.exe. Installasjonsprogrammet er signert og inkluderer innstillinger, status i systemkurv, chat og node-moduser.
• macOS: Last ned OpenClaw .dmg fra OpenClaws GitHub-utgivelser. Foretrekk dmg-filen, selv om du også kan bruke .zip. Åpne OpenClaw.app etter installasjon. Hvis denne versjonen ikke inkluderer en macOS-fil, følg siden for macOS-appen.

Når du åpner den for første gang, kan du la OpenClaw klargjøre Gateway på denne datamaskinen eller koble til en eksisterende ekstern Gateway.

Installer via terminalen

For macOS, Linux og WSL2, bruk:

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

For Windows PowerShell, bruk:

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

Skriptet oppdager gjeldende system, installerer Node ved behov, installerer OpenClaw og starter deretter den innledende onboarding-prosessen. Onboarding-flyten veileder deg gjennom førstegangsoppsettet.

Hvis du ikke vil starte onboarding ennå, bruk følgende i stedet på macOS, Linux og WSL2:

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

På Windows, bruk det offisielle -NoOnboard alternativet:

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

Hvis du allerede administrerer Node selv, kan du også bruke npm, pnpm eller bun. Med npm 12 eller npm 11.16 og nyere, kjør:

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

For npm 11.15 og tidligere, fjern --allow-scripts=openclaw. Når du bruker pnpm, legg til --allow-build=openclaw. Se installasjonssiden for nøyaktige forskjeller.

Etter installasjon, kjør disse tre kommandoene i rekkefølge:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version viser versjonen, openclaw doctor sjekker for vanlige miljøproblemer, og openclaw gateway status viser om Gateway kjører. Grunninstallasjonen er fullført først når alle tre kommandoene gir normal utdata.

Hvis terminalen rapporterer at den ikke finner openclaw, mangler vanligvis npm sin globale bin-katalog fra PATH. PATH er listen over steder hvor terminalen ser etter programmer. Sammenlign utdata fra node -v, npm prefix -g, og echo "$PATH", legg til den tilsvarende bin-katalogen i PATH, og åpne deretter terminalen på nytt.

Hvis ~/.openclaw allerede inneholder en konfigurasjon som er i bruk, vil standard installasjonsskript bruke den katalogen. For å installere en separat kopi uten å endre den eksisterende konfigurasjonen, kjør det ikke-interaktive skriptet og spesifiser en ny katalog:

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

--no-onboard er standardoppførselen til dette skriptet. Den 2026-10-09 installerte denne kommandoen OpenClaw 2026.9.9. Etter installasjon, kjør openclaw kjørbar fil fra katalogen sin bin mappe.

Hent tilkoblingsverdier fra OmniProxy

Bekreft først at OmniProxy kjører, åpne deretter modellisten og klargjør følgende tre verdier:

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 er adressen som OpenClaw sender modellforespørsler til, og den må slutte med /v1. Når du kobler til OmniProxy, bruk openai-completions for api. Endre den til openai-responses kun hvis modellen faktisk fungerer gjennom /v1/responses.

Modell-ID-en er modellens fullstendige identifikator i listen. Kopier den nøyaktig slik den vises, inkludert eventuelle skråstreker. De følgende to navnene er kun referanser fra leverandørdokumentasjon per 2026-10-09; ikke bruk dem hvis de ikke vises i listen: claude-sonnet-5-5, gpt-6-luna.

Selv om gatewayen ikke validerer nøkkelen, apiKey må fortsatt inneholde en verdi. Du kan bruke en plassholderstreng som kun brukes på denne datamaskinen. Ikke legg inn en ekte nøkkel i et depot.

Angi verktøykonfigurasjonen

En leverandør (Provider) kan forstås som et sett med tilkoblingsinnstillinger som OpenClaw bruker for å finne en modelltjeneste. Her er leverandøren navngitt omniproxy.

Kjør følgende kommando i terminalen, og erstatt adressen, nøkkelen og de to modell-ID-ene med dine egne verdier:

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

Denne kommandoen skriver leverandøren og modellisten til konfigurasjonen. Du trenger ikke å starte Gateway på nytt etter at kommandoen er fullført.

Deretter spesifiserer du standardmodellen. Modellreferansen består av omniproxy/ etterfulgt av modell-ID-en. Behold alle skråstreker som allerede finnes i ID-en. Hvis ID-en i modellisten er lengre enn det korte navnet nedenfor, bruk den fullstendige verdien fra listen:

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

reasoning, input, cost, contextWindow, og maxTokens kan alle utelates. Når de ikke er oppgitt, håndteres tekstmodeller ved bruk av standardinnstillinger.

Du kan også skrive de samme innstillingene direkte inn i konfigurasjonsfilen. I hovedkonfigurasjonen er leverandøren plassert under models.providers. Hver agent kan også ha sin egen models.json; en agent er en assistentinstans som faktisk mottar oppgaver og kaller opp modeller. Filen er plassert i agent/models.json innenfor den tilsvarende agentkatalogen under ~/.openclaw/agents/.

Hvis denne models.json inneholder en ikke-tom baseUrl, overstyrer den adressen i hovedkonfigurasjonen.

Sjekk installasjon

Tre kommandoer

• openclaw --version
• openclaw doctor
• gateway status

Konfigurasjon

models.providers

• baseUrl slutter med /v1
• Sett api til completions
• Spesifiser minst modell-id

Velg

provider/model

• Bruk denne referansen for primær
• Foretrekk en miljøvariabel for nøkkelen
• Bruk gateway-listen som kilde til sannhet

Bekreft en ekte oppgave

Gå inn i en vanlig prosjektkatalog og send en veldig kort melding. Erstatt modellreferansen i kommandoen med din fullstendige modell-ID:

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

--local kjører denne agentoppgaven lokalt, --model spesifiserer modellen som skal brukes for denne kjøringen, og --timeout 300 setter maksimal ventetid til 300 sekunder.

Et faktisk modellsvar må vises i terminalen. Den 2026-10-09 mottok OpenClaw 2026.9.9 et svar ved bruk av denne kommandoen. Det første kallet kan ta ett eller to minutter.

Hvis den opprinnelige feilen Request timed out before a response was generated vises, øk --timeout og send forespørselen på nytt. Dette betyr vanligvis at ventetiden var utilstrekkelig og indikerer ikke nødvendigvis at adressen er feil.

Etter at det korte svaret er vellykket, be den lese en lokal fil som du spesifiserer. Åpne deretter OmniProxys forespørselslogger og bekreft kilden og modell-ID-en som vises i loggen. Utdata fra kun versjonskommandoen eller doctor betyr ikke at modelltilkoblingen er ferdig konfigurert.

Installasjon

Kommandoen svarer

• Versjonsnummeret vises
• doctor rapporterer ingen blokkeringer
• Gateway-status er lesbar

Oppgave

Den fullførte en liten oppgave

• For eksempel, les en lokal fil
• Svaret er ikke en feil
• Modellreferansen er korrekt

Logger

Synlig i gatewayen

• Kilden er OpenClaw
• Modell-ID samsvarer
• Nøkkelen ble ikke lagt til i depotet

Vanlige feil

• Kan ikke finne openclaw: Legg til npm sin globale bin-katalog i PATH, og åpne deretter terminalen på nytt. Hvis du installerte i en spesifisert katalog, kjør den kjørbare filen fra den katalogen sin bin mappe.
• node -v er under 24.16: Du trenger ikke å avinstallere den gamle versjonen først. Sjekk Node-versjonen som er klargjort av installasjonsskriptet, eller bruk 24.16+ eller 26.1+ som beskrevet på installasjonssiden. Node 26 anbefales.
• Modellen vises ikke: Modellen må være inkludert i models matrisen under models.providers og må minst ha samme id. Å sette kun agents.defaults.models registrerer ikke en ny modell av seg selv.
• Et 400-svar nevner utviklerrollen: Når adresseverten ikke er api.openai.com, behold standardinnstillingen og ikke sett supportsDeveloperRole til true. Selv om den er satt til true, vil den fortsatt bli overstyrt.
• Den tidsavbrytes raskt: Øk --timeout til mer enn 300 sekunder før du endrer adressen.
• Verktøykall feiler etter valg av gpt-6-luna: Den støtter Chat Completions; funksjonskall i Chat Completions støttes kun når reasoning_effort er none. Hvis ID-en i listen avviker fra denne, bruk ID-en som vises i listen.
• Adressen kan ikke nås: Bekreft at OmniProxy kjører, at baseUrl slutter med /v1, og at adressen som er skrevet til konfigurasjonen er tilgjengelig. Andre adresser i private nettverk må tillates separat.
• Forespørsler går fortsatt til en annen adresse etter konfigurasjon: Sjekk om agentens models.json inneholder en annen baseUrl.

Offisielle referanser

For installasjonstrinn, se OpenClaw install. For tilpasset leverandørkonfigurasjon, se Custom providers og configuration fields. For modell-ID-ene som brukes i eksemplene, sammenlign med Claude model overview og GPT-6 Luna.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · OpenClaw ↗