Aktualisieren

OpenClaw entwickelt sich schnell (vor „1.0“). Updates wie Infra-Updates behandeln: aktualisieren → Checks laufen lassen → neu starten (oder openclaw update, das neu startet) → prüfen.

Empfohlen: Website-Installer erneut ausführen (Upgrade vor Ort)

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

curl -fsSL https://molt.bot/install.sh | bash

Hinweise:

• --no-onboard hinzufügen, wenn der Onboarding-Wizard nicht erneut laufen soll.
• Für Quell-Installationen:

curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git --no-onboard

Der Installer führt git pull --rebase nur aus, wenn das Repo sauber ist.

• Bei globalen Installationen nutzt das Skript unter der Haube npm install -g openclaw@latest.
• Legacy-Hinweis: openclaw bleibt als Kompatibilitäts-Shim verfügbar.

Vor dem Update

• Wissen, wie du installiert hast: global (npm/pnpm) vs. aus den Quellen (git clone).
• Wissen, wie dein Gateway läuft: Foreground-Terminal vs. überwachter Service (launchd/systemd).
• Anpassungen sichern:
  • Config: ~/.clawdbot/openclaw.json
  • Credentials: ~/.clawdbot/credentials/
  • Workspace: ~/clawd

Update (globale Installation)

Globale Installation (eines wählen):

npm i -g openclaw@latest

pnpm add -g openclaw@latest

Bun empfehlen wir nicht für die Gateway-Laufzeit (WhatsApp/Telegram-Bugs). Update-Kanäle wechseln (git- und npm-Installationen):

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

--tag <dist-tag|version> für eine einmalige Install-Tag/Version. Siehe Entwicklungs-Kanäle für Kanal-Semantik und Release-Notes. Hinweis: Bei npm-Installationen loggt das Gateway beim Start einen Update-Hinweis (prüft den aktuellen Kanal-Tag). Deaktivieren mit update.checkOnStart: false. Danach:

openclaw doctor
openclaw gateway restart
openclaw health

Hinweise:

• Wenn das Gateway als Service läuft, ist openclaw gateway restart dem manuellen Beenden von PIDs vorzuziehen.
• Wenn du auf eine bestimmte Version gepinnt bist, siehe unten „Rollback / Pinning“.

Update (openclaw update)

Bei Quell-Installationen (Git-Checkout) bevorzugt:

openclaw update

Es führt einen sicheren Update-Ablauf aus:

• Erfordert ein sauberes Worktree.
• Wechselt zum gewählten Kanal (Tag oder Branch).
• Fetcht und rebased gegen den konfigurierten Upstream (dev-Kanal).
• Installiert Deps, baut, baut die Control UI und führt openclaw doctor aus.
• Startet das Gateway standardmäßig neu (--no-restart zum Überspringen).

Bei npm/pnpm-Installation (ohne Git-Metadaten) versucht openclaw update, über den Paketmanager zu aktualisieren. Wenn die Installation nicht erkannt wird, stattdessen „Update (globale Installation)“ nutzen.

Update (Control UI / RPC)

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

1. Führt den gleichen Quell-Update-Ablauf wie openclaw update aus (nur Git-Checkout).
2. Schreibt ein Restart-Sentinel mit strukturiertem 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 neu, ohne das Update anzuwenden.

Update (aus den Quellen)

Aus dem Repo-Checkout. Bevorzugt:

openclaw update

Manuell (in etwa gleichwertig):

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

Hinweise:

• pnpm build ist relevant, wenn du die gepackte openclaw-Binary (openclaw.mjs) nutzt oder Node für dist/ verwendest.
• Wenn du aus einem Repo-Checkout ohne globale Installation läufst, nutze pnpm openclaw ... für CLI-Befehle.
• Wenn du direkt aus TypeScript läufst (pnpm openclaw ...), ist ein Rebuild meist unnötig, aber Config-Migrationen greifen trotzdem → Doctor ausführen.
• Wechsel zwischen globaler und Git-Installation ist einfach: die andere Variante installieren, dann openclaw doctor ausführen, damit der Gateway-Service-Einstieg auf die aktuelle Installation zeigt.

Immer ausführen: openclaw doctor

Doctor ist der „sichere Update“-Befehl. Absichtlich langweilig: reparieren + migrieren + warnen. Hinweis: Bei Quell-Installation (Git-Checkout) bietet openclaw doctor zuerst an, openclaw update auszuführen. Typische Aufgaben:

• Veraltete Config-Keys / alte Config-Dateipfade migrieren.
• DM-Policies prüfen und bei riskanten „open“-Einstellungen warnen.
• Gateway-Health prüfen und ggf. Neustart anbieten.
• Ältere Gateway-Services (launchd/systemd; Legacy schtasks) erkennen und auf aktuelle OpenClaw-Services migrieren.
• Unter Linux systemd-Benutzer-Lingering sicherstellen (damit das Gateway Logout überlebt).

Details: Doctor

Gateway starten / stoppen / neu starten

CLI (unabhängig vom OS):

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

Bei überwachtem Service:

• macOS launchd (App-Bundle LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (nutze bot.molt.<profile>; Legacy com.clawdbot.* funktioniert weiter)
• Linux systemd Benutzerservice: 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 openclaw gateway install ausführen.

Runbook + exakte Service-Labels: Gateway-Runbook

Rollback / Pinning (wenn etwas kaputt geht)

Pinnen (globale Installation)

Eine bekannte gute Version installieren (<version> durch die letzte funktionierende ersetzen):

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

Tipp: Aktuelle veröffentlichte Version mit npm view openclaw version anzeigen. Dann neu starten + Doctor erneut ausführen:

openclaw doctor
openclaw gateway restart

Pinnen (Quelle) nach Datum

Einen Commit zu einem Datum wählen (Beispiel: „Stand von main zum 2026-01-01“):

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

Dann Deps neu installieren + neu starten:

pnpm install
pnpm build
openclaw gateway restart

Später zurück zu latest:

git checkout main
git pull

Wenn du feststeckst

• openclaw doctor erneut ausführen und die Ausgabe genau lesen (oft steht die Lösung dort).
• Prüfen: Fehlerbehebung
• Im Discord nachfragen: https://channels.discord.gg/clawd