Skip to main content

​
Aktualisieren

OpenClaw entwickelt sich schnell (vor „1.0“). Behandeln Sie Updates wie den Betrieb von Infrastruktur: Update → Prüfungen ausführen → neu starten (oder openclaw update verwenden, das neu startet) → verifizieren.

​
Empfohlen: Website-Installer erneut ausführen (In‑Place‑Upgrade)

Der bevorzugte Aktualisierungspfad ist, den Installer von der Website erneut auszuführen. Er erkennt bestehende Installationen, aktualisiert sie in place und führt bei Bedarf openclaw doctor aus.
Hinweise:
  • Fügen Sie --no-onboard hinzu, wenn der Onboarding‑Assistent nicht erneut ausgeführt werden soll.
  • Für Source‑Installationen verwenden Sie:
    Der Installer wird git pull --rebase nur, wenn das Repository sauber ist.
  • Für globale Installationen verwendet das Skript unter der Haube npm install -g openclaw@latest.
  • Legacy‑Hinweis: clawdbot bleibt als Kompatibilitäts‑Shim verfügbar.

​
Vor dem Update

  • Wissen, wie Sie installiert haben: global (npm/pnpm) vs. aus dem Quellcode (git clone).
  • Wissen, wie Ihr Gateway läuft: Vordergrund‑Terminal vs. überwachter Dienst (launchd/systemd).
  • Erstellen Sie Snapshots Ihrer Anpassungen:
    • Konfiguration: ~/.openclaw/openclaw.json
    • Zugangsdaten: ~/.openclaw/credentials/
    • Arbeitsbereich: ~/.openclaw/workspace

​
Update (globale Installation)

Globale Installation (eine Option wählen):
Wir empfehlen Bun nicht für die Gateway‑Laufzeit (WhatsApp/Telegram‑Bugs). Zum Wechseln der Update‑Kanäle (git‑ und npm‑Installationen):
Verwenden Sie --tag <dist-tag|version> für ein einmaliges Installations‑Tag/eine Version. Siehe Development channels für Kanal‑Semantik und Release‑Notes. Hinweis: Bei npm‑Installationen protokolliert das Gateway beim Start einen Update‑Hinweis (prüft das aktuelle Kanal‑Tag). Deaktivieren Sie dies mit update.checkOnStart: false. Dann:
Hinweise:
  • Wenn Ihr Gateway als Dienst läuft, ist openclaw gateway restart dem Beenden von PIDs vorzuziehen.
  • Wenn Sie auf eine bestimmte Version fixiert sind, siehe unten „Rollback / Pinning“.

​
Aktualisierung (openclaw update)

Für Source‑Installationen (git checkout) bevorzugen Sie:
Es führt einen einigermaßen sicheren Update‑Ablauf aus:
  • Erfordert einen sauberen Worktree.
  • Wechselt zum ausgewählten Kanal (Tag oder Branch).
  • Fetch + Rebase gegen das konfigurierte Upstream (Dev‑Kanal).
  • Installiert Abhängigkeiten, baut, baut die Control UI und führt openclaw doctor aus.
  • Startet das Gateway standardmäßig neu (verwenden Sie --no-restart, um dies zu überspringen).
Wenn Sie über npm/pnpm installiert haben (keine git‑Metadaten), versucht openclaw update, über Ihren Paketmanager zu aktualisieren. Wenn die Installation nicht erkannt werden kann, verwenden Sie stattdessen „Update (globale Installation)“.

​
Aktualisierung (Control UI / RPC)

Die Control UI bietet Update & Restart (RPC: update.run). Das:
  1. Führt denselben Source‑Update‑Ablauf aus wie openclaw update (nur git checkout).
  2. Schreibt einen Neustart‑Sentinel mit einem strukturierten Bericht (stdout/stderr‑Tail).
  3. Startet das Gateway neu und pingt die zuletzt aktive Sitzung mit dem Bericht an.
Wenn der Rebase fehlschlägt, bricht das Gateway ab und startet neu, ohne das Update anzuwenden.

​
Update (aus dem Quellcode)

Aus dem Repo‑Checkout: Bevorzugt:
Manuell (ungefähr gleichwertig):
Hinweise:
  • pnpm build ist relevant, wenn Sie das paketierte openclaw‑Binary (openclaw.mjs) ausführen oder Node verwenden, um dist/ auszuführen.
  • Wenn Sie aus einem Repo‑Checkout ohne globale Installation laufen, verwenden Sie pnpm openclaw ... für CLI‑Befehle.
  • Wenn Sie direkt aus TypeScript (pnpm openclaw ...) ausführen, ist ein Rebuild in der Regel nicht notwendig, aber Konfigurationsmigrationen gelten weiterhin → Doctor ausführen.
  • Der Wechsel zwischen globalen und git‑Installationen ist einfach: Installieren Sie die andere Variante und führen Sie dann openclaw doctor aus, damit der Gateway‑Dienst‑Entrypoint auf die aktuelle Installation umgeschrieben wird.

​
Immer ausführen: openclaw doctor

Doctor ist der „sichere Update“-Befehl. Er ist bewusst langweilig: reparieren + migrieren + warnen. Hinweis: Wenn Sie eine Source‑Installation (git checkout) verwenden, bietet openclaw doctor an, zuerst openclaw update auszuführen. Typische Aufgaben:
  • Migration veralteter Konfigurationsschlüssel / legacy Konfigurationsdatei‑Pfade.
  • Prüfung von DM‑Richtlinien und Warnungen bei riskanten „offenen“ Einstellungen.
  • Überprüfung der Gateway‑Gesundheit und optionaler Neustart.
  • Erkennung und Migration älterer Gateway‑Dienste (launchd/systemd; legacy schtasks) zu aktuellen OpenClaw‑Diensten.
  • Unter Linux: Sicherstellen von systemd‑User‑Lingering (damit das Gateway das Logout überlebt).
Details: Doctor

​
Gateway starten / stoppen / neu starten

CLI (funktioniert unabhängig vom Betriebssystem):
Wenn Sie überwacht ausführen:
  • macOS launchd (app‑gebündelter LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (verwenden Sie bot.molt.<profile>; legacy com.openclaw.* funktioniert weiterhin)
  • 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 Dienst installiert ist; andernfalls führen Sie openclaw gateway install aus.
Runbook + exakte Service‑Labels: Gateway runbook

​
Rollback / Pinning (wenn etwas kaputtgeht)

​
Pinnen (globale Installation)

Installieren Sie eine bekannte, funktionierende Version (ersetzen Sie <version> durch die zuletzt funktionierende):
Tipp: Um die aktuell veröffentlichte Version zu sehen, führen Sie npm view openclaw version aus. Dann neu starten + Doctor erneut ausführen:

​
Pinnen (Source) nach Datum

Wählen Sie einen Commit zu einem Datum (Beispiel: „Stand von main zum 2026‑01‑01“):
Dann Abhängigkeiten neu installieren + neu starten:
Wenn Sie später wieder auf „latest“ gehen möchten:

​
Wenn Sie feststecken