---
read_when:
    - Sie verschieben OpenClaw auf einen neuen Laptop oder Server
    - Sie wechseln von einem anderen Agentensystem und möchten den Zustand beibehalten
    - Sie aktualisieren ein vorhandenes Plugin direkt.
summary: 'Migrationszentrale: systemübergreifende Importe, Übertragungen zwischen Rechnern und Plugin-Upgrades'
title: Migrationsleitfaden
x-i18n:
    generated_at: "2026-07-12T01:49:18Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: c7961f78bc654d328cb91a6ef982b6e47740fd831aec9249c8ffed3225dd0ccf
    source_path: install/migrating.md
    workflow: 16
---

OpenClaw unterstützt drei Migrationspfade: den Import aus einem anderen Agentensystem, das Verschieben einer bestehenden Installation auf einen neuen Rechner und das direkte Aktualisieren eines Plugins.

## Aus einem anderen Agentensystem importieren

Mitgelieferte Migrations-Provider übernehmen Anweisungen, MCP-Server, Skills, Modellkonfigurationen und (nach ausdrücklicher Zustimmung) API-Schlüssel in OpenClaw. Pläne werden vor jeder Änderung als Vorschau angezeigt, Geheimnisse werden in Berichten unkenntlich gemacht und die Anwendung wird durch eine verifizierte Sicherung abgesichert.

<CardGroup cols={2}>
  <Card title="Migration von Claude" href="/de/install/migrating-claude" icon="brain">
    Importieren Sie den Zustand von Claude Code und Claude Desktop, einschließlich `CLAUDE.md`, MCP-Servern, Skills und Projektbefehlen.
  </Card>
  <Card title="Migration von Hermes" href="/de/install/migrating-hermes" icon="feather">
    Importieren Sie die Hermes-Konfiguration, Provider, MCP-Server, den Speicher, Skills und unterstützte `.env`-Schlüssel.
  </Card>
</CardGroup>

Der CLI-Einstiegspunkt ist [`openclaw migrate`](/de/cli/migrate). Das Onboarding kann ebenfalls eine Migration anbieten, wenn es eine bekannte Quelle erkennt (`openclaw onboard --flow import`).

## OpenClaw auf einen neuen Rechner verschieben

Kopieren Sie das **Zustandsverzeichnis** (standardmäßig `~/.openclaw/`) und Ihren **Arbeitsbereich**, um Folgendes zu erhalten:

- **Konfiguration** — `openclaw.json` und alle Gateway-Einstellungen.
- **Authentifizierung** — die agentenspezifische Datei `auth-profiles.json` (API-Schlüssel und OAuth) sowie sämtliche Kanal- oder Provider-Zustände unter `credentials/`.
- **Sitzungen** — Gesprächsverlauf und Agentenzustand.
- **Kanalzustand** — WhatsApp-Anmeldung, Telegram-Sitzung und Ähnliches.
- **Arbeitsbereichsdateien** — `MEMORY.md`, `USER.md`, Skills und Prompts.

<Tip>
Führen Sie auf dem alten Rechner `openclaw status` aus, um den Pfad Ihres Zustandsverzeichnisses zu bestätigen. Benutzerdefinierte Profile verwenden `~/.openclaw-<profile>/` oder einen über `OPENCLAW_STATE_DIR` festgelegten Pfad.
</Tip>

### Migrationsschritte

<Steps>
  <Step title="Gateway anhalten und Sicherung erstellen">
    Halten Sie auf dem **alten** Rechner das Gateway an, damit sich die Dateien während des Kopierens nicht ändern, und erstellen Sie anschließend ein Archiv:

    ```bash
    openclaw gateway stop
    cd ~
    tar -czf openclaw-state.tgz .openclaw
    ```

    Wenn Sie mehrere Profile verwenden (beispielsweise `~/.openclaw-work`), archivieren Sie jedes einzeln.

  </Step>

  <Step title="OpenClaw auf dem neuen Rechner installieren">
    [Installieren](/de/install) Sie die CLI (und bei Bedarf Node) auf dem neuen Rechner. Es ist unproblematisch, wenn das Onboarding ein neues `~/.openclaw/` erstellt — Sie überschreiben es im nächsten Schritt.
  </Step>

  <Step title="Zustandsverzeichnis und Arbeitsbereich kopieren">
    Übertragen Sie das Archiv über `scp`, `rsync -a` oder ein externes Laufwerk und entpacken Sie es anschließend:

    ```bash
    cd ~
    tar -xzf openclaw-state.tgz
    ```

    Vergewissern Sie sich, dass versteckte Verzeichnisse enthalten waren und die Dateieigentümerschaft dem Benutzer entspricht, der das Gateway ausführen wird.

  </Step>

  <Step title="Doctor ausführen und überprüfen">
    Führen Sie auf dem neuen Rechner [Doctor](/de/gateway/doctor) aus, um Konfigurationsmigrationen anzuwenden und Dienste zu reparieren:

    ```bash
    openclaw doctor
    openclaw gateway restart
    openclaw status
    ```

  </Step>
</Steps>

Wenn Telegram oder Discord den standardmäßigen Rückgriff auf Umgebungsvariablen (`TELEGRAM_BOT_TOKEN` oder `DISCORD_BOT_TOKEN`) verwendet, überprüfen Sie, ob die migrierte `.env`-Datei im Zustandsverzeichnis diese Schlüssel enthält, ohne die geheimen Werte auszugeben:

```bash
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
```

`openclaw doctor` warnt außerdem, wenn für ein aktiviertes standardmäßiges Telegram- oder Discord-Konto kein Token konfiguriert ist und die entsprechende Umgebungsvariable dem Doctor-Prozess nicht zur Verfügung steht.

### Häufige Fallstricke

<AccordionGroup>
  <Accordion title="Abweichendes Profil oder Zustandsverzeichnis">
    Wenn das alte Gateway `--profile` oder `OPENCLAW_STATE_DIR` verwendet hat und das neue nicht, erscheinen Kanäle als abgemeldet und Sitzungen sind leer. Starten Sie das Gateway mit demselben Profil oder Zustandsverzeichnis, das Sie migriert haben, und führen Sie anschließend `openclaw doctor` erneut aus.
  </Accordion>

  <Accordion title="Nur openclaw.json kopieren">
    Die Konfigurationsdatei allein reicht nicht aus. Authentifizierungsprofile für Modelle befinden sich unter `agents/<agentId>/agent/auth-profiles.json`, Kanal- und Provider-Zustände unter `credentials/`. Migrieren Sie stets das **gesamte** Zustandsverzeichnis.
  </Accordion>

  <Accordion title="Berechtigungen und Eigentümerschaft">
    Wenn Sie die Dateien als Root kopiert oder den Benutzer gewechselt haben, kann das Gateway die Zugangsdaten möglicherweise nicht lesen. Stellen Sie sicher, dass das Zustandsverzeichnis und der Arbeitsbereich dem Benutzer gehören, der das Gateway ausführt.
  </Accordion>

  <Accordion title="Remote-Modus">
    Wenn Ihre Benutzeroberfläche auf ein **entferntes** Gateway verweist, befinden sich Sitzungen und Arbeitsbereich auf dem entfernten Host. Migrieren Sie den Gateway-Host selbst, nicht Ihren lokalen Laptop. Siehe [FAQ](/de/help/faq#where-things-live-on-disk).
  </Accordion>

  <Accordion title="Geheimnisse in Sicherungen">
    Das Zustandsverzeichnis enthält Authentifizierungsprofile, Kanalzugangsdaten und weitere Provider-Zustände. Speichern Sie Sicherungen verschlüsselt, vermeiden Sie unsichere Übertragungswege und rotieren Sie Schlüssel, wenn Sie eine Offenlegung vermuten.
  </Accordion>
</AccordionGroup>

### Prüfliste zur Verifizierung

Prüfen Sie auf dem neuen Rechner Folgendes:

- [ ] `openclaw status` zeigt an, dass das Gateway ausgeführt wird.
- [ ] Die Kanäle sind weiterhin verbunden (keine erneute Kopplung erforderlich).
- [ ] Das Dashboard lässt sich öffnen und zeigt vorhandene Sitzungen an.
- [ ] Die Arbeitsbereichsdateien (Speicher, Konfigurationen) sind vorhanden.

## Ein Plugin direkt aktualisieren

Direkte Plugin-Aktualisierungen behalten dieselbe Plugin-ID und dieselben Konfigurationsschlüssel bei, können jedoch den auf dem Datenträger gespeicherten Zustand in die aktuelle Verzeichnisstruktur verschieben. Pluginspezifische Aktualisierungsanleitungen befinden sich bei den jeweiligen Kanälen:

- [Matrix-Migration](/de/channels/matrix-migration): Einschränkungen bei der Wiederherstellung des verschlüsselten Zustands, Verhalten automatischer Snapshots und Befehle zur manuellen Wiederherstellung.

## Verwandte Themen

- [`openclaw migrate`](/de/cli/migrate): CLI-Referenz für systemübergreifende Importe.
- [Installationsübersicht](/de/install): alle Installationsmethoden.
- [Doctor](/de/gateway/doctor): Systemprüfung nach der Migration.
- [Deinstallation](/de/install/uninstall): OpenClaw vollständig entfernen.