Pokemon Red — 你就是训练家

你直接游玩《Pokemon Red》，不经过任何中间脚本。你启动模拟器服务端，通过其 HTTP API 获取游戏画面截图与状态，观察屏幕，决定操作，再将指令发回。

初始设置（首次运行）

克隆仓库并安装依赖：

git clone https://github.com/drbarq/Pokemon-OpenClaw.git
cd Pokemon-OpenClaw
pip install pyboy pillow numpy fastapi uvicorn requests
# 将你合法获取的 ROM 文件置于 ./PokemonRed.gb

将环境变量 POKEMON_DIR 设置为你克隆该仓库的路径（默认值：~/Code/pokemon-openclaw）。

启动一个会话

# 启动模拟器服务端（后台进程）
cd $POKEMON_DIR && python scripts/emulator_server.py --save ready --port 3456

回合流程

每回合请按顺序执行以下步骤：

1. 获取状态 + 截图

curl -s http://localhost:3456/api/state
curl -s http://localhost:3456/api/screenshot -o /tmp/pokemon_current.png

然后使用 image 工具查看截图。务必先看再操作。

2. 决策：使用 navigate 还是手动控制？

旅行时请优先使用 navigate —— 它会阻塞，直到抵达目的地、遭遇野生宝可梦战斗或卡住为止：

curl -s -X POST http://localhost:3456/api/navigate 
  -H 'Content-Type: application/json' 
  -d '{"destination": "Viridian City"}'

navigate 返回以下状态之一：

• "status": "arrived" —— 已抵达！继续推进任务。
• "status": "battle" —— 途中遭遇野生宝可梦战斗中断。完成战斗后，再次调用 navigate。
• "status": "stuck" —— 无法到达目标地点。尝试手动按键操作，或更换路线。
• "status": "error" —— 目标名称无效或无可用路径。请检查支持的目的地列表。

响应中始终包含完整的游戏状态，因此你能精确了解当前所处位置。

重要提示：navigate 是阻塞式调用，请为 curl 设置较长超时（60–120 秒）。

首次使用前，请先查询可用目的地：

curl -s http://localhost:3456/api/destinations

查询哪些地图已配置路径规划数据：

curl -s http://localhost:3456/api/maps

仅在以下情况才回退至手动按键控制：

• navigate 返回 "stuck" 或 "error"
• 你在建筑内部执行特定交互（如与 NPC 对话、开门等）
• 你正处于对话界面或菜单界面

3. 手动控制（按需使用）

# 移动 / 交互
curl -s -X POST http://localhost:3456/api/press 
  -H 'Content-Type: application/json' 
  -d '{"buttons": ["up","up","a"], "reasoning": "Walking to door"}'

有效按键包括：up、down、left、right、a、b、start、select。每次最多发送 1–5 个按键指令。

4. 战斗（当 state 中 in_battle 为 true 时）

• 战斗：按 a 打开战斗菜单，再按 a 选择 FIGHT，方向键选择招式，a 确认，之后持续按 a 跳过动画
• 逃跑：按 a，再按 down、right、a 选择 RUN，之后持续按 a 跳过文本
• 战斗后检查 state —— 若仍为 in_battle，则重复上述流程

5. 任务追踪

curl -s http://localhost:3456/api/quest                    # 当前任务目标
curl -s -X POST http://localhost:3456/api/quest/complete 
  -H 'Content-Type: application/json' 
  -d '{"lesson": "Door is at x=12"}'                      # 推进任务步骤 + 保存经验

6. 频繁保存

curl -s -X POST http://localhost:3456/api/command 
  -H 'Content-Type: application/json' 
  -d '{"command": "save", "name": "checkpoint_viridian"}'

关键接口端点

策略优先级

1. 优先使用 navigate。 所有移动类操作均应首选 /api/navigate。它会阻塞直至抵达或触发战斗，无需轮询。
2. 立即处理战斗。 若 navigate 返回 "status": "battle"，请立即战斗（狂按 A），结束后再次对同一目的地调用 navigate。
3. 随时确认任务进度。 始终清楚当前任务目标，避免无目的游荡。
4. 管理 HP。 HP 低于 30% 时考虑治疗；低于 15% 时必须治疗。使用 navigate 前往最近的宝可梦中心。
5. 忽略 text_active 标志。 文本检测标志存在缺陷（恒为 true）。切勿反复按 B 键试图跳过“幻影”文本。
6. 频繁保存。 每 10 回合，或达成任一里程碑后立即保存。

会话模式

一个子代理（sub-agent）会话应包含以下环节：

1. 启动模拟器服务端（若尚未运行）
2. 检查任务状态与可用目的地
3. 执行 20–50 回合（按需调用 navigate 与手动控制）
4. 退出前保存当前状态
5. 汇报进展（当前位置、等级、任务步骤、关键亮点等）

可在 /tmp/pokemon_notepad.txt 中记录笔记，以保障单次会话内的上下文连续性。

完整游戏策略参考

详见 references/game_instructions.md，其中涵盖《Pokemon Red》基础内容：移动机制、建筑交互、门的开启、战斗流程、属性相克、治疗方式以及任务系统说明。