OpenClaw Minecraft

核心功能

OpenClaw Minecraft 是一款基于 Mineflayer 的 Minecraft 机器人控制器技能，允许用户通过 REST API 以 JSON 格式发送动作指令，实现对游戏 bot 的远程操控。核心能力包括：创建/连接 bot、读取实时状态、发送单条或批量动作指令，以及支持 Cron 驱动的自主行为循环。

显著优点

• 纯 JSON 接口：LLM 本地推理后仅发送结构化动作，避免敏感信息泄露
• 批量任务编排：单次请求可包含 5-10 个动作，支持 until（条件终止）和 loop（定时循环）两种模式
• 自主循环能力：配合 Gateway Cron 每 30 秒触发，无需持续心跳连接即可维持 bot 自主运行
• 灵活认证体系：支持开放注册、代理注册和主密钥注册三种模式，适应不同安全需求

潜在局限

• 仅支持 JSON 载荷，暂不支持媒体文件或附件传输
• 动作为尽力而为（best-effort），bot 未连接或物品不足时可能失败
• 依赖外部 ngrok 隧道，连接稳定性受网络环境影响
• 多 bot 场景下需自行管理 token 和状态同步

适用人群

Minecraft 服务器管理员、游戏自动化开发者、多账号农场运营者，以及希望通过 LLM 编排复杂游戏行为的 AI 应用开发者。

常规风险提示

• 开放注册模式会降低安全性，建议生产环境使用代理或主密钥模式
• 严禁将 LLM API 密钥发送至控制器端点
• 需确保仅操控归属本 token 的 bot，避免越权操作
• ngrok 免费域名可能变更，需关注地址可用性

核心用法

OpenClaw Minecraft 是一个纯文档型配置技能，无可执行代码，通过标准化 REST API 与外部 Mineflayer 控制器通信，实现 Minecraft 机器人的创建、连接与自动化控制。

使用流程：
1. 身份注册：通过开放注册或代理模式获取 JWT Token，建议存储至 memory/mc-auth.json 复用
2. 机器人管理：调用 /v1/bots 创建机器人，使用 /v1/bots/{botId}/connect 连接至指定 Minecraft 服务器
3. 状态感知：通过 /v1/bots/{botId}/state 获取当前位置、背包、任务状态等上下文
4. 动作执行：以 JSON 批量提交 5-10 个动作（chat、move_to、dig、place、attack 等），支持 until（条件终止）和 loop（定时循环）两种模式
5. 自动化循环：结合 Gateway Cron 每 30 秒执行，读取状态→决策→发送动作批次，实现无人值守的自主行为

显著优点

• 架构清晰：LLM 本地推理仅输出 JSON 动作，敏感凭证（API Key）不上传至控制器
• 批量高效：单请求可打包多步骤动作，减少网络往返
• 灵活模式：until 模式适合导航等目标导向任务，loop 模式适合扫描、聊天等周期性行为
• 队列友好：支持 queue 模式追加任务，避免中断正在执行的操作

潜在缺点与局限性

• 外部依赖脆弱：核心功能完全依赖 ngrok 动态域名（56eb-125-246-120-211.ngrok-free.app），免费域名会随会话过期或变更，服务可用性无保障
• T3 来源风险：个人开发者维护，无知名组织背书或第三方安全审计
• 无代码执行：纯文档型技能，若外部 API 失效则功能完全瘫痪
• 动作黑盒：动作执行由远端控制器处理，失败原因需通过状态轮询间接获知

适合人群

• 需要快速原型验证 Minecraft 自动化脚本的开发者
• 拥有私有 Minecraft 服务器且接受自行搭建/托管 Mineflayer 控制器的用户
• 熟悉 REST API 调试、能接受 ngrok 临时域名局限性的技术用户

常规风险
1. 域名接管风险：ngrok 免费域名过期后可能被他人注册用于钓鱼
2. 凭证泄露：JWT Token 持久化存储于 memory/ 目录，多用户环境需严格权限控制
3. 服务器不可信：无法验证 ngrok 隧道后端的真实归属，存在中间人攻击可能（虽使用 TLS）
4. 行为失控：自动化循环若配置不当，可能导致机器人在游戏内异常行为（如无限挖掘、骚扰玩家）