说句“给我建个房子“，AI 真的去砍树了：AIRI 的 Minecraft 游戏 Agent 本地部署完整指南

说句给我建个房子AI 真的去砍树了AIRI 的 Minecraft 游戏 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你在聊天框里敲下build me a house屏幕另一头的角色真的转过身走向最近的树开始挥镐。砍完还会自己合成木板然后搭起第一排墙。背后干活的是开源项目 AIRI 的 Minecraft 游戏 Agent它以玩家身份真正登录你的服务器听懂自然语言指令被打了还会本能反击。这篇文章讲清如何在本地把它跑起来再顺着一条指令的旅程拆开它听、想、动的完整链路。AIRI 的 Minecraft 机器人到底是什么AIRI 是一个自托管的 AI 虚拟伙伴项目自称 Grok Companion有网页版也有 macOS / Windows 桌面端支持实时语音聊天。Minecraft 集成模块放在 integrations/minecraft/ 目录相当于给这个伙伴在游戏世界里装了一副身体。它和调个 API 拿结果的方案不同基于 mineflayer 协议库Node.js 实现的 Minecraft 协议以普通玩家账号登录你的服务器在世界里真实存活——看到的东西、受到的伤害、做出的动作全发生在真实协议层。同时它通过 WebSocket 与 AIRI 主体保持双向通道把游戏状态和剧情摘要同步给桌面端角色让两边的她始终在一个频道上。和同类AI 玩 Minecraft演示相比它的差异点可以压缩成四条️ 理解自然语言不是固定指令表帮我收点木头这种说法就能听懂 LLM 驱动决策兼容任意 OpenAI 协议的接口地址模型可换 生存反射不经过 LLM血少自动吃、被打自动还手零 token 消耗 与 AIRI 主体双向互通游戏内事件能作为头条推回桌面端角色模块的核心是一套四层认知引擎命名借自认知科学感知、反射、意识、行动每层只管一件事靠事件总线松耦合。本地跑通机器人四步走完前置条件Node.js 环境、pnpm以及一个你能访问的 Minecraft 服务器Java 版 1.20 最佳最省事的方式是本地起一个。 克隆仓库git clone https://gitcode.com/GitHub_Trending/ai/airi然后cd airi 安装工作区依赖pnpm i 复制环境变量模板cp integrations/minecraft/.env integrations/minecraft/.env.local再按下面表格填写 启动pnpm -F proj-airi/minecraft-bot dev启动成功后机器人会同时连上 AIRI 服务与 Minecraft 服务器两端。环境变量配置表所有变量由 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游戏内昵称、服务器地址、端口airi-bot/localhost/25565BOT_AUTH认证方式offline/mojang/microsoft未设置等同离线AIRI_WS_BASEURLAIRI 服务端 WebSocket 地址ws://localhost:6121/wsAIRI_CLIENT_NAME向 AIRI 上报时使用的客户端名minecraft-botENABLE_DEBUG_SERVER/ENABLE_MCP_SERVER/ENABLE_MINECRAFT_VIEWER三个调试开关均为false两条安全提醒官方 README 里写得很直白这里原样保留不要把这个机器人连到不受信任的公开服务器——它会执行 LLM 生成的动作脚本恶意服务器可能诱导它做出损害你本地环境的行为MCP Server、Debug Server、Prismarine Viewer 三个调试端点完全没有鉴权暴露到公网等于交出远程控制务必保持三个开关默认关闭。一条指令的旅程建房子是怎么被执行的四层架构听着抽象跟着build me a house这句话走一遍就清楚了。感知层先听到给事件打标注一句话职责把 mineflayer 的原始信号翻译成类型化的事件与信号上层只消费信号。流水线是三段事件定义绑定原始回调 → 事件注册表向总线发出raw:事件 → YAML 规则引擎评估后发出派生signal:信号。最有意思的设计是规则用声明式 YAML 写而不是硬编码逻辑。看 danger/damage.yaml它规定500ms 窗口内受到任意伤害就产生一条高显著性信号伤害量、来源、距离由模板变量自动填进元数据。规则按 attention注意、danger危险、social社交三类组织想加一种新的感知丢一个 YAML 文件进去就行。反射层先动手再想肌肉记忆式的生存本能反射层用有限状态机实现——可以把它理解成身体的肌肉记忆不经过 LLM靠条件反射快速响应。建房子期间它全程站在旁边待命但一旦发生状况它比谁都快血量 ≤6 且饥饿值 18 时auto-eat.ts 立刻吃下手里最好的食物。有个细节我觉得很聪明——饥饿度 ≥18 时身体本来就在自然回血这时吃东西纯属浪费所以被刻意排除。同类行为还有被攻击自动还手、逃离致命威胁生存反射的优先级分被设为 1000压过一切待机动作因为活着比什么都重要。另一个关键机制叫抑制反射层处理完一件事后会向意识层发出 Inhibition 信号相当于说这事我接手了你不用管LLM 就不会为同一件事再被白白叫醒一次。意识层执笔LLM 写的是脚本不是 JSON感知层把建房子事件递上来后brain.ts 里的 Brain 接管它编排事件队列、管理 LLM 轮次生命周期还守着安全与预算的护栏。最出格的设计是 JavaScript PlannerLLM 不输出传统的工具调用 JSON而是直接写一段可执行 JavaScript在 isolated-vm 沙箱一个把代码关进隔离房间里运行的环境中执行表达能力远超 Function Calling。系统提示词 prompts/brain-prompt.md 要求 Agent 在投入长任务前先核实关键假设——先看清再动手避免想当然操作。沙箱里还配了 Query DSL只读的世界查询运行时可以链式查询方块、实体、物品栏甚至调query.map()生成一张 ASCII 俯视图让 AI 用字符看到周围地形。行动层只管做最后一公里行动层把想和做物理隔开Task Executor 逐条执行规范化动作指令并发出生命周期事件Action Registry 负责参数校验与工具分发工具目录则绑定 src/skills/ 下的原子技能——挖矿collect-block.ts、伐木gather-wood.ts、合成crafting.ts、战斗combat.ts、寻路移动movement.ts基于 mineflayer-pathfinder 寻路插件。砍树 → 合成木板 → 砌墙这个建造循环全程由 Task Executor 驱动。整条链路简化下来就是这样聊天build a house → 感知层给事件打标注 → 意识层 Brain 规划结构、生成沙箱脚本 → 行动层跑建造循环伐木 → 合成 → 搭建→ Brain 确认完成用notifyAiri把房子建好了这条头条推给桌面端 AIRI。三个观察窗口让 AI 当众思考debug 目录src/debug/内置了三个观察窗口一一对应 .env 里的三个开关Debug DashboardENABLE_DEBUG_SERVERtrue打开本地网页能实时看到认知状态、对话记录与动作执行相当于全程围观的旁听席。MCP REPLENABLE_MCP_SERVERtrue手动往 Brain 里注入一段 JavaScript 脚本相当于亲自扮演上帝之手观察 Agent 接下来会做什么。Prismarine ViewerENABLE_MINECRAFT_VIEWERtrue在浏览器里打开机器人的第一人称视角它看到什么你看到什么。再啰嗦一遍三个窗口都没有鉴权只在可信的本地网络里开。仓库的codex-skills/minecraft-debug-mcp/目录还沉淀了一套 MCP 调试工作流文档卡住的时候先翻它省不少时间。Mineflayer 方案的走向以及你可以做什么最后说点实话官方 README 明确标注 Mineflayer 这条路线处于弃用过渡期未来的主要 Minecraft 集成形态将是 Fabric Mod 运行时。所以如果你有长期项目规划别把架构押注在这个运行时上。但这不妨碍这套四层设计的参考价值感知、反射、意识、行动各管一段事件松耦合新增能力靠加文件完成。对任何想做游戏 Agent 的人让 AI 有感官、有本能、有理性、有手脚已经是一张现成的施工图纸。把仓库克隆下来本地起个服务器对它说句build me a house——比看一百张架构图都直观。【免费下载链接】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），仅供参考