Fehlerbehebung

Hier findest du Lösungen für häufige Probleme bei Installation, Onboarding und Betrieb von NemoClaw.

Tipp: Falls dein Problem nicht aufgeführt ist, frage im NemoClaw-Discord-Kanal oder erstelle ein GitHub-Issue.

Installation

nemoclaw nach Installation nicht gefunden

Bei Verwendung von nvm/fnm: source ~/.bashrc ausführen oder neues Terminal öffnen.

Node.js-Version zu alt

NemoClaw erfordert Node.js 20+. Mit nvm: nvm install 20 && nvm use 20.

Docker läuft nicht

$ sudo systemctl start docker

npm-Berechtigungsfehler

Nicht sudo verwenden. Stattdessen:

$ mkdir -p ~/.npm-global
$ npm config set prefix ~/.npm-global
$ export PATH=~/.npm-global/bin:$PATH

Port belegt

Gateway nutzt Port 18789. Konfligierten Prozess finden und beenden:

$ lsof -i :18789
$ kill <PID>

Onboarding

cgroup-v2-Fehler

$ sudo nemoclaw setup-spark
$ nemoclaw onboard

Ungültiger Sandbox-Name

RFC-1123-Regeln beachten: Kleinbuchstaben, Ziffern, Bindestriche. Beispiel: my-assistant.

Sandbox-Erstellung scheitert auf DGX

nemoclaw onboard erneut ausführen.

Colima-Socket nicht erkannt (macOS)

$ colima status

Laufzeit

Sandbox als gestoppt angezeigt

nemoclaw onboard ausführen, um die Sandbox neu zu erstellen.

Status zeigt „not running” in der Sandbox

Erwartetes Verhalten. Auf dem Host openshell sandbox list ausführen.

Inferenzanfragen mit Timeout

openclaw nemoclaw status prüfen. API Key und Netzwerkrichtlinien verifizieren.

Agent kann externen Host nicht erreichen

$ openshell term

TUI öffnen, blockierte Anfragen genehmigen. Für dauerhaftes Erlauben: Netzwerkrichtlinie anpassen.

Blueprint-Run fehlgeschlagen

$ openclaw nemoclaw logs --run-id <id>