Minecraft 智能体原理：Mineflayer 与 WebSocket 通道

部署之前值得花五分钟搞懂 AIRI 的 Minecraft 智能体是怎么工作的——排错时你会感谢这段原理。

三个角色

1. AIRI 本体（桌面版）：她的「大脑宿主」，对话、决策都在这。
2. Minecraft 机器人服务：从 AIRI 仓库源码运行的一个独立服务，是「玩游戏的身体」。
3. Minecraft 服务器：本地或可信的联机服务器，游戏发生的地方。

两条连接线

• 机器人 ↔ Minecraft 服务器：通过 Mineflayer（一个知名的 Minecraft 机器人框架）登录服务器，像真人玩家一样收发游戏内事件、执行动作（移动、挖矿、建造）。
• 机器人 ↔ AIRI 本体：通过 WebSocket 通道连到 AIRI 桌面版的「连接」端口（本地默认端口 6121 的 ws 通道），把游戏上下文送给模型决策，再把决策翻译成游戏动作。

所以流程是：游戏里发生的事 → 机器人感知 → WebSocket 交给 AIRI → 模型决策 → 机器人执行。在游戏里发文字就能和她交互。

两个现状要点

• 迁移预告：官方文档注明当前实现正计划迁移到 Fabric 运行时，不建议围绕现有实现开发长期功能——普通部署使用不受影响。
• 离线登录为默认：机器人默认以离线模式登录服务器；需要正版登录时，配置文件里有说明项。

安全提醒（官方原文精神）

不要把她连到不受信任的公共服务器：机器人驱动着本地会话与网络连接，恶意服务器可能造成非预期行为。只连本地或自己可信的服务器。

接下来

• 原理懂了就动手：env 配置逐项解释。
• 相对轻量的智能体玩法：社群机器人。