AIRI Minecraft Bot 完整指南：用自然语言指挥 LLM 驱动的 Minecraft 机器人

AIRI Minecraft Bot 完整指南用自然语言指挥 LLM 驱动的 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在本地 Minecraft 服务器里输入#follow名为 AIRI 的机器人会实时寻路跟在你身后再发一句自然语言的建造或采集指令它会自己规划路线、砍树、合成、放方块。AIRIai-mo/airi是一个自托管的 LLM 虚拟角色系统除了 Web、macOS、Windows 端上的虚拟形象和实时语音对话它内置了一个基于 MineflayerMinecraft 协议客户端库的机器人服务让角色真正走进 3D 游戏世界执行任务。定位一个会接活的 Minecraft 智能机器人它不是传统意义上按脚本走的 MC 机器人而是一个感知—决策—行动全链路打通的智能体聊天指令与游戏内事件进入感知层由 LLM 在意识层生成可执行计划再由行动层调用寻路、战斗、建造等技能落到游戏里。你只需要下达意图中间的过程拆解由它完成。能力拆解指令进来动作出去跟随与移动#follow发出去机器人就走过来以聊天框里以#开头的消息作为指令入口普通聊天不会触发指令解析输入#follow后机器人开始跟随发送者#stop立即停止。底层是 src/skills/movement.ts 中的goToPosition配合 mineflayer-pathfinder 寻路插件目标坐标校验、地面自动抬升一格、按进度回调失败时会返回带原因的结构化结果而不是静默卡住。自保反击被打先还手血量低先吃食物机器人受击、掉血、低血量都会生成事件信号由 src/cognitive/perception/ 下的 YAML 规则引擎判定再交给反射层行为执行装备武器、寻路接近、发起攻击src/skills/combat.ts低血量时自动进食、逃离危险源src/cognitive/reflex/behaviors/。这条链路不依赖 LLM 思考所以反应快、开销小。采集与合成一句找些木头触发多步计划帮我找些木头这类指令由意识层拆解为多步动作定位最近的树、依次砍伐src/skills/actions/gather-wood.ts、把物品按类别归入背包src/skills/inventory.ts、需要时自动合成木板等中间产物src/skills/crafting.ts。建造从建个房子到方块落地README 给出的事件流示例很能说明问题Build a house 一条指令感知层检测到事件意识层的规划者拆出采集木材、合成木板、搭建墙体三个步骤行动层逐步执行完成后回到聊天确认。建筑逻辑集中在 src/skills/blocks.ts方块类型匹配由 src/skills/actions/block-type-normalizer.ts 归一化处理避免橡木原木和原木这类叫法差异导致执行失败。实现思路四层认知架构整个服务按认知科学分成四层代码边界清晰可按层定位问题感知层src/cognitive/perception/Mineflayer 原始信号 → 事件注册表 → YAML 规则 → 派生信号纯数据管道反射层src/cognitive/reflex/有限状态机驱动的快速反应可向上层发出抑制信号避免重复触发 LLM意识层src/cognitive/conscious/brain.ts负责 LLM 回合编排与预算保护js-planner.ts在隔离沙箱中执行 LLM 生成的 JS 计划脚本query-dsl.ts提供只读的世界/背包/实体查询行动层src/cognitive/action/task-executor.ts执行计划并广播生命周期事件action-registry.ts做参数校验与工具分发事件总线 src/cognitive/event-bus.ts 贯穿四层任何一层的行为都可以被观测到这也是调试面板能工作的前提。上手路径安装检查清单环境要求Node.js 23 与 pnpm仓库为 pnpm workspace一台本地 Minecraft 服务器默认协议版本 1.20任意 OpenAI 兼容的 LLM 端点支持自定义OPENAI_API_BASEURL已启动的 AIRI 服务机器人通过 WebSocket 向 AIRI 回传状态与指令配置项说明integrations/minecraft/.env复制为.env.local后修改配置项作用示例OPENAI_API_KEY/OPENAI_API_BASEURLLLM 密钥与端点地址必填OPENAI_MODEL/OPENAI_REASONING_MODEL对话模型 / 推理模型deepseek-chatBOT_USERNAME/BOT_HOSTNAME/BOT_PORT机器人身份与服务器地址localhost25565BOT_VERSION协议版本1.20AIRI_WS_BASEURL/AIRI_CLIENT_NAME连回 AIRI 的 WebSocket 地址ws://localhost:6121/wsENABLE_MCP_SERVER等三项调试端点开关保持false首次验证步骤克隆仓库并安装依赖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 服务器进游戏在聊天框发#follow机器人应开始跟随再发#stop移动立即停止适用边界与常见问题这是过渡期服务README 明确标注 Mineflayer 机器人处于弃用路线上官方计划由 Fabric mod 运行时接管 Minecraft 集成不建议在其上构建长期功能仅限可信服务器动作计划在隔离沙箱中执行但仍驱动一个真实本地进程官方安全提示要求不要连接不可信的公开服务器调试端口无鉴权MCP、Debug Server、Viewer 三个端点开启后不校验身份只在本机使用切勿暴露到公网必填项缺失会直接报错配置由 zod 严格校验src/composables/config.tsOPENAI_API_KEY、OPENAI_MODEL等留空时启动即失败这是特性不是 bug便于排查指令范围有限#follow/#stop是插件层硬编码指令其余能力走 LLM 规划效果随所选模型能力浮动建议从本地单人服务器开始先验证跟随与自保这类基础行为再逐步交给它采集和建造任务接入新环境前先在 README 中核对弃用与安全两节的最新说明。版本说明以上路径与配置项基于仓库当前快照的integrations/minecraft/工作区功能细节以该目录下的 README 与.env模板为准。【免费下载链接】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），仅供参考