mewamew/mc_claw
Developer toolsThis page was translated automatically. Technical details may differ from the original. View the original
Using lobsters to play MC
Overview
The AI Agent acts as the "brain" for perception, decision-making, and planning, while the Mineflayer Bot service acts as the "hands and feet" connecting to the Minecraft server and executing specific actions. The two communicate via HTTP APIs and do not rely on each other's lifecycles. - : Move, dig, place, synthesize, smelt, feed, fight, explore, operate boxes, build, etc. - : Integrate 788 item acquisition methods and a complete dependency tree (data from Odyssey, MIT license) - : Automatically learn from failures, record problems and solutions - : Remember landmarks (workbench, furnace, crate locations), resource distribution, key facts - : Auto feed, auto counter, auto shelter, and other survival reflexes - : Web Dashboard for real-time bot status - Node.js 18+ - Minecraft Java Edition 1.20 (requires a running server or LAN game) The bot service connects to localhost:18888 by default, and the HTTP API listens for port 3001. After launching the Bot service, open http://localhost:3001/dashboard in your browser to view the real-time status. This repository is also a root directory SKILL.md that follows the OpenClaw / Anthropic Agent Skills specification and can be directly imported into agent platforms that support this specification (such as OpenClaw, Claude Code, etc.). 1. Open OpenClaw → Settings → Skill Management → Add Skills → Import from GitHub 2. Enter the repository URL, for example https://github.com/ /mc_claw 3. After successful import, skills will appear in the "User Add Skills" list; enable them When importing, OpenClaw copies the entire repository to ~/.openclaw/skills/mc-claw/, and bot-service/ is also copied (no side effects, just occupying a few more MB of space).
Overview (machine translated)
Play Minecraft survival mode autonomously with AI Agents.
The AI Agent acts as the “brain” for perception, decision-making, and planning, while the Mineflayer Bot service acts as the “hands and feet” connecting to the Minecraft server and executing specific actions. The two communicate via HTTP APIs and do not rely on each other’s lifecycles.
Features
- 20+ Action Commands: Move, dig, place, synthesize, smelt, feed, fight, explore, handle boxes, build, and more
- Recipe Database: Integrates methods for obtaining 788 items and a complete dependency tree (data from Odyssey, MIT license)
- Experience System: Automatically learns from failures, records problems and solutions
- Memory System: Remember landmarks (workbench, furnace, crate locations), resource distribution, and key facts
- Reflection Layer: Survival reflexes such as automatic feeding, automatic counterattack, and automatic shelter
- Monitoring Panel: A Web Dashboard for real-time monitoring of bot status
Get Started Quickly
Prerequisites
- Node.js 18+
- Minecraft Java Edition 1.20 (requires a running server or LAN game)
Starting the Bot Service
The bot service connects to localhost:18888 by default, and the HTTP API listens for port 3001.
Customize configuration via environment variables:
Verification Services
Monitoring panel
After launching the bot service, open http://localhost:3001/dashboard in your browser to view the real-time status.
API
| Endpoint | Method | Description |
|---|---|---|
/health |
GET | Service health checks |
/state |
GET | Bot location, health, hunger, backpack, surrounding environment |
/logs |
GET | Recent Event Log |
/action |
POST | Perform a single action |
/action/batch |
POST | Batch execution of action sequences |
/recipe |
GET | Query item recipes and dependency trees |
/report |
POST | Agent reports current plans |
/reset |
POST | Reset Bot (New Game) |
/dashboard |
GET | Monitoring panel |
Action Commands
Basic Movements
| Instructions | type | payload | Note |
|---|---|---|---|
| Chat | chat |
{message} |
Send chat messages |
| Move | goto |
{x, y, z} |
A* Navigate to the specified coordinates |
| View Surroundings | lookAround |
- | Obtain nearby blocks, creatures, and players |
This page was translated automatically. Technical details may differ from the original.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add mewamew/mc_claw