Skip to main content
If MineClawd fails, find the closest symptom below and apply that fix first.
Give your player OP level 2 permissions. Every /mineclawd and /mclawd command requires OP access.
Open config and set provider credentials.OpenAI path:
  • provider openai
  • api-key <key>
  • model <model>
Vertex path:
  • provider vertex-ai
  • vertex-api-key <key>
  • vertex-model <model>
Your client likely does not have MineClawd installed. Use command configuration:
/mineclawd config <key> <value>
Install MineClawd on your client. The history book UI uses a client packet channel.
Wait for current task completion before starting a new one, switching sessions, or switching persona.
Retry tokens expire after 30 minutes.Trigger a new request or use the latest retry action from a fresh failure message.
Run /mineclawd sessions list first.Then use exact session id or token from that output.
Check available names with /mineclawd persona.If needed, create a new soul file under mineclawd/souls/.
Set mode and restart:
/mineclawd config dynamic-registry-mode enabled
On dedicated servers, clients must also install MineClawd when this is enabled.
Read the reported lines, fix script syntax or runtime issues in kubejs/server_scripts/mineclawd/, then reload again.Keep fixing until reload output reports no KubeJS errors.
MineClawd is not waiting for an answer.Run choose only after MineClawd asks a clarification question.
It’s a weird bug of YACL. Click on the value and enter the first (two) letter(s) of the option you want, then select it from the dropdown that appears.For LLM provider: type o for OpenAI or g for Google Vertex AI. For Broadcast Requests To: type on for only-me, a for all, or op for ops.
The AssistiveTouch orb requires:
  • MineClawd installed on the client.
  • OP permission level 2.
  • Enable GUI set to ON in config (Mod Menu -> MineClawd -> Configure).
  • AssistiveTouch not toggled off (/mineclawd assistivetouch to re-enable).
Check each of these. If the orb still does not appear, enable debug mode and check logs.
Make sure you are running the latest version of MineClawd.If the issue persists, it may be a mod conflict. Test with only MineClawd and its dependencies installed.
The search tool requires a Tavily API key. Set one with:
/mineclawd config tavily-api-key <your-tavily-key>
Get a key from tavily.com. Once configured, MineClawd uses web search automatically when it needs external information.
Stop sends a cancellation signal to the active request. If the LLM provider has already finished processing but the response is still being delivered, stop may not take effect immediately.If the session remains locked after stopping, try creating a new session with /mineclawd sessions new.
The entity may have been killed, despawned, or unloaded. Asset records store the last known location at creation time and do not track entity movement.Teleport works only for entity-category assets with a stored UUID and dimension.

​
If problems continue

  • Enable debug logs: /mineclawd config debug-mode true
  • Reproduce once
  • Check logs/latest.log
  • File an issue: https://github.com/Zhou-Shilin/MineClawd/issues