Befehlsreferenz

Vollständige Referenz für alle NovitaClaw CLI-Befehle.

`launch`

Erstellen Sie eine neue Sandbox-Instanz.

Bash

novitaclaw launch [OPTIONS]

Option	Beschreibung
`--api-key`	Novita API-Schlüssel
`--gateway-token`	Benutzerdefiniertes Gateway-Token (optional, standardmäßig automatisch generiert)
`--timeout`	Zeitlimit für die Erstellung in Sekunden (Standard: `60`)
`--type`	Sandbox-Typ: `persistent` (Standard) oder `on-demand`
`--idle-timeout`	Leerlauf-Zeitlimit in Sekunden für den On-Demand-Modus (Standard: `300`, Bereich: 60–86400)

`list`

Aktive Sandbox-Instanzen auflisten.

Bash

novitaclaw list --api-key YOUR_API_KEY

Option	Beschreibung
`--api-key`	Novita API-Schlüssel
`--quiet`, `-q`	Nur Sandbox-IDs ausgeben, eine pro Zeile (nützlich für Skripting)

`status`

Status einer Sandbox-Instanz prüfen. Zeigt Webhook-URLs für alle konfigurierten Kanäle an.

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

Option	Beschreibung
`--api-key`	Novita API-Schlüssel
`--json`	Ausgabe im JSON-Format (nützlich zum Extrahieren von Webhook-URLs)

`stop`

Eine Sandbox-Instanz beenden.

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY

Option	Beschreibung
`--api-key`	Novita API-Schlüssel
`--yes`, `-y`	Bestätigungsaufforderung überspringen

`pause`

Eine Sandbox-Instanz pausieren. Während der Pause fallen keine Kosten an.

Bash

novitaclaw pause <SANDBOX_ID> --api-key YOUR_API_KEY

`resume`

Eine pausierte Sandbox-Instanz fortsetzen (~1 s zum Wiederherstellen).

Bash

novitaclaw resume <SANDBOX_ID> --api-key YOUR_API_KEY

`config set`

Laufzeitkonfiguration der Sandbox aktualisieren.

Bash

# Update idle timeout (60–86400 seconds)
novitaclaw config set <SANDBOX_ID> idle-timeout 600

# Update sandbox lifetime timeout (300–2592000 seconds)
novitaclaw config set <SANDBOX_ID> timeout 3600

`tui`

Über die Terminal-UI mit einer Sandbox verbinden.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

`doctor`

Diagnosen und Reparaturprüfungen für eine Sandbox-Instanz ausführen.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY

Option	Beschreibung
`--api-key`	Novita API-Schlüssel
`--deep`	Systemdienste auf zusätzliche Gateway-Installationen prüfen
`--fix`	Empfohlene Reparaturen anwenden (Alias für `--repair`)
`--force`	Aggressive Reparaturen anwenden (überschreibt benutzerdefinierte Dienstkonfiguration)
`--generate-gateway-token`	Ein Gateway-Token generieren und konfigurieren
`--no-workspace-suggestions`	Vorschläge des Workspace-Speichersystems deaktivieren
`--repair`	Empfohlene Reparaturen ohne Rückfrage anwenden
`--yes`	Standardwerte ohne Rückfrage akzeptieren

`gateway update`

OpenClaw innerhalb einer Sandbox auf die neueste Version aktualisieren.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY

Option	Beschreibung
`--api-key`	Novita API-Schlüssel
`--restart`	Gateway nach dem Update neu starten

`gateway restart`

OpenClaw Gateway in einer Sandbox neu starten.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

`services setup`

Web Terminal und File Manager auf einer bestehenden Sandbox installieren und starten. Verwenden Sie dies, um älteren Sandboxes Dienste hinzuzufügen, die gestartet wurden, bevor diese Dienste enthalten waren.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

`pair list`

Ausstehende Pairing-Anfragen für einen Kanal auflisten.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

`pair approve`

Eine Pairing-Anfrage für einen Kanal genehmigen.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

`pair feishu`

Feishu (Lark) als Messaging-Kanal konfigurieren.

Bash

novitaclaw pair feishu <SANDBOX_ID> \
  --app-id cli_xxx \
  --app-secret secret_xxx \
  --mode webhook \
  --verification-token tok_xxx \
  --encrypt-key key_xxx

Option	Beschreibung
`--app-id`	Feishu-App-ID
`--app-secret`	Feishu-App-Secret
`--mode`	`event` (Standard) oder `webhook`
`--verification-token`	Webhook-Verifizierungstoken (nur Webhook-Modus)
`--encrypt-key`	Webhook-Verschlüsselungsschlüssel (nur Webhook-Modus)
`--webhook-host`	Webhook-Bind-Adresse (Standard: `0.0.0.0`)
`--webhook-port`	Webhook-Listen-Port (Standard: `3000`)
`--webhook-path`	Webhook-URL-Pfad (Standard: `/feishu/events`)

`pair telegram`

Telegram als Messaging-Kanal konfigurieren.

Bash

# Polling mode (default)
novitaclaw pair telegram <SANDBOX_ID> \
  --bot-token <BOT_TOKEN>

# Webhook mode
novitaclaw pair telegram <SANDBOX_ID> \
  --bot-token <BOT_TOKEN> \
  --mode webhook \
  --webhook-url https://example.com/webhook/telegram \
  --webhook-secret <SECRET>

Option	Beschreibung
`--bot-token`	Telegram-Bot-Token von BotFather
`--mode`	`polling` (Standard) oder `webhook`
`--webhook-url`	Öffentliche Webhook-URL (nur Webhook-Modus)
`--webhook-secret`	Webhook-Secret (nur Webhook-Modus)
`--webhook-host`	Webhook-Bind-Adresse (Standard: `0.0.0.0`)
`--webhook-port`	Webhook-Listen-Port (Standard: `8787`)
`--webhook-path`	Webhook-URL-Pfad (Standard: `/webhook/telegram`)
`--dm-policy`	DM-Richtlinie (Standard: `pairing`)

`pair slack`

Slack als Messaging-Kanal konfigurieren.

Bash

# Socket mode (default)
novitaclaw pair slack <SANDBOX_ID> \
  --bot-token xoxb-... \
  --app-token xapp-...

# HTTP mode
novitaclaw pair slack <SANDBOX_ID> \
  --bot-token xoxb-... \
  --mode http \
  --signing-secret <SECRET>

Option	Beschreibung
`--bot-token`	Slack-Bot-Token (`xoxb-...`)
`--app-token`	Slack-App-Token (`xapp-...`, nur Socket-Modus)
`--mode`	`socket` (Standard) oder `http`
`--signing-secret`	Slack-Signing-Secret (nur HTTP-Modus)
`--webhook-host`	Webhook-Bind-Adresse (Standard: `0.0.0.0`)
`--webhook-port`	Webhook-Listen-Port (Standard: `8788`)
`--webhook-path`	Webhook-URL-Pfad (Standard: `/webhook/slack`)

`update`

Nach CLI-Updates suchen und auf die neueste Version aktualisieren.

Bash

novitaclaw update

Programmatische Verwendung

Verwenden Sie JSON-Ausgabe für Automatisierung:

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

Beispielantwort:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

Umgebungsvariablen

Variable	Beschreibung
`NOVITA_API_KEY`	API-Schlüssel, macht das Flag `--api-key` überflüssig
`OPENCLAW_GATEWAY_TOKEN`	Voreingestelltes Gateway-Token

Fehlerbehebung

Befehl nicht gefunden

Versuchen Sie eine der folgenden Optionen:

Bash

# Use full path (Linux)
~/.local/bin/novitaclaw launch

# Typical macOS user path
~/Library/Python/3.x/bin/novitaclaw launch

Verbindungs-Zeitüberschreitung

Start-Zeitlimit erhöhen:

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

Häufig gestellte Fragen

Problem	Warum es passiert	Was zu tun ist
”Command not found” / “Not recognized”	Python PATH wurde während der Installation nicht konfiguriert	Python neu installieren und “Add to PATH” aktivieren oder das bin-Verzeichnis manuell hinzufügen
”Permission Denied”	Unzureichende Berechtigungen	Windows: Terminal als Administrator ausführen. Mac/Linux: mit `sudo` voranstellen
”Invalid API Key”	Schlüssel wurde falsch kopiert	Auf zusätzliche Leerzeichen um die Zeichenfolge `sk_` prüfen oder einen neuen Schlüssel generieren
Sandbox lässt sich nicht stoppen	Erfordert eine Bestätigung, um versehentliches Löschen zu verhindern	Geben Sie bei der Aufforderung `y` ein oder verwenden Sie `--yes`, um die Bestätigung zu überspringen
Mac: Befehl `pip` nicht gefunden	macOS verwendet standardmäßig `pip3`	Verwenden Sie `pip3 install novitaclaw` anstelle von `pip`

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

`launch`

`list`

`status`

`stop`

`pause`

`resume`

`config set`

`tui`

`doctor`

`gateway update`

`gateway restart`

`services setup`

`pair list`

`pair approve`

`pair feishu`

`pair telegram`

`pair slack`

`update`

Programmatische Verwendung

Umgebungsvariablen

Fehlerbehebung

Befehl nicht gefunden

Verbindungs-Zeitüberschreitung

Häufig gestellte Fragen

​launch

​list

​status

​stop

​pause

​resume

​config set

​tui

​doctor

​gateway update

​gateway restart

​services setup

​pair list

​pair approve

​pair feishu

​pair telegram

​pair slack

​update

​Programmatische Verwendung

​Umgebungsvariablen

​Fehlerbehebung

​Befehl nicht gefunden

​Verbindungs-Zeitüberschreitung

​Häufig gestellte Fragen

`launch`

`list`

`status`

`stop`

`pause`

`resume`

`config set`

`tui`

`doctor`

`gateway update`

`gateway restart`

`services setup`

`pair list`

`pair approve`

`pair feishu`

`pair telegram`

`pair slack`

`update`

Programmatische Verwendung

Umgebungsvariablen

Fehlerbehebung

Befehl nicht gefunden

Verbindungs-Zeitüberschreitung

Häufig gestellte Fragen