让 AI 真正登录 Minecraft：AIRI 游戏 Agent 的本地部署与认知架构拆解

让 AI 真正登录 MinecraftAIRI 游戏 Agent 的本地部署与认知架构拆解【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airiAIRI 是一个自托管、归你所有的 AI 虚拟伙伴项目Grok Companion支持实时语音聊天与 Web / macOS / Windows 多端运行。而它最有野心的集成是 integrations/minecraft/ 下的 Minecraft Agent基于 mineflayer 协议库真正登录你的服务器以一个有血量、饥饿值、物品栏的角色身份存活——不是调 API 的聊天壳而是一个会砍树、挖矿、合成、被袭击时本能反击的活人。服务入口在 src/main.ts启动时干三件事用 Zod 严格校验环境变量、经 WebSocket 连上 AIRI 服务端、创建受管理的 Mineflayer 机器人自动重连并挂载寻路、PVP、工具、采集、护甲管理等 6 个插件。它的行为由感知 → 反射 → 意识 → 行动四段闭环驱动事件驱动、层间松耦合。下面先跑起来再顺着一条信号倒推这套架构。5 分钟跑通本地 Minecraft 机器人前置条件一台能访问的 Minecraft 服务器Java 版 1.20 最佳本地开个单人生服最省事、已安装 pnpm、任意一个 OpenAI 兼容协议的 LLM 密钥DeepSeek 官方 API 即可。克隆仓库并安装工作区依赖git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi pnpm i成功标志根目录生成node_modules工作区各包链接完成、无报错退出。复制配置模板填入密钥和服务器地址cp integrations/minecraft/.env integrations/minecraft/.env.local成功标志.env.local已生成模板文件原样保留。关键配置项均由 composables/config.ts 的 Zod Schema 强校验变量作用默认值必填OPENAI_API_KEYLLM 密钥无是OPENAI_API_BASEURLOpenAI 兼容接口地址无是OPENAI_MODEL对话模型deepseek-chat是OPENAI_REASONING_MODEL推理模型deepseek-reasoner是BOT_USERNAME机器人名airi-bot否BOT_HOSTNAME/BOT_PORT服务器地址 / 端口localhost/25565否BOT_AUTH认证方式offline/mojang/microsoft离线否BOT_VERSION游戏版本1.20否AIRI_WS_BASEURLAIRI 服务端 WebSocket 地址ws://localhost:6121/ws否ENABLE_DEBUG_SERVER等三个调试端点开关false否启动服务pnpm -F proj-airi/minecraft-bot dev成功标志日志显示同时连上了 AIRI 与 Minecraft 双端进游戏能看到机器人名。⚠️ 两条安全红线必须单独强调其一不要把这个机器人连到你不受信任的公开服务器——它会执行 LLM 生成的 JavaScript 动作脚本来驱动真实本地进程恶意服务器可能诱导它做出危险操作其二MCP Server、Debug Server、Prismarine Viewer 三个调试端点完全无鉴权据 README 描述暴露出去可直接导致远程代码执行切勿对公网开放。一条受伤信号的四站旅程感知与反射解决了什么架构不用第几层来记换个思路一条事件从产生到被消费要过哪几站。以机器人掉了 4 格血为例。感知站要解决的问题是mineflayer 抛出的原始信号杂乱、无类型。所以 src/cognitive/perception/ 里先把受伤、实体移动、聊天等信号绑定为类型化事件事件注册表以raw:模态:类型的格式发到认知事件总线接着是声明式 YAML 规则引擎评估并发出派生的signal:*信号。比如 danger/damage.yaml 定义500ms 窗口内受到任意伤害即产生一条高显著性信号附带伤害量、来源、距离等元数据。规则按 attention / danger / social 三类组织——新增一种感知能力只要加一个 YAML 文件。反射站要解决的问题是要命的情况等不起 LLM既慢又烧 token。src/cognitive/reflex/ 用有限状态机实现膝跳反应自动进食、被攻击反击、逃离致命威胁。最典型的是 auto-eat.ts血量 ≤6 且饱食度 18 才立刻吃最好吃的食物——饱食度 ≥18 时身体已在自然回血此时进食纯属浪费所以被刻意排除。生存反射打分 1000 分压过一切待机行为毕竟活着比做事重要。关键设计是抑制机制反射层可以向意识层发 Inhibition 信号阻止 LLM 做出冗余决策。意识与行动LLM 写 JavaScript执行层只管动手意识层是这台 Agent 最像人的部分核心在 conscious/brain.ts负责事件队列编排、LLM 轮次生命周期和安全/预算守卫。它有个反常识的决策——LLM 不直接输出工具调用 JSON而是输出一段可执行的 JavaScript 脚本在 isolated-vm 沙箱里跑见 js-planner.ts。灵活性远超传统 Function Calling代价是需要认真做沙箱。沙箱里有一套只读世界查询运行时 query-dsl.ts链式查询方块、实体、物品栏甚至query.map()能生成 ASCII 俯视图让 Agent 真的能看周围地形。跨轮记忆也值得看沙箱全局变量self自身血量/坐标、mem跨轮记忆、llmLog历史轮日志、actionQueue实时动作队列每轮刷新。系统提示词prompts/brain-prompt.md里还有一条值优先规则先跑纯观察轮确认数据下一轮才动手避免想当然操作。另外notifyAiri()与updateAiriContext()两个通道把游戏内的剧情摘要推给桌面端 AIRI 角色形成双线叙事——你在 Stage 里看到的伙伴和游戏里的 Agent 是同一个灵魂。行动层把想和做彻底隔离action/task-executor.ts 执行规范化动作指令并发生命周期事件action-registry.ts 做参数校验与分发llm-actions.ts 维护绑定到技能层的工具目录。原子技能都在 src/skills/挖矿、伐木、合成、战斗、移动导航。其中 movement 内置 A* 寻路且会自动挖开挡路的方块——Agent 从地底爬出地表只需一次goToCoordinate调用。build a house一次完整交互的跨层事件流回放把前面的零件拼起来玩家在服务器里对机器人说一句话之后事件总线上的旅程大致是玩家: build a house ↓ [感知] 聊天消息 → 类型化事件规则引擎派生 signal ↓ [意识] Brain 先跑观察轮query 确认木材来源再规划结构 ↓ [行动] TaskExecutor 管理建造循环采集木材 → 合成木板 → 搭墙 期间若掉血[反射] 进食/反击可随时通过 Inhibition 接管 ↓ [意识] 确认完成notifyAiri(房子建好了) → 桌面端 AIRI 同步剧情整条链路没有一层直接调下一层的私有接口全部走事件任何一站挂了其他站不受牵连。三个调试面板亲眼看 AI 的决策过程光读架构不够这个项目把看见 AI 在想什么做成了产品。src/debug/ 下三个端点各对应一个环境变量开关默认全关面板开关用途Debug DashboardENABLE_DEBUG_SERVERtrueWeb 界面实时看认知状态、对话记录、动作执行MCP REPLENABLE_MCP_SERVERtrue手动向 Brain 注入 JavaScript 脚本神之手干预观察Prismarine ViewerENABLE_MINECRAFT_VIEWERtrue浏览器第一人称观看机器人视角的世界minecraft-debug-mcp/SKILL.md 里还沉淀了一套完整的 MCP 调试工作流文档照着走就能复现注入脚本 → 观察动作队列 → 校验世界状态的排查闭环。再次提醒这三个端点无鉴权开完记得关。弃用路线图、安全红线以及这套设计的迁移价值诚实交代现状据 README 的 Deprecation Notice当前 Mineflayer 机器人处于弃用过渡期官方计划以 Fabric Mod 运行时作为未来主要的 Minecraft 集成形态不建议围绕 Mineflayer 堆长期功能。安全上把它严格当作本地开发 可信服务器工具使用。那么对一个想自建游戏 Agent 的人这套分层的价值在哪答案不依赖 Minecraft感知用声明式规则描述感官、反射用状态机兜住生死线、意识用沙箱脚本承载推理、行动独立执行并反馈——任何实时互动场景桌游、模拟经营、甚至具身机器人都能直接套用这个事件走总线、本能不烧钱、思考与动手分离的骨架。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考