跳转到主要内容
如果 MineClawd 失败,请先在下方找到最接近的症状,并优先应用对应修复。
给你的玩家授予 OP 等级 2。所有 /mineclawd/mclawd 命令都要求 OP 权限。
打开配置并设置 provider 凭据。OpenAI 路径:
  • provider openai
  • api-key <key>
  • model <model>
Vertex 路径:
  • provider vertex-ai
  • vertex-api-key <key>
  • vertex-model <model>
你的客户端很可能没有安装 MineClawd。请改用命令配置:
/mineclawd config <key> <value>
在客户端安装 MineClawd。历史书 UI 使用客户端数据包通道。
先等待当前任务完成,再开始新请求、切换 Session,或切换 persona。
重试 token 在 30 分钟后过期。请重新触发一次请求,或使用最新失败消息里的最新重试操作。
先运行 /mineclawd sessions list然后使用输出里的精确 Session id 或 token。
/mineclawd persona 检查可用名称。如有需要,在 mineclawd/souls/ 下创建新的 persona 文件。
设置模式并重启:
/mineclawd config dynamic-registry-mode enabled
在专用服务器上启用后,客户端也必须安装 MineClawd。
阅读报错行,修复 kubejs/server_scripts/mineclawd/ 中的脚本语法或运行时问题,然后再次重载。持续修复,直到重载输出不再出现 KubeJS 错误。
MineClawd 当前没有在等待答案。仅在 MineClawd 发起澄清提问后再运行 choose
这是 YACL 的异常行为。点击该值,输入你想要选项的首字母(或前两个字母),然后在弹出的下拉里选择。对 LLM provider:输入 o 选 OpenAI,输入 g 选 Google Vertex AI。 对 Broadcast Requests To:输入 on 选 only-me,输入 a 选 all,输入 op 选 ops。
Assistive Touch 球体要求:
  • 客户端已安装 MineClawd。
  • OP 权限等级为 2。
  • 配置中 Enable GUI 为 ON(Mod Menu -> MineClawd -> Configure)。
  • Assistive Touch 未被关闭(可用 /mineclawd assistivetouch 重新启用)。
逐项检查以上条件。如果球体仍不显示,请启用调试模式并查看日志。
请确认你运行的是 MineClawd 最新版本。若问题仍存在,可能是模组冲突。请只安装 MineClawd 和它的依赖做一次最小化测试。
Stop 会向当前活动请求发送取消信号。如果 LLM provider 已处理完成但响应仍在传输,Stop 可能不会立刻生效。如果停止后 Session 仍被锁定,尝试运行 /mineclawd sessions new 创建新的 Session。
实体可能已被击杀、消失或未加载。资产记录保存的是创建时最后一次已知位置,不会追踪实体移动。传送仅对保存了有效 UUID 和维度的实体类资产有效。

如果问题仍存在

  • 开启调试日志:/mineclawd config debug-mode true
  • 复现一次问题
  • 检查 logs/latest.log
  • 提交 issue:https://github.com/Zhou-Shilin/MineClawd/issues