核心用法
OpenClaw Minecraft 技能为 Minecraft 自动化提供了一套完整的机器人控制方案。该技能基于 Mineflayer 控制器 API，采用纯 JSON 动作指令进行通信，支持通过 HTTP REST 接口创建、连接和管理 Minecraft 机器人。
主要功能模块：
1. 身份认证系统：提供三级注册模式——开放注册（agent 自助获取 token）、代理注册（proxyKey 白名单机制）、以及主密钥注册（operator 手动签发 JWT），适应不同安全场景。
2. 机器人生命周期管理：通过 /v1/bots 端点创建机器人实例，/v1/bots/{botId}/connect 建立服务器连接，支持自定义服务器地址、端口和游戏版本。
3. 状态感知与动作执行：GET /bots/{botId}/state 实时读取机器人状态（位置、库存、当前任务等），POST /bots/{botId}/act-batch 发送批量动作指令，单次支持 5-10 个动作。
4. 双模式任务调度：
mode: until— 条件驱动，适用于导航、挖掘等需达成特定目标的任务mode: loop— 定时循环，适用于扫描、聊天广播等周期性行为
5. Gateway Cron 集成：通过外部定时任务每 30 秒触发自主决策循环，实现无需人工干预的持续自动化运行。
支持的动作类型：chat（聊天）、move_to/move_relative/move（移动）、dig（挖掘）、place（放置）、equip（装备）、use_item（使用物品）、attack（攻击）、follow（跟随）、jump（跳跃）。
显著优点
- 架构清晰：LLM 推理完全本地执行，仅向控制器发送结构化 JSON，避免敏感信息外泄
- 批量高效：单次请求可打包多步操作，减少网络往返和指令延迟
- 灵活调度：until/loop 双模式覆盖绝大多数自动化场景，timeout 机制防止任务挂死
- 自主性强：Cron 驱动的决策循环使机器人可长期独立运行
- 扩展友好：标准化 REST API 便于集成外部系统
潜在缺点与局限性
- 功能边界：仅支持 JSON 载荷，暂不支持媒体文件上传或复杂附件
- 可靠性约束：动作为尽力而为（best-effort），若机器人未连接或物品不足会导致失败
- 网络依赖：依赖 ngrok 等隧道服务的公开 URL，存在连接稳定性风险
- 任务串行：
metadata.currentTaskId机制意味着同一时刻只能执行一个任务队列，需显式等待 - 调试困难：缺乏实时可视化调试界面，故障排查依赖日志轮询
适合人群
- Minecraft 服务器管理员需部署自动化玩家（挂机、巡逻、交易机器人）
- 开发者希望快速原型验证 Mineflayer 自动化方案
- 研究团队进行游戏 AI、多智能体协作实验
- 个人用户搭建私人服务器的辅助助手
常规风险
1. 开放注册风险：若启用 /v1/auth/open/register，任意 agent 可获取 token，建议仅在内网或可信环境使用
2. Token 泄露：JWT 一旦泄露，攻击者可操控对应机器人，建议启用短期 token 并定期轮换
3. 服务器滥用：自动化机器人可能被游戏反作弊系统封禁，需遵守目标服务器规则
4. 资源耗尽：批量动作或高频轮询可能导致控制器或 Minecraft 服务器性能下降
5. ngrok 域名暴露：文档中的具体 ngrok URL 为示例/测试地址，生产环境应替换为自有域名并配置访问控制