Zum Hauptinhalt springen
Wenn MineClawd fehlschlaegt, finde unten zuerst das naechste passende Symptom und wende diese Loesung an.
Gib deinem Spieler OP-Level 2. Jeder /mineclawd- und /mclawd-Befehl erfordert OP-Zugriff.
Oeffne die Konfiguration und setze die Provider-Zugangsdaten.OpenAI-Pfad:
  • provider openai
  • api-key <key>
  • model <model>
Vertex-Pfad:
  • provider vertex-ai
  • vertex-api-key <key>
  • vertex-model <model>
Dein Client hat MineClawd wahrscheinlich nicht installiert. Nutze die Konfiguration per Befehl:
/mineclawd config <key> <value>
Installiere MineClawd auf deinem Client. Die History-Book-UI verwendet einen Client-Paketkanal.
Warte, bis die aktuelle Aufgabe beendet ist, bevor du eine neue Anfrage startest, die Session wechselst oder die persona wechselst.
Retry-Tokens verfallen nach 30 Minuten.Starte eine neue Anfrage oder nutze die letzte Retry-Aktion aus einer frischen Fehlermeldung.
Fuehre zuerst /mineclawd sessions list aus.Nutze dann exakt die Session-ID oder das Token aus dieser Ausgabe.
Pruefe verfuegbare Namen mit /mineclawd persona.Erstelle bei Bedarf eine neue persona-Datei unter mineclawd/souls/.
Setze den Modus und starte neu:
/mineclawd config dynamic-registry-mode enabled
Auf dedizierten Servern muessen Clients MineClawd ebenfalls installiert haben, wenn dies aktiviert ist.
Lies die gemeldeten Zeilen, behebe Syntax- oder Laufzeitprobleme in kubejs/server_scripts/mineclawd/ und lade erneut.Wiederhole das, bis die Reload-Ausgabe keine KubeJS-Fehler mehr zeigt.
MineClawd wartet nicht auf eine Antwort.Fuehre choose nur aus, nachdem MineClawd eine Rueckfrage gestellt hat.
Das ist ein bekannter YACL-Bug. Klicke auf den Wert und gib die ersten ein bis zwei Buchstaben der gewuenschten Option ein. Waehle dann die Option im Dropdown.Fuer LLM provider: tippe o fuer OpenAI oder g fuer Google Vertex AI. Fuer Broadcast Requests To: tippe on fuer only-me, a fuer all oder op fuer ops.
Der Assistive Touch Orb erfordert:
  • MineClawd auf dem Client.
  • OP-Berechtigung Level 2.
  • Enable GUI auf ON in der Konfiguration (Mod Menu -> MineClawd -> Configure).
  • Assistive Touch nicht deaktiviert (/mineclawd assistivetouch zum Reaktivieren).
Pruefe jeden Punkt. Wenn der Orb weiterhin fehlt, aktiviere den Debug-Modus und pruefe die Logs.
Stelle sicher, dass du die neueste MineClawd-Version nutzt.Wenn das Problem bleibt, kann es ein Mod-Konflikt sein. Teste nur mit MineClawd und seinen Abhaengigkeiten.
Das search-Tool benoetigt einen Tavily API-Key. Setze ihn mit:
/mineclawd config tavily-api-key <your-tavily-key>
Du bekommst einen Key auf tavily.com. Sobald konfiguriert, nutzt MineClawd die Websuche automatisch, wenn externe Informationen noetig sind.
Stop sendet ein Abbruchsignal an die aktive Anfrage. Wenn der LLM-Provider bereits fertig gerechnet hat, die Antwort aber noch uebertragen wird, wirkt stop eventuell nicht sofort.Wenn die Session nach stop gesperrt bleibt, erstelle mit /mineclawd sessions new eine neue Session.
Die Entity wurde eventuell getoetet, despawned oder entladen. Asset-Eintraege speichern den letzten bekannten Ort zum Erstellungszeitpunkt und verfolgen keine Bewegung.Teleport funktioniert nur fuer Entity-Kategorie-Assets mit gespeicherter UUID und Dimension.

​
Wenn Probleme bleiben

  • Aktiviere Debug-Logs: /mineclawd config debug-mode true
  • Reproduziere das Problem einmal
  • Pruefe logs/latest.log
  • Erstelle ein Issue: https://github.com/Zhou-Shilin/MineClawd/issues