看AIRI自己玩Minecraft开源AI游戏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/airi想让一个AI 游戏 Agent像真人一样进入《Minecraft》世界里砍树、挖矿、合成工具甚至在被袭击时本能地反击开源项目AIRI就做到了。AIRI 是一个自托管、完全由你拥有的 AI 虚拟伙伴自称Grok Companion支持实时语音聊天、网页 / macOS / Windows 多端运行而它的 Minecraft 集成模块位于 integrations/minecraft/内置了一套受认知科学启发的四层认知架构让 AI 从感知到行动完整闭环。这篇文章带你从零搭建本地服务器并逐层拆解这套 AI 游戏 Agent 的设计秘密。一分钟认识 AIRI 的 Minecraft AgentAIRI 的 Minecraft 机器人并不是简单地调用 API而是基于 mineflayer 协议库Node.js 实现真正登录你的 Minecraft 服务器以一个可感知的角色身份存活。它的核心能力包括️理解自然语言指令对机器人说帮我建一座房子它会规划、采集木材、合成木板、搭建墙体LLM 驱动决策默认使用 DeepSeek 等 OpenAI 兼容模型可配置任意兼容 API⚡无需 LLM 的生存本能血量过低自动吃东西、被攻击自动反击——零 token 消耗双向连接 AIRI 主体通过 WebSocket 把游戏状态、剧情摘要上报给桌面端 AIRI 角色服务入口在 integrations/minecraft/src/main.ts它在启动时完成三件事读取配置、连接 AIRI 服务器、创建受管理的 Mineflayer 机器人自动重连、加载 6 个 mineflayer 插件。一键搭建本地服务器运行步骤前置准备你需要一个可以访问的 Minecraft 服务器Java 版 1.20 最佳最简单的做法是本地启动# 1. 克隆仓库 git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi # 2. 安装依赖pnpm 工作区 pnpm i配置环境变量复制模板并编辑.env.local模板在 integrations/minecraft/.envcp integrations/minecraft/.env integrations/minecraft/.env.local关键配置项均由 composables/config.ts 中的 Zod Schema 严格校验变量说明OPENAI_API_KEY/OPENAI_API_BASEURLLLM 密钥与接口地址兼容任意 OpenAI 协议服务OPENAI_MODEL/OPENAI_REASONING_MODEL对话模型与推理模型默认 deepseek-chat / deepseek-reasonerBOT_USERNAME/BOT_HOSTNAME/BOT_PORT机器人名、服务器地址、端口默认 25565BOT_AUTH认证方式offline/mojang/microsoftAIRI_WS_BASEURLAIRI 服务端 WebSocket 地址默认ws://localhost:6121/wsENABLE_MCP_SERVER等调试开关默认全部关闭启动服务pnpm -F proj-airi/minecraft-bot dev启动后机器人会自动连接 AIRI 与 Minecraft 服务器双端。⚠️ 官方 README.md 特别强调安全事项请勿连接不受信任的公开服务器——该 Agent 会执行 LLM 生成的 JavaScript 动作脚本恶意服务器可能诱导机器人做出危险操作。另外MCP Server、Debug Server、Prismarine Viewer 三个调试端点均无鉴权切勿暴露到公网。核心揭秘四层认知架构AIRI 的 Minecraft Agent 架构参考了认知科学分为感知 → 反射 → 意识 → 行动四层各层职责清晰、事件驱动、松耦合。第 A 层感知Perception—— 机器人的感官神经源码位置src/cognitive/perception/感知层把 mineflayer 的原始信号受伤、掉血、实体移动、聊天消息等翻译成类型化的事件。它的流水线是事件定义events/definitions/*→ 事件注册表发出raw:模态:类型事件 → YAML 规则引擎rules/评估并发出派生signal:*信号。规则用声明式 YAML 编写例如 danger/damage.yaml 定义了500ms 窗口内受到任意伤害即产生高显著性信号附带伤害量、来源、距离等元数据。规则按attention注意、danger危险、social社交分类组织新增感知能力只需加一个 YAML 文件。第 B 层反射Reflex—— 不花 token 的生存本能源码位置src/cognitive/reflex/反射层基于有限状态机FSM实现膝跳反应典型行为包括自动进食behaviors/auto-eat.ts血量 ≤6 且饥饿值 18 时立刻吃最好吃的食物——注意细节饱食度 ≥18 时身体已在自然回血此时吃东西纯属浪费所以被刻意排除️防御反击defend.ts被攻击时自动反击逃离危险escape-hazard.ts规避致命威胁关键设计是抑制机制反射层可以向意识层发送 Inhibition 信号阻止 LLM 做出冗余决策。生存反射优先级最高score1000覆盖一切待机行为——毕竟活着比做事重要。第 C 层意识Conscious—— LLM 推理大脑源码位置src/cognitive/conscious/这是最像人的一层由几个核心部件组成Brainbrain.ts事件队列编排、LLM 轮次生命周期、安全/预算守卫JavaScript Plannerjs-planner.tsLLM 不直接输出工具调用 JSON而是输出可执行的 JavaScript 脚本在 isolated-vm 沙箱中运行——灵活性远超传统 Function CallingQuery DSLquery-dsl.ts只读的世界查询运行时Agent 可以链式查询方块、实体、物品栏甚至用query.map()生成 ASCII 俯视图看周围地形Task State任务取消令牌与生命周期管理系统提示词见 prompts/brain-prompt.md信息量极大几个亮点设计值优先规则先执行纯观察轮不触发任何世界动作下一轮才基于确认过的数据行动避免想当然操作沙盒全局变量self自身血量/坐标、mem跨轮记忆、llmLog历史轮日志环形缓冲、actionQueue实时动作队列AIRI 通信通道notifyAiri()上报紧急事件、updateAiriContext()推送持久上下文让游戏内 Agent 与桌面端 AIRI 角色形成双线叙事第 D 层行动Action—— 思考与执行分离源码位置src/cognitive/action/行动层把想和做彻底隔离Task Executortask-executor.ts执行规范化动作指令发出生命周期事件Action Registryaction-registry.ts参数校验 工具分发工具目录llm-actions.ts绑定到 mineflayer skills 的工具 Schema原子技能实现在 src/skills/ 下挖矿collect-block.ts、伐木gather-wood.ts、合成crafting.ts、战斗combat.ts、移动导航movement.ts内置 A* 寻路会自动挖开挡路的方块——Agent 从地底爬出地表只需一次goToCoordinate调用。事件流实例建一座房子玩家: build a house ↓ [感知层] 检测聊天事件 ↓ [意识层] Brain JS Planner 规划结构 ↓ [行动层] TaskExecutor 管理建造循环 ① 采集木材 → ② 合成木板 → ③ 搭建墙体 ↓ [意识层] Brain 确认完成notifyAiri(房子建好了)调试工具亲眼见证 AI 的思考AIRI 提供了强大的本地调试面板src/debug/Debug DashboardENABLE_DEBUG_SERVERtrueWeb 界面实时查看认知状态、对话记录、动作执行MCP REPLENABLE_MCP_SERVERtrue手动向 Brain 注入 JavaScript 脚本模拟神之手观察 AI 行为Prismarine ViewerENABLE_MINECRAFT_VIEWERtrue在浏览器中以第一人称观看机器人视角的世界还有 codex-skills/minecraft-debug-mcp/ 中沉淀的调试技能文档记录了一套完整的 MCP 调试工作流。项目结构与延伸阅读模块路径职责认知引擎入口src/cognitive/index.ts四层组件的装配与生命周期依赖注入容器src/cognitive/container.tsAwilix DI 接线AIRI 桥接src/airi/airi-bridge.ts状态/指令双向同步机器人运行时src/minecraft-bot-runtime.ts重连、热重配置官方文档integrations/minecraft/README.md完整架构说明与部署指南写在最后需要说明的是当前 Mineflayer 方案处于弃用过渡期官方计划以 Fabric Mod 运行时作为未来的主要 Minecraft 集成形态详见 README 的 Deprecation Notice。但正因为架构分层清晰感知/反射/意识/行动相互解耦这套四层认知设计仍值得每个想构建 AI 游戏 Agent 的开发者参考——让 AI 有感官、有本能、有理性、有手脚这正是 AIRI 向 Neuro-sama 高度发起冲击的技术底牌。【免费下载链接】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），仅供参考