Saltar al contenido principal
Si MineClawd falla, busca el síntoma más cercano abajo y aplica primero esa solución.
Dale a tu jugador permisos OP nivel 2. Todos los comandos /mineclawd y /mclawd requieren acceso OP.
Abre configuración y define credenciales del proveedor.Ruta OpenAI:
  • provider openai
  • api-key <key>
  • model <model>
Ruta Vertex:
  • provider vertex-ai
  • vertex-api-key <key>
  • vertex-model <model>
Es probable que tu cliente no tenga MineClawd instalado. Usa configuración por comando:
/mineclawd config <key> <value>
Instala MineClawd en tu cliente. La UI del libro de historial usa un canal de paquetes de cliente.
Espera a que termine la tarea actual antes de iniciar una nueva, cambiar de Session o cambiar de persona.
Los tokens de reintento expiran tras 30 minutos.Lanza una solicitud nueva o usa la acción de reintento más reciente de un mensaje de error fresco.
Ejecuta primero /mineclawd sessions list.Después usa el id de Session exacto o el token de esa salida.
Revisa los nombres disponibles con /mineclawd persona.Si hace falta, crea un archivo soul nuevo en mineclawd/souls/.
Define el modo y reinicia:
/mineclawd config dynamic-registry-mode enabled
En servidores dedicados, los clientes también deben instalar MineClawd cuando esto esté habilitado.
Lee las líneas reportadas, corrige errores de sintaxis o runtime en kubejs/server_scripts/mineclawd/ y luego recarga.Sigue corrigiendo hasta que la salida de recarga no reporte errores de KubeJS.
MineClawd no está esperando una respuesta.Ejecuta choose solo después de que MineClawd haga una pregunta de aclaración.
Es un bug raro de YACL. Haz clic en el valor e introduce la primera (o primeras dos) letra(s) de la opción, luego selecciónala del desplegable que aparece.Para proveedor LLM: escribe o para OpenAI o g para Google Vertex AI. Para Broadcast Requests To: escribe on para only-me, a para all o op para ops.
El orbe Assistive Touch requiere:
  • MineClawd instalado en el cliente.
  • Permiso OP nivel 2.
  • Enable GUI en ON en configuración (Mod Menu -> MineClawd -> Configure).
  • Assistive Touch no desactivado (/mineclawd assistivetouch para volver a activarlo).
Revisa cada punto. Si el orbe todavía no aparece, habilita modo debug y revisa logs.
Asegúrate de estar en la versión más reciente de MineClawd.Si el problema continúa, puede ser un conflicto entre mods. Prueba con solo MineClawd y sus dependencias instaladas.
La herramienta search requiere una Tavily API key. Configúrala con:
/mineclawd config tavily-api-key <your-tavily-key>
Obtén una clave en tavily.com. Cuando se configura, MineClawd usa búsqueda web automáticamente cuando necesita información externa.
Stop envía una señal de cancelación a la solicitud activa. Si el proveedor LLM ya terminó de procesar pero la respuesta todavía se está entregando, stop puede no surtir efecto de inmediato.Si la Session sigue bloqueada después de detener, intenta crear una Session nueva con /mineclawd sessions new.
Puede que la entidad haya muerto, desaparecido o quedado descargada. Los registros de assets guardan la última ubicación conocida al crearse y no siguen el movimiento de la entidad.Teleport solo funciona para assets de categoría entidad con UUID y dimensión almacenados.

​
Si los problemas continúan

  • Habilita logs de debug: /mineclawd config debug-mode true
  • Reproduce el problema una vez
  • Revisa logs/latest.log
  • Abre un issue: https://github.com/Zhou-Shilin/MineClawd/issues