Aktualisieren

OpenClaw entwickelt sich schnell weiter (noch vor Version “1.0”). Behandle Updates wie Infrastruktur-Deployments: aktualisieren → Checks laufen lassen → neustarten (oder openclaw update nutzen, das automatisch neustartet) → verifizieren.

Empfohlen: Website-Installer erneut ausführen (Upgrade in place)

Der bevorzugte Update-Weg ist, den Installer von der Website erneut auszuführen. Er erkennt bestehende Installationen, aktualisiert sie direkt und führt bei Bedarf openclaw doctor aus.

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

Hinweise:

  • Füge --no-onboard hinzu, wenn der Onboarding-Wizard nicht erneut starten soll.
  • Für Source-Installationen nutze: 
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
    Der Installer führt git pull --rebase nur aus, wenn das Repo sauber ist.
  • Für globale Installationen nutzt das Script intern npm install -g openclaw@latest.
  • Legacy-Hinweis: openclaw bleibt als Kompatibilitäts-Shim verfügbar.

Vor dem Update

  • Wisse, wie du installiert hast: global (npm/pnpm) vs from source (git clone).
  • Wisse, wie dein Gateway läuft: Vordergrund-Terminal vs überwachter Service (launchd/systemd).
  • Sichere deine Anpassungen:
    • Config: ~/.openclaw/openclaw.json
    • Credentials: ~/.openclaw/credentials/
    • Workspace: ~/.openclaw/workspace

Update (globale Installation)

Globale Installation (wähle eine Option):

npm i -g openclaw@latest
pnpm add -g openclaw@latest

Wir empfehlen Bun nicht für die Gateway-Runtime (WhatsApp/Telegram-Bugs).

Um Update-Channels zu wechseln (git + npm Installationen):

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

Nutze --tag <dist-tag|version> für eine einmalige Installation eines bestimmten Tags/Version.

Siehe Development Channels für Channel-Semantik und Release Notes.

Hinweis: Bei npm-Installationen zeigt das Gateway beim Start einen Update-Hinweis (prüft den aktuellen Channel-Tag). Deaktivieren mit update.checkOnStart: false.

Dann:

openclaw doctor
openclaw gateway restart
openclaw health

Hinweise:

  • Wenn dein Gateway als Service läuft, ist openclaw gateway restart besser als PIDs zu killen.
  • Wenn du auf eine bestimmte Version gepinnt bist, siehe “Rollback / Pinning” weiter unten.

Update (openclaw update)

Für Source-Installationen (git checkout) bevorzuge:

openclaw update

Es führt einen sicheren Update-Flow aus:

  • Erfordert einen sauberen Worktree.
  • Wechselt zum ausgewählten Channel (Tag oder Branch).
  • Fetcht + rebaset gegen den konfigurierten Upstream (dev Channel).
  • Installiert Dependencies, baut, baut die Control UI und führt openclaw doctor aus.
  • Startet das Gateway standardmäßig neu (nutze --no-restart zum Überspringen).

Wenn du via npm/pnpm installiert hast (keine git-Metadaten), versucht openclaw update über deinen Package Manager zu aktualisieren. Wenn es die Installation nicht erkennen kann, nutze stattdessen “Update (globale Installation)”.

Update (Control UI / RPC)

Die Control UI hat Update & Restart (RPC: update.run). Es:

  1. Führt denselben Source-Update-Flow wie openclaw update aus (nur git checkout).
  2. Schreibt einen Restart-Sentinel mit einem strukturierten Report (stdout/stderr tail).
  3. Startet das Gateway neu und pingt die letzte aktive Session mit dem Report.

Wenn der Rebase fehlschlägt, bricht das Gateway ab und startet ohne das Update anzuwenden neu.

Update (from source)

Vom Repo-Checkout aus:

Bevorzugt:

openclaw update

Manuell (ungefähr äquivalent):

git pull
pnpm install
pnpm build
pnpm ui:build # installiert UI-Dependencies automatisch beim ersten Lauf
openclaw doctor
openclaw health

Hinweise:

  • pnpm build ist wichtig, wenn du die gepackte openclaw-Binary (openclaw.mjs) ausführst oder Node nutzt, um dist/ zu starten.
  • Wenn du von einem Repo-Checkout ohne globale Installation arbeitest, nutze pnpm openclaw ... für CLI-Befehle.
  • Wenn du direkt von TypeScript aus arbeitest (pnpm openclaw ...), ist ein Rebuild meist nicht nötig, aber Config-Migrationen gelten trotzdem → führe doctor aus.
  • Zwischen globaler und git-Installation zu wechseln ist einfach: installiere die andere Variante, dann führe openclaw doctor aus, damit der Gateway-Service-Entrypoint auf die aktuelle Installation umgeschrieben wird.

Immer ausführen: openclaw doctor

Doctor ist der “sichere Update”-Befehl. Er ist absichtlich langweilig: reparieren + migrieren + warnen.

Hinweis: Bei einer Source-Installation (git checkout) bietet openclaw doctor an, zuerst openclaw update auszuführen.

Typische Aufgaben:

  • Migriert veraltete Config-Keys / Legacy-Config-Dateipfade.
  • Prüft DM-Policies und warnt bei riskanten “offenen” Einstellungen.
  • Checkt Gateway-Health und kann einen Neustart anbieten.
  • Erkennt und migriert ältere Gateway-Services (launchd/systemd; legacy schtasks) zu aktuellen OpenClaw-Services.
  • Auf Linux stellt es systemd User Lingering sicher (damit das Gateway nach dem Logout weiterläuft).

Details: Doctor

Gateway starten / stoppen / neustarten

CLI (funktioniert unabhängig vom OS):

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

Bei überwachten Services:

  • macOS launchd (app-gebündelter LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (nutze bot.molt.<profile>; legacy com.openclaw.* funktioniert noch)
  • Linux systemd User Service: systemctl --user restart openclaw-gateway[-<profile>].service
  • Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
    • launchctl/systemctl funktionieren nur, wenn der Service installiert ist; sonst führe openclaw gateway install aus.

Runbook + genaue Service-Labels: Gateway Runbook

Rollback / Pinning (wenn etwas kaputtgeht)

Pin (globale Installation)

Installiere eine bekannt funktionierende Version (ersetze <version> mit der letzten funktionierenden):

npm i -g openclaw@<version>
pnpm add -g openclaw@<version>

Tipp: Um die aktuell veröffentlichte Version zu sehen, führe npm view openclaw version aus.

Dann neustarten + doctor erneut ausführen:

openclaw doctor
openclaw gateway restart

Pin (source) nach Datum

Wähle einen Commit von einem bestimmten Datum (Beispiel: “Stand von main am 01.01.2026”):

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"

Dann Dependencies neu installieren + neustarten:

pnpm install
pnpm build
openclaw gateway restart

Wenn du später wieder auf den neuesten Stand willst:

git checkout main
git pull

Wenn du nicht weiterkommst