Skip to main content

​
Goal

Follow this page step by step, and you will get one successful reply from MineClawd.

​
Tiny glossary

Minecraft Java Edition

The PC version of Minecraft from the official Minecraft Launcher.

Mod loader

Software that lets Minecraft run mods. MineClawd supports Fabric, Forge, and NeoForge.

Mod

A .jar file that adds features to Minecraft.

API key

A secret key that lets MineClawd talk to an online AI service.

​
Choose your platform

MineClawd supports three loader and version combinations. Pick the tab that matches your setup.

​
Step 3: put mod files into your mods folder

  1. Open your Minecraft folder.
  2. Open mods folder. If it does not exist, create it.
  3. Move all downloaded .jar files into mods.
  4. Do not unzip .jar files.

​
Step 4: launch game and open MineClawd config

  1. Start Minecraft with your mod loader profile.
  2. Create or open a single-player world.
  3. Turn Allow Cheats ON for that world.
  4. Open Better ModList -> MineClawd -> Configure (or Mod Menu if on Fabric).
MineClawd configuration screen in game

​
Step 5: connect an AI service

If you do not have an AI account yet, use OpenRouter and pick a free model.
  1. Create account: openrouter.ai
  2. Create API key: openrouter.ai/settings/keys
OpenRouter settings page showing API key management
  1. In MineClawd config screen, set:
    • Provider: OpenAI
    • Endpoint: https://openrouter.ai/api/v1
    • API Key: paste your OpenRouter key
    • Model: pick one model id from openrouter.ai/models (free models often include :free)
    • Summarize Model: use the same model id for now
  2. Save config.
Free models and limits change over time. If one model fails, pick another model id from the same models page.

​
Step 5b (optional): enable web search

MineClawd can search the web during conversations using Tavily. This is optional but useful when you want MineClawd to look up mod documentation, crafting recipes, or other online references.
  1. Create a Tavily account: tavily.com
  2. Copy your API key from the Tavily dashboard.
Tavily API platform showing API key management interface
  1. In MineClawd config screen, paste the key into the Tavily API Key field under the Search group. You can also set it via command:
/mineclawd config tavily-api-key <your-tavily-key>
When configured, MineClawd gains a search tool that queries the web and returns concise source snippets. If the key is not set, the search tool is disabled and MineClawd will let you know if you ask for a web search.

​
Step 6: send your first message

You have two ways to talk to MineClawd:

​
Option A: use the overlay GUI

Look for the floating orb (AssistiveTouch) on the left side of your screen. Click the orb to open the overlay, type your message in the input bar, and click Send.
MineClawd AssistiveTouch floating orb

​
Option B: use chat commands

Open chat and run: 
/mclawd hello
Both methods work. The overlay gives you streaming responses and session management in one place. See using the GUI for the full walkthrough.

​
If it does not work

Go to /resources/troubleshooting and follow the matching symptom.

​
Next steps

Use these guides to go deeper after your first successful request.

Using the GUI

Learn the overlay layout, streaming status, and inline questions.

Managing sessions

Create, switch, and repair Sessions for long-running work.

Tracking assets

Browse and manage everything MineClawd creates in your world.

Command reference

Explore every /mineclawd command with examples.