pokemon-emulator

🎮 OpenClaw Pokemon Emulator Skill

Play Pokemon, Game Boy, Game Boy Color, and Game Boy Advance games through OpenClaw!

    .---.     .---.     .---.     .---.     .---.
   /     \   /     \   /     \   /     \   /     \
  | () () | | () () | | () () | | () () | | () () |
   \  ^  /   \  ^  /   \  ^  /   \  ^  /   \  ^  /
    |||||     |||||     |||||     |||||     |||||
    |||||     |||||     |||||     |||||     |||||
   Pokemon   Pokemon   Pokemon   Pokemon   Pokemon
    Red       Blue     Yellow     Gold     Emerald

What Is This?

The Pokemon Emulator Skill lets you play classic handheld Pokemon games directly through OpenClaw. It wraps two emulation backends:

• PyBoy — A pure-Python Game Boy (GB) and Game Boy Color (GBC) emulator. Great for scripting, automation, and lightweight play.
• GBA Emulators — Game Boy Advance games via subprocess launchers that work with mGBA, VBA-M, or any CLI-capable GBA emulator.

Beyond just launching games, this skill gives you:

• �save Save state management (multiple slots per game)
• 📸 Screenshot capture at any time
• ⌨️ Keyboard-driven gameplay control
• 🔧 Per-game configuration and hotkey maps

---

📋 Prerequisites

Before installing and using this skill, make sure you have the following:

Required for GB/GBC Games (PyBoy)

Required for GBA Games

Optional but Recommended

---

🔧 Installing the Emulators

Installing PyBoy

# Create a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate      # Linux/macOS
# OR
.venv\Scripts\activate        # Windows

# Install PyBoy
pip install pyboy

Note: PyBoy runs entirely in Python — no additional emulator binary needed!

Installing mGBA (Recommended for GBA)

Windows:

1. Download mGBA from https://mgba.io/downloads.html
2. Extract the ZIP to a folder (e.g., C:\Emulators\mGBA)
3. Add that folder to your system PATH, or note the full path to mgba.exe

Linux (Ubuntu/Debian):

sudo add-apt-repository ppa:felis/linux-mgba
sudo apt update
sudo apt install mgba

macOS:

brew install mgba

Installing VBA-M (Alternative GBA Emulator)

Windows:

1. Download VBA-M from https://github.com/visualboyadvance-m/visualboyadvance-m/releases
2. Extract and place the executable somewhere convenient
3. Note the path to visualboyadvance-m.exe

Linux:

sudo apt install visualboyadvance-m

---

📦 Installing the Skill into OpenClaw

Method 1: Via OpenClaw CLI (Recommended)

openclaw skill install pokemon-emulator

Method 2: Manual Installation

If you need to install from a local path:

openclaw skill install --source C:\path\to\pokemon-emulator

Method 3: Symlink for Development

If you're working on the skill itself:

# On Windows (PowerShell)
New-Item -ItemType SymbolicLink -Path "openclaw\skills\pokemon-emulator" -Target "C:\path\to\pokemon-emulator"

# On Linux/macOS
ln -s /path/to/pokemon-emulator ~/AppData/Roaming/openclaw/skills/pokemon-emulator

Verify Installation

openclaw skill list | Select-String pokemon
# or
openclaw skill list | grep pokemon

---

🎮 Usage Examples

Launch a Game

Game Boy / Game Boy Color:

python scripts/pyboy/launch.py "C:\ROMs\Pokemon\Pokemon - Red Version.gb"

Game Boy Advance:

python scripts/gba/launch.py "C:\ROMs\Pokemon\Pokemon - Emerald Version.gba"

Or just ask OpenClaw naturally:

• "Play Pokemon Yellow"
• "Start Pokemon Gold"
• "Launch Pokemon Emerald"

Save Your Game

# Save to slot 1
python scripts/pyboy/save_state.py "PokemonRed.gb" 1

# Save to slot 2
python scripts/pyboy/save_state.py "PokemonRed.gb" 2

Load a Save State

# Load from slot 1
python scripts/pyboy/load_state.py "PokemonRed.gb" 1

# Load from slot 2
python scripts/pyboy/load_state.py "PokemonRed.gb" 2

List Available Save Slots

python scripts/pyboy/list_states.py "PokemonRed.gb"

Take a Screenshot

PyBoy (GB/GBC):

python scripts/pyboy/screenshot.py "PokemonRed.gb" "screenshots/pokedex.png"

GBA:

python scripts/gba/screenshot.py "PokemonEmerald.gba" "screenshots/battle.png"

Or just ask OpenClaw:

• "Take a screenshot of my Pokemon game"
• "Save my game in slot 3"
• "Show me my save states for Pokemon Blue"

---

🎯 Gameplay Screenshot (PyBoy in Action)

┌─────────────────────────────────────────┐
│  ┌───────────────────────────────────┐  │
│  │                                   │  │
│  │   POKéMON RED                     │  │
│  │   ─────────────                   │  │
│  │                                   │  │
│  │   ┌─────┐                         │  │
│  │   │ ASH │  ♥♥♥♥♥♥♥♥  HP           │  │
│  │   └─────┘                         │  │
│  │                                   │  │
│  │        ┌────┐                     │  │
│  │        │BULB│                     │  │
│  │        │BASA│  Lv.5               │  │
│  │        └────┘                     │  │
│  │                                   │  │
│  │   ┌──────┐   ┌──────┐             │  │
│  │   │ POKE │   │ BAG  │             │  │
│  │   └──────┘   └──────┘             │  │
│  │                                   │  │
│  │   ┌──────┐   ┌──────┐             │  │
│  │   │ RUN  │   │FIGHT│             │  │
│  │   └──────┘   └──────┘             │  │
│  │                                   │  │
│  └───────────────────────────────────┘  │
│                                         │
│  [Arrow Keys] Move   [Z] A   [X] B      │
│  [Enter] Start       [Backspace] Select │
└─────────────────────────────────────────┘

---

📜 Supported Games

Game Boy (GB) — via PyBoy

Game Boy Color (GBC) — via PyBoy

Game Boy Advance (GBA) — via mGBA / VBA-M

⚠️ Important: ROM files are not included with this skill. You must own and provide your own legally-obtained ROM files. This skill does not distribute or encourage piracy.

---

📁 Directory Structure

pokemon-emulator/
├── README.md