Installera OpenClaw och konfigurera OmniProxy

OpenClaw är en AI-assistent som installeras på din egen dator. Du kan prata med den direkt via Telegram, Discord, WhatsApp eller Feishu utan att behöva ha ett separat chattfönster öppet. Konversationer och loggar stannar på den här datorn, och den kan fortsätta utföra efterföljande steg lokalt.

Innan du börjar

OpenClaw kräver Node 24.16 eller senare. Du kan även använda Node 26.1 eller senare, där Node 26 rekommenderas. Node tillhandahåller den körmiljö som krävs av OpenClaw.

Den kan installeras på macOS, Linux och Windows. Om datorn inte har en lämplig version av Node kommer installationsskriptet att förbereda en automatiskt: Node 26 på macOS och Node 24 LTS på Linux. pnpm krävs endast när du bygger OpenClaw från källkod.

Om en äldre version av Node redan är installerad behöver du inte avinstallera den först. Vid testning den 2026-10-09 var systemets Node-version på denna dator 24.2.0, vilket är under det kravställda 24.16, och det icke-interaktiva installationsskriptet förberedde Node 24.21.0 automatiskt.

Vill du ha ett fönster

Skrivbordsklient

Använd Hub-installationsprogrammet på Windows
Använd GitHub DMG på macOS
Den lokala Gateway-tjänsten kan installeras under den första konfigurationen

Officiellt rekommenderat

Installationsskript

macOS Linux WSL2
Använd PowerShell på Windows
Du kan lägga till --no-onboard

Node redan installerat

Pakethanterare

npm pnpm eller bun
Kör sedan onboard
Se installationssidan för Node-versionen

Ladda ner skrivbordsklienten om du vill ha ett fönster. Om du bara vill använda den i terminalen, kör det officiella installationsskriptet.

Installera och starta för första gången

Du kan installera skrivbordsklienten med ett grafiskt fönster eller installera direkt via terminalen. Gateway är den lokala tjänst som ansvarar för att ta emot meddelanden, anropa modeller och returnera resultaten. Du kan ställa in den när du öppnar skrivbordsklienten för första gången.

Om du vill ha ett fönster

Windows: Ladda ner och kör OpenClawCompanion-Setup-x64.exe eller OpenClawCompanion-Setup-arm64.exe. Installationsprogrammet är signerat och inkluderar inställningar, status i systemfältet, chatt och nodlägen.
macOS: Ladda ner OpenClaw .dmg från OpenClaws GitHub-releaser. Föredra dmg-filen, även om du också kan använda .zip. Öppna OpenClaw.app efter installationen. Om den här versionen inte inkluderar en macOS-fil, följ sidan för macOS-appen.

När du öppnar den för första gången kan du låta OpenClaw förbereda Gateway på den här datorn eller ansluta till en befintlig fjärrstyrd Gateway.

Installera via terminalen

För macOS, Linux och WSL2, använd:

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

För Windows PowerShell, använd:

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

Skriptet identifierar det aktuella systemet, installerar Node vid behov, installerar OpenClaw och startar sedan den initiala onboarding-processen. Onboarding-flödet guidar dig genom den första konfigurationen.

Om du inte vill starta onboarding ännu, använd istället följande på macOS, Linux och WSL2:

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

På Windows, använd det officiella -NoOnboard-alternativet:

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

Om du redan hanterar Node själv kan du även använda npm, pnpm eller bun. Med npm 12 eller npm 11.16 och senare, kör:

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

För npm 11.15 och tidigare, ta bort --allow-scripts=openclaw. När du använder pnpm, lägg till --allow-build=openclaw. Se installationssidan för de exakta skillnaderna.

Efter installationen, kör dessa tre kommandon i ordning:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version visar versionen, openclaw doctor kontrollerar vanliga miljöproblem och openclaw gateway status visar om Gateway körs. Grundinstallationen är klar först när alla tre kommandon ger normal utdata.

Om terminalen rapporterar att den inte kan hitta openclaw, saknas vanligtvis npm:s globala bin-katalog i PATH. PATH är listan över platser där terminalen letar efter program. Jämför utdatan från node -v, npm prefix -g och echo "$PATH", lägg till motsvarande bin-katalog i PATH och öppna sedan terminalen igen.

Om ~/.openclaw redan innehåller en konfiguration som används för närvarande, kommer standardinstallationsskriptet att använda den katalogen. För att installera en separat kopia utan att ändra den befintliga konfigurationen, kör det icke-interaktiva skriptet och ange 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 är standardbeteendet för detta skript. Den 2026-10-09 installerade detta kommando OpenClaw 2026.9.9. Efter installationen, kör den körbara filen openclaw från katalogens bin-mapp.

Hämta anslutningsvärden från OmniProxy

Bekräfta först att OmniProxy körs, öppna sedan dess modellista och förbered följande tre värden:

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 är adressen som OpenClaw skickar modellförfrågningar till, och den måste sluta med /v1. När du ansluter till OmniProxy, använd openai-completions för api. Ändra den till openai-responses endast om modellen faktiskt fungerar via /v1/responses.

Modell-ID:t är modellens fullständiga identifierare i listan. Kopiera det exakt som det visas, inklusive eventuella snedstreck. Följande två namn är endast referenser från leverantörens dokumentation per 2026-10-09; använd dem inte om de inte visas i listan: claude-sonnet-5-5, gpt-6-luna.

Även om gatewayen inte validerar nyckeln måste apiKey fortfarande innehålla ett värde. Du kan använda en platshållarsträng som endast används på den här datorn. Skicka inte in en riktig nyckel till ett arkiv.

Ange verktygskonfigurationen

En leverantör (Provider) kan förstås som en uppsättning anslutningsinställningar som OpenClaw använder för att hitta en modelltjänst. Här heter leverantören omniproxy.

Kör följande kommando i terminalen och ersätt adressen, nyckeln och de två modell-ID:na med dina egna värden:

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

Detta kommando skriver leverantören och modellistan till konfigurationen. Du behöver inte starta om Gateway efter att kommandot har lyckats.

Ange sedan standardmodellen. Modellreferensen består av omniproxy/ följt av modell-ID:t. Bevara alla snedstreck som redan finns i ID:t. Om ID:t i modellistan är längre än det korta namnet nedan, använd det fullständiga värdet från listan:

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

reasoning, input, cost, contextWindow och maxTokens kan alla utelämnas. När de inte tillhandahålls hanteras textmodeller med standardinställningarna.

Du kan också skriva samma inställningar direkt i konfigurationsfilen. I huvudkonfigurationen finns leverantören under models.providers. Varje agent kan också ha sin egen models.json; en agent är en assistentinstans som faktiskt tar emot uppgifter och anropar modeller. Filen finns på agent/models.json inom motsvarande agentkatalog under ~/.openclaw/agents/.

Om denna models.json innehåller en icke-tom baseUrl, åsidosätter den adressen i huvudkonfigurationen.

Kontrollera installationen

Tre kommandon

openclaw --version
openclaw doctor
gateway status

Konfiguration

models.providers

baseUrl slutar med /v1
Ställ in api till completions
Ange minst modell-id

Välj

leverantör/modell

Använd denna referens för primär
Föredra en miljövariabel för nyckeln
Använd gateway-listan som källa för sanning

Bekräfta först att kommandot kan hittas, ange sedan adress och modell. Modellreferensen måste inkludera leverantörens namn.

Verifiera en verklig uppgift

Gå till en vanlig projektkatalog och skicka ett mycket kort meddelande. Ersätt modellreferensen i kommandot med ditt fullständiga modell-ID:

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

--local kör denna agentuppgift lokalt, --model anger vilken modell som ska användas för denna körning, och --timeout 300 ställer in den maximala väntetiden till 300 sekunder.

Ett faktiskt modellsvar måste visas i terminalen. Den 2026-10-09 tog OpenClaw 2026.9.9 emot ett svar med detta kommando. Det första anropet kan ta en eller två minuter.

Om det ursprungliga felet Request timed out before a response was generated visas, öka --timeout och skicka förfrågan igen. Detta betyder vanligtvis att väntetiden var otillräcklig och indikerar inte nödvändigtvis att adressen är felaktig.

När det korta svaret har lyckats, be den läsa en lokal fil som du anger. Öppna sedan OmniProxys förfrågningsloggar och bekräfta källan och modell-ID:t som visas i loggen. Utdata från endast versionskommandot eller doctor betyder inte att modellanslutningen har konfigurerats fullständigt.

Installation

Kommandot svarar

Versionsnumret visas
doctor rapporterar inga hinder
Gateway-status är läsbar

Uppgift

Den slutförde en liten uppgift

Till exempel, läs en lokal fil
Svaret är inte ett fel
Modellreferensen är korrekt

Loggar

Synliga i gatewayen

Källan är OpenClaw
Modell-ID matchar
Nyckeln lades inte till i arkivet

Efter att versionskommandot har gett utdata måste du också ta emot ett verkligt svar.

Vanliga fel

Kan inte hitta openclaw: Lägg till npm:s globala bin-katalog i PATH, öppna sedan terminalen igen. Om du installerade i en angiven katalog, kör den körbara filen från katalogens bin-mapp.
node -v är under 24.16: Du behöver inte avinstallera den gamla versionen först. Kontrollera Node-versionen som förberetts av installationsskriptet, eller använd 24.16+ eller 26.1+ enligt beskrivningen på installationssidan. Node 26 rekommenderas.
Modellen visas inte: Modellen måste inkluderas i models-arrayen under models.providers och måste åtminstone ha samma id. Att bara ställa in agents.defaults.models registrerar inte en ny modell av sig själv.
Ett 400-svar nämner utvecklarrollen: När adressens värdnamn inte är api.openai.com, behåll standardinställningen och ställ inte in supportsDeveloperRole till true. Även om det ställs in till true kommer det fortfarande att åsidosättas.
Den tar slut på tid snabbt: Öka --timeout till mer än 300 sekunder innan du ändrar adressen.
Verktygsanrop misslyckas efter val av gpt-6-luna: Den stöder Chat Completions; funktionsanrop i Chat Completions stöds endast när reasoning_effort är none. Om ID:t i listan skiljer sig från detta, använd ID:t som visas i listan.
Adressen kan inte nås: Bekräfta att OmniProxy körs, att baseUrl slutar med /v1 och att adressen som skrivits till konfigurationen är tillgänglig. Andra adresser i privata nätverk måste tillåtas separat.
Förfrågningar går fortfarande till en annan adress efter konfiguration: Kontrollera om agentens models.json innehåller en annan baseUrl.

Officiella referenser

För installationssteg, se OpenClaw install. För anpassad leverantörskonfiguration, se Custom providers och configuration fields. För modell-ID:n som används i exemplen, jämför med Claude model overview och GPT-6 Luna.

Ersätt varje platshållare med värden från din egen OmniProxy-konfiguration. Publicera aldrig en riktig nyckel.

Ett sparat resultat eller HTTP 200 ensamt bevisar inte fullständig agentkompatibilitet. Kontrollera källa och modell i OmniProxys anropslogg.

Officiella källor · OpenClaw ↗