Zum Hauptinhalt springen

​
Zweck

Diese Seite zeigt dir das komplette MineClawd-Konfigurationsmodell, inklusive Datei-Einstellungen, Befehls-keys und Neustartverhalten.

​
Wo Einstellungen liegen

  • Globale Konfigurationsdatei: config/mineclawd.json5
  • Chat-Sichtbarkeit pro Spieler: mineclawd/player-settings.json
  • persona-Dateien und aktiver persona-Status: mineclawd/souls/ und mineclawd/souls/.active/

​
Vollstaendige mineclawd.json5-Vorlage

{
  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",

  // Nur Client (nicht in der Server-Konfigurationsdatei)
  enableGui: true
}
In Dateiform sind Enum-Werte gross geschrieben (OPENAI, VERTEX_AI, AUTO, ENABLED, DISABLED).In Befehlsform sind Werte klein geschrieben (openai, vertex-ai, auto, enabled, disabled).

​
Key-Referenz

Datei-keyBefehls-keyTypDefaultHinweise
providerproviderenumOPENAIProvider-Auswahl: OpenAI-kompatibel oder Vertex AI.
endpointendpointstringhttps://api.openai.com/v1OpenAI-kompatible Basis-URL, kein abschliessender Slash noetig.
apiKeyapi-keystringleerOpenAI API-Key.
modelmodelstringgpt-5.2OpenAI Chat-Modell.
summarizeModelsummarize-modelstringgpt-5.2OpenAI-Modell fuer Session-Titelerstellung nach der ersten Runde.
vertexEndpointvertex-endpointstringhttps://aiplatform.googleapis.com/v1Vertex API-Basis-URL.
vertexApiKeyvertex-api-keystringleerVertex API-Key.
vertexModelvertex-modelstringgemini-3.1-pro-previewVertex-Modellpfad oder Modellname.
vertexSummarizeModelvertex-summarize-modelstringgemini-3-flash-previewVertex summarize-Modell fuer Session-Titel.
tavilyApiKeytavily-api-keystringleerTavily API-Key fuer Websuche. Wenn gesetzt, wird das search-Tool aktiviert.
debugModedebug-modebooleanfalseLoggt detaillierte Request- und Tool-Aktivitaeten.
limitToolCallslimit-tool-callsbooleanfalseAktiviert ein Tool-Loop-Limit pro Anfrage.
toolCallLimittool-call-limitinteger16Erlaubter Bereich: 1 bis 20.
systemPromptsystem-promptstringleerLeer bedeutet eingebauter Systemprompt. Nutze im Befehlsmodus den Wert default zum Zuruecksetzen.
dynamicRegistryModedynamic-registry-modeenumAUTOSteuert den Runtime-Modus fuer dynamische Placeholder. Nach Aenderung ist ein Neustart noetig.
enableGui—booleantrueNur Client-seitig. Zeigt oder versteckt die Overlay-GUI. Setze es ueber Mod Menu -> MineClawd -> Configure.

​
Einstellungen pro Spieler

​
broadcast-requests-to

Nur per Befehl, pro Spieler.
  • Befehls-key: broadcast-requests-to
  • Erlaubte Werte: self, all, ops
  • Gespeichert in: mineclawd/player-settings.json
  • Zweck: steuert, wer Prompt-Echo und Task-Start- oder Task-Ende-Zeilen sieht.

​
assistivetouch

Nur Toggle, pro Spieler.
  • Befehl: /mineclawd assistivetouch
  • Gespeichert in: mineclawd/player-settings.json
  • Default: aktiviert (sichtbar)
  • Zweck: zeigt oder versteckt den schwebenden Assistive Touch Orb, ohne die komplette GUI zu deaktivieren.

​
Verhalten von dynamic registry mode

  • AUTO: aktiviert in Client-Runtimes (Einzelspieler), deaktiviert auf dedizierten Servern.
  • ENABLED: erzwingt Aktivierung in allen Runtimes.
  • DISABLED: vollstaendig deaktiviert.
Wenn du ENABLED auf einem dedizierten Server erzwingst, muessen beitretende Clients MineClawd installiert haben.

​
Empfohlene Baselines

​
Baseline fuer erstes OpenAI-Setup

/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 fuer erstes Vertex-Setup

/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

​
GUI-Pfad

  • Im Spiel: Mod Menu -> MineClawd -> Configure
  • Befehls-Fallback: /mineclawd config ...
  • Overlay-Menue: Hamburger-Icon klicken -> Config
Wenn das Oeffnen der Client-GUI fehlschlaegt, konfiguriere ueber Befehls-keys.
Die Einstellung enableGui steuert das Overlay-Fenster. OFF beeinflusst den YACL-Konfigurationsbildschirm nicht. Du kannst die Konfiguration weiterhin ueber Mod Menu oder /mineclawd config oeffnen.