Pokemon Red — OpenClaw Skill
The distributable skill is in skill/. See skill/SKILL.md for full agent instructions.
Quick Start
# Install deps
pip install pyboy pillow numpy fastapi uvicorn requests
# Start server
python scripts/emulator_server.py --save ready --port 3456
# Agent plays via HTTP API — no ai_player.py needed
# curl localhost:3456/api/state, /api/screenshot, /api/navigate, /api/press
Repo Structure
scripts/
emulator_server.py — PyBoy + FastAPI server (the game engine)
game.py — Low-level PyBoy wrapper (RAM reading, input)
navigator.py — Named-destination pathfinding
pathfinder.py — A* on scanned maps
map_scanner.py — Offline map scanning tool
skill/
SKILL.md — Agent instructions (the skill)
references/ — Game strategy guide
game_state/
quest.json — Quest progress
knowledge.json — Lessons learned, map data
maps/ — Scanned map JSON files (15 maps)
saves/ — Emulator save states
dashboard/ — Retro Game Boy web UI at localhost:3456