OpenClaw fra null til produksjon — uten å miste en kveld til feilsøking

Demoen tok tre minutter. Din installasjon tok tre timer. Du er ikke alene — og det er ikke din skyld.

OpenClaw er et kraftig verktøy, men dokumentasjonen antar at du allerede vet hva som kan gå galt. Denne guiden gjør ikke det. Den starter med det alle egentlig trenger: hva som faktisk stopper folk, og hvordan du fikser det på første forsøk.

Grunnmuren: tre kommandoer som avslører alt

Før du installerer noe som helst, kjør dette:

• node --version
• npm --version
• git --version

Hva du trenger:

• Node 22+ — dette er ikke forhandlingsbart
• Git — installert og tilgjengelig i PATH
• Docker — kun hvis du faktisk planlegger container/sandbox-løp (de fleste trenger det ikke dag 1)

De fleste installasjonsproblemer vi ser starter med feil Node-versjon. Det gir feilmeldinger som peker helt feil sted — og du kan feilsøke i timevis uten å skjønne at grunnproblemet er tre versjoner for gammelt.

Den anbefalte veien: fungerer for 90 % av alle

Kjør det offisielle install-scriptet:

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

Deretter tre kommandoer i rekkefølge:

Dashboard åpner seg normalt i nettleseren. Hvis ikke: gå manuelt til http://127.0.0.1:18789/ på maskinen som kjører gateway.

Windows: her dør de fleste oppsett

OpenClaw-dokumentasjonen peker på WSL2 av en veldig god grunn. Native Windows-installasjon er en smertevei med uforutsigbare resultater.

Oppskriften som faktisk fungerer:

Den klassiske Windows-feilen: halvparten av setup i PowerShell, halvparten i WSL. Da funker ingen av delene.

Det er fristende å starte i PowerShell fordi det føles kjent. Motstå fristelsen. Øyeblikket du blander to miljøer får du path-konflikter, feil Node-versjoner og en gateway som starter i ett miljø og dør i det andre.

Docker: kraftig, men ikke dag 1

Docker er riktig valg når du trenger isolasjon, kjører på VPS, eller skal drifte stabilt over tid. Men for lokal førsteinstallasjon er det som regel overkill.

Hvis du likevel vil:

• Hurtigspor: ./docker-setup.sh fra repo
• Krever Docker + Compose v2

Hovedregelen: få vanlig install grønn først. Deretter vurder Docker for drift.

De fem feilene som stopper flest — og løsningene

1. openclaw: command not found

CLI er ikke i PATH, eller installasjonen stoppet halvveis. Skjer oftere enn folk tror.

Fix: Kjør installer-scriptet på nytt. Åpne ny terminal (viktig — gammel terminal har gammel PATH). Verifiser med which openclaw og openclaw --version.

2. Gateway starter ikke eller dør etter innlogging

Gammel state fra en tidligere installasjon, eller en migrering som gikk i stå.

Fix: Start med openclaw doctor. For headless/CI-miljøer: openclaw doctor --repair --yes. Restart gateway med openclaw gateway restart. Les loggene med openclaw logs --follow — de forteller nesten alltid hva som faktisk feilet.

3. Dashboard på 127.0.0.1:18789 er dødt

Enten kjører ikke gateway, porten er feil, eller daemon ble aldri korrekt satt opp under onboarding.

Fix: Sjekk openclaw gateway status. Test foreground-modus: openclaw gateway --port 18789. Kjør openclaw dashboard på nytt.

4. Oppdatering knakk noe som fungerte i går

Config og state endrer seg mellom versjoner. OpenClaw er i aktiv utvikling — dette skjer.

Fix: Oppdater via offisielt installer-script (ikke manuell git pull). Kjør openclaw doctor umiddelbart etter. Test gateway + dashboard før du skrur på automatisering.

5. Sandboxing blokkerer alt du prøver å gjøre

Policy og Docker-oppsett matcher ikke workloads ennå. Det er fordi sandboxing er det siste du skal konfigurere, ikke det første.

Fix: Start med sandbox mode off. Aktiver gradvis (non-main først). Bruk openclaw sandbox explain for å forstå nøyaktig hva som blokkerer.

Drift som ikke eksploderer etter uke to

Installasjon er dag 1. Drift er resten. Noen regler som holder ting stabilt:

• Hold ~/.openclaw privat — dette er konfig og credentials, ikke noe som hører hjemme i en delt mappe
• Minst mulige privilegier på nøkler og tokens — ikke gi admin-tilgang der viewer holder
• Ikke gi full host-tilgang hvis sandbox er nok for workloaden din
• Kjør openclaw doctor jevnlig — ikke bare når alt allerede er rødt. Preventiv vedlikehold er billigere enn brannslukking

Sjekklisten: er du faktisk operativ?

Før du erklærer deg ferdig, kjør gjennom dette:

• openclaw --version svarer med riktig versjon
• openclaw gateway status er grønn
• openclaw dashboard åpner uten feil
• En testmelding går gjennom hele pipelinen
• openclaw doctor gir grønt eller håndterbare warnings

Når denne listen er grønn, er du ikke bare installert. Du er operativ med kontroll — og det er en vesentlig forskjell.

Når alt lyser grønt har du et oppsett som tåler oppdateringer, som du kan feilsøke systematisk, og som ikke kollapser første gang noe endrer seg. Det er forskjellen mellom «det funker på maskinen min» og faktisk produksjonsklar infrastruktur.