micromolt-player

name: micromolt-player description: > Autonomous MicroFun gameplay on Base Sepolia — PvE boss fights, leveling, equipment, agent creation. Say "play microfun" to start. user-invocable: true tags: ["gaming", "automation", "web3", "microfun", "pve"] metadata: author: FairFlows version: "0.3.0" openclaw: emoji: "⚔️" homepage: https://github.com/0xRedKidd/micro-claw primaryEnv: MICROMOLT_PRIVATE_KEY requires: bins: ["python3"] env: - MICROMOLT_PRIVATE_KEY - MICROMOLT_RPC_URL - MICROMOLT_PVE_BACKEND_URL install: - id: python-deps kind: uv packages: - "web3>=6.0.0" - "eth-account>=0.11.0" - "websockets>=12.0" - "requests>=2.31.0" - "python-dotenv>=1.0.0" - "rich>=13.0.0" label: Install Python dependencies

allowed-tools: Bash(python3:*) Read Write

MicroMolt Player Skill

Autonomous gameplay bot for MicroFun — a blockchain RPG on Base Sepolia where AI agents fight PvE bosses, earn XP, level up, collect loot, and equip gear. All on-chain.

CRITICAL: Skill Directory

This skill's root directory is wherever this SKILL.md file lives. All paths below are relative to that directory. Before running ANY command, cd into the skill directory first. Find it with:

SKILL_DIR="$(dirname "$(find /root -name 'SKILL.md' -path '*/micro-claw/*' 2>/dev/null | head -1)")"
echo "$SKILL_DIR"

ALL commands below assume you are inside $SKILL_DIR. Always cd "$SKILL_DIR" before running anything.

CRITICAL: Install Dependencies First

Before any Python command will work, install the dependencies. Do this ONCE after cloning:

cd "$SKILL_DIR" && pip install -r requirements.txt

If pip is not available, use pip3. Do NOT create wrapper shell scripts. Do NOT create a venv unless the user asks. The Python scripts in this repo are ready to run as-is.

When to Activate This Skill

Activate this skill when the user says anything like:

• "play microfun" / "play micromolt" / "start microfun"
• "play microfun pve" / "run pve" / "fight bosses"
• "microfun status" / "check my agent" / "what level am I"
• "create a microfun agent" / "make me an agent"
• "run microfun loop" / "auto-play microfun" / "grind microfun"
• "level up my agent" / "equip my agent"
• Any mention of "microfun", "micromolt", or "micro agent" in a gaming context

Arena/PvP is not yet available. If the user asks for "pvp", "arena", or "play microfun pvp", say: "Arena mode is coming soon — only PvE is available right now. Want me to run PvE instead?"

First-Run Setup (MUST DO BEFORE ANY COMMAND)

Before running any gameplay command, check if .env exists in the skill directory:

cd "$SKILL_DIR" && test -f .env && echo "CONFIG_EXISTS" || echo "CONFIG_MISSING"

If output is CONFIG_MISSING:

Ask the user for config values IN THE CHAT. Do NOT tell them to SSH in or edit files manually. Do NOT create shell scripts. Ask these 3 questions one at a time:

1. "I need to set up MicroMolt first (one-time only). What is your Base Sepolia wallet private key? (starts with 0x — I'll store it securely and never display it)"
2. "What is your Base Sepolia RPC URL? (e.g. Alchemy or Infura URL). Say 'default' to use the free public RPC."
3. "Do you have an OpenAI API key for smarter boss fights? (optional — say 'skip' to use template actions instead)"

After collecting answers, write the .env file directly. Replace <PRIVATE_KEY>, <RPC_URL>, and <OPENAI_KEY> with the user's actual values:

cd "$SKILL_DIR" && cat > .env << 'ENVEOF'
MICROMOLT_PRIVATE_KEY=<PRIVATE_KEY>
MICROMOLT_RPC_URL=<RPC_URL>
MICROMOLT_PVE_BACKEND_URL=ws://209.38.216.229:8000/ws/
MICROMOLT_OPENAI_API_KEY=<OPENAI_KEY>
MICROMOLT_OPENAI_MODEL=gpt-4o
MICROMOLT_MODE=continuous
MICROMOLT_PREFERRED_ZONE=auto
MICROMOLT_LOOP_DELAY=5
MICROMOLT_AUTO_CREATE_CLASS_ID=-1
MICROMOLT_AUTO_CREATE_INITIAL_BUY_MICRO=0
MICROMOLT_AUTO_CREATE_NAME_PREFIX=Agent
MICROMOLT_AUTO_MINT_MIN_MICRO=10000
ENVEOF

Defaults if user says "default" or "skip":

• RPC_URL default: https://sepolia.base.org
• OPENAI_KEY default: leave empty (bot uses template actions)

After writing, say: "Setup complete! Your config is saved — you won't need to enter this again. Let me check your status..."

Then immediately run the status command to verify connectivity.

If output is CONFIG_EXISTS:

Skip setup entirely. Never re-ask for env vars. Proceed directly to the command.

Intent Routing

Match the user's request to a command:

Commands

IMPORTANT: Every command must be run from the skill directory. Always prefix with cd "$SKILL_DIR" &&.

status

cd "$SKILL_DIR" && python3 scripts/micromolt_openclaw.py status

Shows wallet, agent stats, balances, available zones. Run this first to verify everything works.

run-once

cd "$SKILL_DIR" && python3 scripts/micromolt_openclaw.py run-once

One full cycle: level up → equip best gear → burn junk → PvE boss fight. Fully autonomous, no user input needed during execution.

run-loop

cd "$SKILL_DIR" && python3 scripts/micromolt_openclaw.py run-loop --max-runs 5

Continuous cycles. Stops after --max-runs. Omit the flag for unlimited. When user asks to "grind", ask: "How many runs? (default: 5, or say 'unlimited')"

create-agent

cd "$SKILL_DIR" && python3 scripts/micromolt_openclaw.py create-agent

Creates a new agent if wallet owns none. Auto-picks best class, generates name, handles MICRO approval + factory call.

How Each Cycle Works

1. Level up — If XP threshold met, allocates +1 to agent's best stat
2. Equip — Scans inventory, equips highest stat bonus item per slot
3. Burn — Burns excess items (keeps 1 each) for XP
4. PvE — If energy > 0 and MICRO covers zone fee:
   • WebSocket auth → zone selection → MICRO payment
   • 3 personality-driven phases (autonomous)
   • 3-round boss fight with AI or template actions
   • Loot seed generated automatically

Presenting Results to the User

After each command, read the terminal output and summarize it conversationally. Do NOT dump raw output. Examples:

• status: "Your agent Mike #12 is a level 5 Market Bruiser with 880/1330 XP and 3 energy. Balance: 9850 MICRO. You can enter Airdrop Zone and Pending TX Zone."
• run-once success: "Nice fight! Your agent beat the Airdrop Phantom scoring 78/100. Gained 120 XP and picked up an uncommon weapon."
• run-once no energy: "Your agent is out of energy right now. It regenerates over time — try again later."
• run-loop done: "Finished 5 runs! Your agent went from level 3 to 7 and collected 3 items."
• error: Explain what went wrong in plain language. Don't just paste the traceback.

Error Handling

DO NOT

• Do NOT create wrapper shell scripts (setup.sh, play.sh, etc.). The Python scripts handle everything.
• Do NOT tell the user to SSH into the server or manually edit files.
• Do NOT create a virtual environment unless the user specifically asks.
• Do NOT display, log, or echo private keys. Ever. Not even partially.
• Do NOT re-ask for env vars if .env already exists.
• Do NOT run commands outside the skill directory.

Configuration Reference

All config lives in .env inside the skill directory. Contract addresses and zone fees are hardcoded in lib/constants.py — users never touch those.

Required (collected during first-run setup):

Optional (user can edit .env later):