> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# NovitaClaw

Stellen Sie mit einem einzigen Befehl einen persistenten OpenClaw-Agenten in der [Novita Agent Sandbox](https://novita.ai/sandbox) bereit und verwalten Sie ihn anschließend über CLI, Web UI oder Automatisierungsskripte. Keine Sitzungsbegrenzung — Ihre Instanz läuft 24/7 so lange, wie Sie sie benötigen.

## Was ist neu in v1.6.0

* **Gateway-Konfiguration exportieren / importieren** — Sichern, wiederherstellen und migrieren Sie Ihre OpenClaw-Konfiguration über Sandboxes hinweg. Export nach stdout oder in eine Datei, Import mit automatischer JSON-Validierung und Gateway-Neustart. Unterstützt Workflows zur Migration zwischen Sandboxes.

```bash Bash icon="terminal" theme={"system"}
# Export config
novitaclaw gateway config export <sandbox_id> -o config.json
# Import into another sandbox
novitaclaw gateway config import <target_id> config.json
```

* **ClawHub-Skill-Installation** — Installieren Sie OpenClaw-Erweiterungsskills aus ClawHub direkt in eine Sandbox. Skills sind sofort verfügbar, ohne dass ein Gateway-Neustart erforderlich ist.

```bash Bash icon="terminal" theme={"system"}
novitaclaw skill install <sandbox_id> sonoscli
```

### Frühere Releases

* **Telegram-Kanal (CLI)** — Polling- und Webhook-Modi zum Verbinden Ihres Agenten mit Telegram. [Einrichtungsanleitung](/docs/de/guides/novitaclaw-configuration#telegram)
* **Slack-Kanal** — Socket- und HTTP-Modi zum Verbinden Ihres Agenten mit Slack. [Einrichtungsanleitung](/docs/de/guides/novitaclaw-configuration#slack)
* **Verbesserungen am Installationsskript** — Installationsverzeichnis geändert zu `~/.novitaclaw-cli`, verbesserter `update`-Befehl mit PEP 668-Unterstützung und Symlink-Wiederherstellung
* **On-Demand-Modus** — Sandbox pausiert nach Inaktivität automatisch und wird bei Zugriff fortgesetzt. Keine Abrechnung während der Pause. [Mehr erfahren](/docs/de/guides/novitaclaw-configuration#on-demand-mode)
* **Feishu-Kanal** — Verbinden Sie Ihren Agenten über Webhook- oder Event-Modus mit Feishu (Lark). [Einrichtungsanleitung](/docs/de/guides/novitaclaw-configuration#feishu)
* **Web Terminal** — Browserbasierter Terminalzugriff auf Ihre Sandbox, kein SSH erforderlich
* **File Manager** — Workspace-Dateien direkt im Browser durchsuchen und verwalten
* **systemd-Dienstverwaltung** — Gateway, Web Terminal und File Manager werden vollständig von systemd verwaltet, mit automatischem Neustart bei Fehlern
* **Automatische Crash-Wiederherstellung** — Automatische Diagnose, Reparatur und Dienstwiederherstellung bei wiederholten Abstürzen
* **Automatische Config-Sicherung** — Jeder Schreibvorgang an der Konfiguration erstellt automatisch ein Backup; die Crash-Wiederherstellung stellt die letzte bekanntermaßen funktionsfähige Sicherung wieder her

<Tip>
  Um die neuen Funktionen zu verwenden, aktualisieren Sie bitte Ihre CLI:

  ```bash macOS / Linux theme={"system"}
  curl -fsSL https://novitaclaw.novita.ai/install.sh | bash
  ```

  ```bash Windows (PowerShell) theme={"system"}
  irm https://novitaclaw.novita.ai/install.ps1 | iex
  ```
</Tip>

## Erste Schritte

### Voraussetzungen

* Python installiert
* Ein Novita-API-Schlüssel (erstellen Sie/manage Schlüssel in der [Schlüsselverwaltung](https://novita.ai/docs/guides/quickstart#2-manage-api-key))

<Accordion title="So installieren Sie Python">
  **Windows**

  [Laden Sie den Python-Installer herunter](https://www.python.org/downloads/) und führen Sie ihn aus. **Aktivieren Sie „Add Python to PATH“**, bevor Sie auf Install Now klicken — das Überspringen dieses Schritts ist der häufigste Grund, warum Anfänger später auf Fehler stoßen.

  **macOS**

  Öffnen Sie Terminal und führen Sie Folgendes aus:

  ```bash Bash icon="terminal" theme={"system"}
  python3 --version
  ```

  Wenn Sie Python 3.10 oder höher sehen, ist alles bereit. Wenn Terminal Sie auffordert, Command Line Developer Tools zu installieren, klicken Sie auf Install und warten Sie ein paar Minuten.

  **Linux (Ubuntu / Debian)**

  ```bash Bash icon="terminal" theme={"system"}
  sudo apt update && sudo apt install python3 python3-pip -y
  ```
</Accordion>

### Schritt 1: NovitaClaw installieren

<CodeGroup>
  ```bash macOS / Linux theme={"system"}
  sudo pip3 install novitaclaw
  ```

  ```bash Windows PowerShell theme={"system"}
  pip install novitaclaw
  ```
</CodeGroup>

Überprüfen Sie die Installation anschließend, indem Sie `novitaclaw --help` ausführen. Wenn Sie eine Liste von Befehlen sehen, ist alles eingerichtet.

<Warning>
  **Mac-Benutzer:** Wenn Sie nach der Installation `zsh: command not found: novitaclaw` erhalten, führen Sie Folgendes aus:

  ```bash Bash icon="terminal" theme={"system"}
  echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```
</Warning>

### Schritt 2: Ihren API-Schlüssel festlegen

<CodeGroup>
  ```bash macOS / Linux theme={"system"}
  export NOVITA_API_KEY=sk_your_api_key
  ```

  ```powershell Windows PowerShell theme={"system"}
  $env:NOVITA_API_KEY = "sk_your_api_key"
  ```
</CodeGroup>

### Schritt 3: Ihre Instanz starten

```bash Bash icon="terminal" theme={"system"}
novitaclaw launch
```

Bei Erfolg gibt die CLI Folgendes zurück:

* **Web UI URL** — Mit Ihrem Agenten chatten
* **Gateway WebSocket URL & Token** — Für programmatischen Zugriff
* **Web Terminal URL** — Terminalzugriff auf die Sandbox in Ihrem Browser
* **File Manager URL** — Workspace-Dateien durchsuchen und verwalten
* **Anmeldedaten** — Benutzername und Passwort für Web Terminal & File Manager

<Frame>
  <img src="https://mintcdn.com/novitaai/QcGDqn4gh3xIo9UN/de/guides/images/openclaw-cli/launch-result.png?fit=max&auto=format&n=QcGDqn4gh3xIo9UN&q=85&s=3590510a9bc3809c87b636ad3b3c66cb" alt="NovitaClaw-Startresultat" width="1486" height="289" data-path="de/guides/images/openclaw-cli/launch-result.png" />
</Frame>

Öffnen Sie die zurückgegebene **Web UI URL** und wechseln Sie zur Registerkarte `Chat`, um Ihren Agenten zu verwenden.

### Web Terminal

Das Web Terminal bietet browserbasierten Terminalzugriff auf Ihre Sandbox-Umgebung. Öffnen Sie die vom Startbefehl zurückgegebene **Web Terminal URL** und melden Sie sich mit den bereitgestellten Anmeldedaten an. Dadurch erhalten Sie eine vollständige Shell-Sitzung — installieren Sie Pakete, prüfen Sie Logs oder debuggen Sie Ihren Agenten direkt.

### File Manager

Mit dem File Manager können Sie Dateien im Sandbox-Workspace über eine Weboberfläche durchsuchen, hochladen, herunterladen und verwalten. Öffnen Sie die **File Manager URL** und melden Sie sich mit denselben Anmeldedaten an. Verwenden Sie ihn, um Workspace-Dateien des Agenten anzuzeigen, Konfigurationen zu bearbeiten oder Dateien zu übertragen, ohne CLI-Zugriff zu benötigen.

<Note>
  Für bestehende Sandboxes, die gestartet wurden, bevor diese Dienste verfügbar waren, können Sie sie nachträglich hinzufügen:

  ```bash Bash icon="terminal" theme={"system"}
  novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY
  ```
</Note>

## Preise

| Was Sie verwenden         | Was Sie bezahlen                                      |
| ------------------------- | ----------------------------------------------------- |
| Sandbox-Laufzeit          | [Sandbox-Preise](https://novita.ai/pricing?sandbox=1) |
| Von Novita gehostete LLMs | [Modellpreise](https://novita.ai/pricing)             |
| Drittanbieter-LLMs        | Nur Sandbox-Laufzeit                                  |
