Installation af OpenClaw og konfiguration af OmniProxy

OpenClaw er en AI-assistent installeret på din egen computer. Du kan tale direkte med den via Telegram, Discord, WhatsApp eller Feishu uden at skulle holde et andet chatvindue åbent. Samtaler og optegnelser forbliver på denne computer, og den kan fortsætte med at udføre efterfølgende trin lokalt.

Før du starter

OpenClaw kræver Node 24.16 eller nyere. Du kan også bruge Node 26.1 eller nyere, hvor Node 26 anbefales. Node leverer det runtime-miljø, som OpenClaw kræver.

Det kan installeres på macOS, Linux og Windows. Hvis computeren ikke har en passende version af Node, vil installationsscriptet automatisk forberede en: Node 26 på macOS og Node 24 LTS på Linux. pnpm kræves kun, når man bygger OpenClaw fra kildekode.

Hvis en ældre version af Node allerede er installeret, behøver du ikke at afinstallere den først. Under test den 2026-10-09 var systemets Node-version på denne computer 24.2.0, under de påkrævede 24.16, og det ikke-interaktive installationsscript forberedte Node 24.21.0 automatisk.

Vil du have et vindue

Desktop-ledsager

• Brug Hub-installationsprogrammet på Windows
• Brug GitHub DMG på macOS
• Den lokale Gateway kan installeres under den første opsætning

Officielt anbefalet

Installationsscript

• macOS Linux WSL2
• Brug PowerShell på Windows
• Du kan tilføje --no-onboard

Node allerede installeret

Pakkehåndtering

• npm pnpm eller bun
• Kør derefter onboard
• Se installationssiden for Node-versionen

Installation og første opstart

Du kan installere desktop-ledsageren med et grafisk vindue eller installere direkte via terminalen. Gateway er den lokale tjeneste, der er ansvarlig for at modtage beskeder, kalde modeller og returnere resultaterne. Du kan konfigurere den, når du åbner desktop-ledsageren for første gang.

Hvis du vil have et vindue

• Windows: Download og kør OpenClawCompanion-Setup-x64.exe eller OpenClawCompanion-Setup-arm64.exe. Installationsprogrammet er signeret og inkluderer indstillinger, bakke-status, chat og node-tilstande.
• macOS: Download OpenClaw .dmg fra OpenClaw’s GitHub-udgivelser. Foretræk dmg, selvom du også kan bruge .zip. Åbn OpenClaw.app efter installationen. Hvis denne version ikke inkluderer en macOS-fil, skal du følge siden for macOS-apps.

Når du åbner den første gang, kan du lade OpenClaw forberede Gateway på denne computer eller oprette forbindelse til en eksisterende fjern-Gateway.

Installer via terminalen

For macOS, Linux og WSL2, brug:

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

For Windows PowerShell, brug:

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

Scriptet registrerer det aktuelle system, installerer Node, når det er nødvendigt, installerer OpenClaw og starter derefter den indledende onboarding-proces. Onboarding-flowet guider dig gennem den første opsætning.

Hvis du ikke vil starte onboarding endnu, skal du i stedet bruge følgende på macOS, Linux og WSL2:

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

På Windows, brug den officielle -NoOnboard mulighed:

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

Hvis du allerede selv administrerer Node, kan du også bruge npm, pnpm eller bun. Med npm 12 eller npm 11.16 og nyere, kø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 bruger pnpm, tilføj --allow-build=openclaw. Se installationssiden for de nøjagtige forskelle.

Efter installationen skal du køre disse tre kommandoer i rækkefølge:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version viser versionen, openclaw doctor tjekker for almindelige miljøproblemer, og openclaw gateway status viser, om Gateway kører. Den grundlæggende installation er først fuldført, når alle tre kommandoer producerer normal output.

Hvis terminalen rapporterer, at den ikke kan finde openclaw, mangler npm’s globale bin-mappe normalt fra PATH. PATH er listen over placeringer, hvor terminalen leder efter programmer. Sammenlign outputtet af node -v, npm prefix -g, og echo "$PATH", tilføj den tilsvarende bin-mappe til PATH, og genåbn derefter terminalen.

Hvis ~/.openclaw allerede indeholder en konfiguration, der er i brug, vil standardinstallationsscriptet bruge den mappe. For at installere en separat kopi uden at ændre den eksisterende konfiguration, skal du køre det ikke-interaktive script og angive en ny mappe:

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

--no-onboard er standardadfærden for dette script. Den 2026-10-09 installerede denne kommando OpenClaw 2026.9.9. Efter installationen skal du køre openclaw eksekverbare fil fra mappens bin mappe.

Hent forbindelsesværdier fra OmniProxy

Bekræft først, at OmniProxy kører, åbn derefter dens modelliste og forbered følgende tre værdier:

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 modelanmodninger til, og den skal slutte med /v1. Når du opretter forbindelse til OmniProxy, skal du bruge openai-completions for api. Skift den til openai-responses kun hvis modellen faktisk fungerer gennem /v1/responses.

Model-ID’et er modellens fuldstændige identifikator på listen. Kopier det nøjagtigt som vist, inklusive eventuelle skråstreger. Følgende to navne er kun referencer fra udbyderdokumentationen pr. 2026-10-09; brug dem ikke, hvis de ikke optræder på listen: claude-sonnet-5-5, gpt-6-luna.

Selvom gatewayen ikke validerer nøglen, apiKey skal stadig indeholde en værdi. Du kan bruge en pladsholderstreng, der kun bruges på denne computer. Commit ikke en rigtig nøgle til et depot.

Indtast værktøjskonfigurationen

En udbyder kan forstås som et sæt forbindelsesindstillinger, som OpenClaw bruger til at finde en modeltjeneste. Her er udbyderen navngivet omniproxy.

Kør følgende kommando i terminalen, og erstat adressen, nøglen og to model-ID’er med dine egne værdier:

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 kommando skriver udbyderen og modellisten til konfigurationen. Du behøver ikke at genstarte Gateway, efter at kommandoen er lykkedes.

Angiv derefter standardmodellen. Modelreferencen består af omniproxy/ efterfulgt af model-ID’et. Bevar hver skråstreg, der allerede findes i ID’et. Hvis ID’et på modellisten er længere end det korte navn nedenfor, skal du bruge den fuldstændige værdi fra listen:

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

reasoning, input, cost, contextWindow, og maxTokens kan alle udelades. Når de ikke er angivet, håndteres tekstmodeller ved hjælp af standardindstillingerne.

Du kan også skrive de samme indstillinger direkte ind i konfigurationsfilen. I hovedkonfigurationen er udbyderen placeret under models.providers. Hver agent kan også have sin egen models.json; en agent er en assistentinstans, der faktisk modtager opgaver og kalder modeller. Filen er placeret ved agent/models.json inden for den tilsvarende agentmappe under ~/.openclaw/agents/.

Hvis denne models.json indeholder en ikke-tom baseUrl, tilsidesætter den adressen i hovedkonfigurationen.

Tjek installation

Tre kommandoer

• openclaw --version
• openclaw doctor
• gateway status

Konfiguration

models.providers

• baseUrl slutter med /v1
• Indstil api til completions
• Angiv mindst model-id'et

Vælg

provider/model

• Brug denne reference til primær
• Foretræk en miljøvariabel til nøglen
• Brug gateway-listen som kilde til sandhed

Bekræft en rigtig opgave

Gå ind i en almindelig projektmappe og send en meget kort besked. Erstat modelreferencen i kommandoen med dit fuldstændige model-ID:

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

--local kører denne agentopgave lokalt, --model angiver den model, der skal bruges til denne kørsel, og --timeout 300 indstiller den maksimale ventetid til 300 sekunder.

Et faktisk modelsvar skal vises i terminalen. Den 2026-10-09 modtog OpenClaw 2026.9.9 et svar ved hjælp af denne kommando. Det første opkald kan tage et eller to minutter.

Hvis den oprindelige fejl Request timed out before a response was generated vises, skal du øge --timeout og sende anmodningen igen. Dette betyder normalt, at ventetiden var utilstrækkelig og indikerer ikke nødvendigvis, at adressen er forkert.

Når det korte svar lykkes, skal du bede den om at læse en lokal fil, som du angiver. Åbn derefter OmniProxy’s anmodningsoptegnelser og bekræft kilden og model-ID’et, der vises i optegnelsen. Output fra kun versionskommandoen eller doctor betyder ikke, at model-forbindelsen er blevet fuldt konfigureret.

Installation

Kommandoen svarer

• Versionsnummeret vises
• doctor rapporterer ingen blokeringer
• Gateway-status er læsbar

Opgave

Den fuldførte en lille opgave

• For eksempel, læs en lokal fil
• Svaret er ikke en fejl
• Modelreferencen er korrekt

Logfiler

Synlig i gatewayen

• Kilden er OpenClaw
• Model-ID matcher
• Nøglen blev ikke tilføjet til depotet

Almindelige fejl

• Kan ikke finde openclaw: Tilføj npm’s globale bin-mappe til PATH, og genåbn derefter terminalen. Hvis du installerede til en angivet mappe, skal du køre den eksekverbare fil fra mappens bin mappe.
• node -v er under 24.16: Du behøver ikke at afinstallere den gamle version først. Tjek Node-versionen forberedt af installationsscriptet, eller brug 24.16+ eller 26.1+ som beskrevet på installationssiden. Node 26 anbefales.
• Modellen vises ikke: Modellen skal inkluderes i models arrayet under models.providers og skal mindst have samme id. Indstilling af kun agents.defaults.models registrerer ikke en ny model i sig selv.
• Et 400-svar nævner udviklerrollen: Når adressens vært ikke er api.openai.com, behold standarden og indstil ikke supportsDeveloperRole til true. Selvom den er indstillet til true, vil den stadig blive tilsidesat.
• Den timer hurtigt ud: Øg --timeout til mere end 300 sekunder, før du ændrer adressen.
• Værktøjsopkald mislykkes efter valg af gpt-6-luna: Den understøtter Chat Completions; funktionskald i Chat Completions understøttes kun, når reasoning_effort er none. Hvis ID’et på listen adskiller sig fra dette, skal du bruge ID’et vist på listen.
• Adressen kan ikke nås: Bekræft, at OmniProxy kører, at baseUrl slutter med /v1, og at adressen, der er skrevet til konfigurationen, er tilgængelig. Andre private netværksadresser skal tillades separat.
• Anmodninger går stadig til en anden adresse efter konfiguration: Tjek om agentens models.json indeholder en anden baseUrl.

Officielle referencer

For installationstrin, se OpenClaw install. For tilpasset udbyderkonfiguration, se Brugerdefinerede udbydere og konfigurationsfelter. For model-ID’erne brugt i eksemplerne, sammenlign med Claude modeloversigt og GPT-6 Luna.

Erstat alle pladsholdere med værdier fra din egen OmniProxy-konfiguration. Publicér aldrig en rigtig nøgle.

Et gemt resultat eller HTTP 200 alene beviser ikke fuld agentkompatibilitet. Tjek kilden og modellen i OmniProxys anmodningspost.

Officielle kilder · OpenClaw ↗