跳转到主要内容

​
用途

本页给出 MineClawd 的完整配置模型，包括文件键、命令键和重启行为。

​
设置存放位置

  • 全局配置文件：config/mineclawd.json5
  • 每位玩家的聊天可见性：mineclawd/player-settings.json
  • persona 文件与当前 persona 状态：mineclawd/souls/ 和 mineclawd/souls/.active/

​
完整 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",

  // 客户端专用（不写入服务器配置文件）
  enableGui: true
}
文件形式中的枚举值为大写（OPENAI、VERTEX_AI、AUTO、ENABLED、DISABLED）。命令形式中的值为小写（openai、vertex-ai、auto、enabled、disabled）。

​
键参考

文件键命令键类型默认值说明
providerproviderenumOPENAIprovider 选择：OpenAI 兼容或 Vertex AI。
endpointendpointstringhttps://api.openai.com/v1OpenAI 兼容基础 URL，不要求尾部斜杠。
apiKeyapi-keystring空OpenAI API key。
modelmodelstringgpt-5.2OpenAI chat model。
summarizeModelsummarize-modelstringgpt-5.2OpenAI 用于首轮 Session 标题生成的模型。
vertexEndpointvertex-endpointstringhttps://aiplatform.googleapis.com/v1Vertex API 基础 URL。
vertexApiKeyvertex-api-keystring空Vertex API key。
vertexModelvertex-modelstringgemini-3.1-pro-previewVertex model 路径或 model 名称。
vertexSummarizeModelvertex-summarize-modelstringgemini-3-flash-previewVertex 用于 Session 标题的 summarize model。
tavilyApiKeytavily-api-keystring空Tavily API key，用于网页搜索。设置后启用 search 工具。
debugModedebug-modebooleanfalse记录详细请求和工具活动日志。
limitToolCallslimit-tool-callsbooleanfalse启用每次请求的工具循环上限。
toolCallLimittool-call-limitinteger16允许范围 1 到 20。
systemPromptsystem-promptstring空空值表示使用内置 system prompt。命令模式用 default 重置。
dynamicRegistryModedynamic-registry-modeenumAUTO控制动态占位符运行模式。修改后需重启。
enableGui—booleantrue仅客户端。显示或隐藏覆盖层 GUI。通过 Mod Menu -> MineClawd -> Configure 设置。

​
每位玩家设置

​
broadcast-requests-to

仅命令可设，按玩家保存。
  • 命令键：broadcast-requests-to
  • 允许值：self、all、ops
  • 存储位置：mineclawd/player-settings.json
  • 用途：控制谁能看到提示回显和任务开始/结束行。

​
assistivetouch

仅切换，按玩家保存。
  • 命令：/mineclawd assistivetouch
  • 存储位置：mineclawd/player-settings.json
  • 默认：启用（可见）
  • 用途：在不禁用完整 GUI 的情况下显示或隐藏浮动 Assistive Touch 球体。

​
动态注册表模式行为

  • AUTO: 在客户端运行时（单人）启用，在专用服务器禁用。
  • ENABLED: 在所有运行时强制启用。
  • DISABLED: 完全禁用。
如果你在专用服务器上强制 ENABLED，加入的客户端也必须安装 MineClawd。

​
推荐基线

​
首次 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

​
首次 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

​
GUI 路径

  • 游戏内：Mod Menu -> MineClawd -> Configure
  • 命令兜底：/mineclawd config ...
  • 覆盖层菜单：点击汉堡图标 -> Config
如果客户端 GUI 打开失败，请通过命令键配置。
enableGui 设置控制覆盖层窗口。把它设为 OFF 不会影响 YACL 配置界面，你仍可通过 Mod Menu 或 /mineclawd config 打开配置。