Saltar al contenido principal

​
Propósito

Esta página te da el modelo completo de configuración de MineClawd, incluyendo ajustes de archivo, claves de comando y comportamiento de reinicio.

​
Dónde viven los ajustes

  • Archivo de configuración global: config/mineclawd.json5
  • Visibilidad de chat por jugador: mineclawd/player-settings.json
  • Archivos de persona (soul) y estado de soul activa: mineclawd/souls/ y mineclawd/souls/.active/

​
Plantilla completa de mineclawd.json5

{
  provider: "OPENAI",
  endpoint: "https://api.openai.com/v1",
  apiKey: "",
  model: "gpt-5.2",
  summarizeModel: "gpt-5.2",

  vertexEndpoint: "https://aiplatform.googleapis.com/v1",
  vertexApiKey: "",
  vertexModel: "gemini-3.1-pro-preview",
  vertexSummarizeModel: "gemini-3-flash-preview",

  tavilyApiKey: "",

  debugMode: false,
  limitToolCalls: false,
  toolCallLimit: 16,
  systemPrompt: "",
  dynamicRegistryMode: "AUTO",

  // Solo cliente (no va en el archivo de configuración del servidor)
  enableGui: true
}
En formato de archivo, los valores enum van en mayúsculas (OPENAI, VERTEX_AI, AUTO, ENABLED, DISABLED).En formato de comando, los valores van en minúsculas (openai, vertex-ai, auto, enabled, disabled).

​
Referencia de claves

Clave de archivoClave de comandoTipoPredeterminadoNotas
providerproviderenumOPENAISelección de proveedor: compatible con OpenAI o Vertex AI.
endpointendpointstringhttps://api.openai.com/v1URL base compatible con OpenAI; no requiere barra final.
apiKeyapi-keystringvacíoOpenAI API key.
modelmodelstringgpt-5.2Modelo de chat OpenAI.
summarizeModelsummarize-modelstringgpt-5.2Modelo OpenAI para generar el título de Session en el primer turno.
vertexEndpointvertex-endpointstringhttps://aiplatform.googleapis.com/v1URL base de Vertex API.
vertexApiKeyvertex-api-keystringvacíoVertex API key.
vertexModelvertex-modelstringgemini-3.1-pro-previewRuta de modelo Vertex o nombre de modelo.
vertexSummarizeModelvertex-summarize-modelstringgemini-3-flash-previewModelo de resumen Vertex para títulos de Session.
tavilyApiKeytavily-api-keystringvacíoTavily API key para búsqueda web. Cuando se define, habilita la herramienta search.
debugModedebug-modebooleanfalseRegistra actividad detallada de solicitudes y herramientas.
limitToolCallslimit-tool-callsbooleanfalseHabilita límite de loop de herramientas por solicitud.
toolCallLimittool-call-limitinteger16El rango permitido es 1 a 20.
systemPromptsystem-promptstringvacíoVacío usa el system prompt integrado. Usa valor default en modo comando para restablecer.
dynamicRegistryModedynamic-registry-modeenumAUTOControla el modo de runtime de placeholders dinámicos. Requiere reinicio tras cambiar.
enableGui—booleantrueSolo cliente. Muestra u oculta la GUI de superposición. Se define en Mod Menu -> MineClawd -> Configure.

​
Ajustes por jugador

​
broadcast-requests-to

Solo comando, por jugador.
  • Clave de comando: broadcast-requests-to
  • Valores permitidos: self, all, ops
  • Se guarda en: mineclawd/player-settings.json
  • Propósito: controla quién ve el eco del prompt y líneas de inicio o fin de tarea.

​
assistivetouch

Solo toggle, por jugador.
  • Comando: /mineclawd assistivetouch
  • Se guarda en: mineclawd/player-settings.json
  • Predeterminado: habilitado (visible)
  • Propósito: mostrar u ocultar el orbe Assistive Touch flotante sin desactivar todo el sistema GUI.

​
Comportamiento de dynamic registry mode

  • AUTO: habilitado en runtime de cliente (un jugador), deshabilitado en servidores dedicados.
  • ENABLED: forzado como habilitado en todos los runtimes.
  • DISABLED: deshabilitado por completo.
Si fuerzas ENABLED en un servidor dedicado, los clientes que se unan deben tener MineClawd instalado.

​
Baselines recomendados

​
Baseline para setup inicial con OpenAI

/mineclawd config provider openai
/mineclawd config endpoint https://api.openai.com/v1
/mineclawd config api-key <your-key>
/mineclawd config model gpt-5.2
/mineclawd config summarize-model gpt-5.2

​
Baseline para setup inicial con Vertex

/mineclawd config provider vertex-ai
/mineclawd config vertex-endpoint https://aiplatform.googleapis.com/v1
/mineclawd config vertex-api-key <your-key>
/mineclawd config vertex-model gemini-3.1-pro-preview
/mineclawd config vertex-summarize-model gemini-3-flash-preview

​
Ruta GUI

  • En juego: Mod Menu -> MineClawd -> Configure
  • Alternativa por comando: /mineclawd config ...
  • Menú de superposición: haz clic en el icono de hamburguesa -> Config
Si abrir la GUI cliente falla, configura con claves de comando.
El ajuste enableGui controla la ventana de superposición. Ponerlo en OFF no afecta la pantalla de configuración YACL: todavía puedes abrir configuración desde Mod Menu o /mineclawd config.