OpenClaw Minecraft

核心用法

OpenClaw Minecraft 是一个基于 Mineflayer 的 Minecraft 机器人控制器，通过 REST API 实现远程操控。核心工作流程包括：注册获取 JWT 令牌、创建并连接机器人、读取状态、发送 JSON 动作指令、轮询任务状态。

支持两种批量动作模式：mode: loop 用于周期性任务（如定时扫描、自动聊天），mode: until 用于条件终止任务（如移动到目标位置）。内置 15 种标准动作，涵盖移动、视角、交互、战斗等场景。

显著优点

• 纯 JSON 交互：动作指令结构化，易于 LLM 生成与解析
• 自主循环支持：通过 Gateway Cron 每 30 秒触发，无需持续心跳连接
• 批量原子操作：单次请求可包含 5-10 个动作，减少网络往返
• 安全隔离：API 密钥与 LLM 推理分离，敏感信息不流出本地
• 灵活认证：支持开放注册、代理注册、主密钥签发三种模式

潜在缺点与局限性

• 硬编码端点：依赖特定 ngrok 隧道地址，稳定性受外部影响
• 无媒体支持：暂不支持图片、音频等附件传输
• 尽力执行：动作可能因网络延迟、物品缺失、未连接状态而失败，无强一致性保证
• 并发限制：currentTaskId 机制暗示单任务队列，复杂并行场景受限
• 版本绑定：需匹配具体 Minecraft 版本（如 1.21.9）

适合人群

• Minecraft 服务器管理员，需自动化巡查、客服机器人
• 开发者构建游戏内自动化工作流（采集、建造、PvE 辅助）
• 研究 LLM 与游戏环境交互的 AI 实验者

常规风险

• 令牌泄露：JWT 长期有效，若存储不当可能导致机器人被恶意控制
• 开放注册风险：open/register 端点无密钥保护，公网暴露时易被滥用
• 游戏封号：自动化行为可能违反服务器规则或 Mojang 条款
• 依赖服务中断：ngrok 隧道变更或控制器宕机导致所有机器人离线

核心用法

OpenClaw Minecraft 是一个纯文档型 Skill，通过 Markdown 配置指导 LLM 生成 JSON 动作指令，控制 Mineflayer 驱动的 Minecraft 机器人。核心工作流包括：注册获取 JWT Token → 创建/连接机器人 → 读取状态 → 发送批量动作指令 → 轮询任务状态。支持两种自主模式：until（条件达成停止）和 loop（定时循环执行），并通过 Gateway cron 每 30 秒触发一次自主决策循环。

显著优点

1. 架构安全：LLM 在本地完成推理，仅向控制器发送 JSON 动作，API 密钥等敏感信息不会外泄
2. 零依赖风险：纯文档型 Skill，无 package.json/requirements.txt，供应链攻击面为零
3. 灵活认证：支持开放注册（Open Registration）、代理注册（Proxy Registration）和主密钥注册三种模式，适应不同安全需求场景
4. 动作丰富：内置 15+ 种标准动作（chat、move_to、dig、place、attack、follow 等），支持批量组合执行
5. 状态感知：通过 /state 端点实时获取机器人位置、背包、周围方块等上下文信息

潜在缺点与局限性

1. 网络稳定性依赖：示例使用 ngrok 临时隧道地址，不适合长期生产环境；断线后需重新连接
2. 动作执行非原子性：best-effort 执行语义意味着动作可能因网络延迟、物品缺失或碰撞检测失败而部分失败
3. 无媒体支持：当前仅支持 JSON 载荷，无法处理游戏内截图、音频或其他二进制数据
4. T3 来源风险：个人开发者维护，缺乏企业级 SLA 保障，更新节奏和长期维护存不确定性
5. Minecraft 版本绑定：需明确指定协议版本（如 1.21.9），版本不匹配会导致连接失败

适合人群

• Minecraft 自动化测试开发者
• 游戏 AI 行为研究者和 Bot 开发者
• 需要批量管理游戏账号的社区服管理员
• 希望快速原型验证 LLM + 游戏交互的爱好者

常规风险

• Token 泄露风险：MC_CONTROLLER_TOKEN 需妥善保管，泄露后他人可控制你的机器人
• 服务器封禁风险：自动化行为可能触发 Minecraft 服务器的反作弊机制
• 资源消耗风险：cron 驱动的自主循环若配置不当，可能导致高频 API 调用和服务器负载
• 动作冲突风险：多任务并行时需注意 queue vs replace 模式选择，避免指令互相覆盖