OpenClaw Minecraft

核心用法

OpenClaw Minecraft 是一个基于 Mineflayer 的 Minecraft 机器人控制技能，允许用户通过 RESTful API 创建、连接并控制虚拟游戏机器人。核心工作流程包括：注册获取 JWT 令牌 → 创建机器人实例 → 连接 Minecraft 服务器 → 读取状态并发送 JSON 动作指令。支持批量动作执行（act-batch），提供 until（条件完成）和 loop（循环执行）两种模式，适合复杂任务编排。

显著优点

• 标准化接口：纯 JSON 动作协议，易于与 LLM 集成，实现自然语言到游戏指令的转换
• 自主运行能力：内置 Cron 驱动架构，支持无需人工干预的持续自主循环
• 灵活认证：提供开放注册、代理注册和主密钥注册三种模式，适应不同安全需求
• 丰富的动作集：支持移动、挖掘、放置、装备、攻击、跟随、聊天等核心游戏操作

潜在缺点与局限性

• 公网隧道依赖：默认使用 ngrok 免费隧道，URL 不稳定且可能变更，生产环境需自建服务
• 无媒体支持：仅支持 JSON 载荷，无法处理图像、音频等多媒体内容
• 最佳努力执行：动作可能因机器人未连接、物品缺失或服务器延迟而失败，需配合轮询状态进行容错
• 安全权衡：开放注册模式虽便捷但降低安全性，需管理员谨慎配置

适合人群

• Minecraft 自动化开发者与服务器管理员
• 研究游戏 AI 和 LLM 代理的开发者
• 希望构建 24/7 在线虚拟助手或 NPC 的内容创作者

常规风险

• 令牌泄露风险：JWT 令牌若被截获，攻击者可控制关联机器人，建议定期轮换并限制权限范围
• 服务器违规风险：自动化行为可能违反第三方服务器的服务条款，导致封禁
• 资源滥用：Cron 驱动的自主循环若配置不当，可能造成服务器负载过高或触发反作弊机制

核心用法

OpenClaw Minecraft 是一款 Mineflayer 控制器技能，允许用户通过标准化 JSON API 远程创建、连接并操控 Minecraft 游戏机器人。该技能采用"本地推理 + 远程执行"架构：LLM 在本地完成决策，仅将最终动作以 JSON 格式发送至控制器，避免 API 密钥泄露风险。

关键工作流程：
1. 身份认证：通过 POST /v1/auth/open/register 或代理注册获取 JWT Token，存储于本地复用
2. 机器人管理：创建 bot → 连接服务器 → 读取状态 → 发送动作批次 → 轮询任务状态
3. 自主循环：结合 Gateway Cron 每 30 秒执行，实现无人值守的持续性游戏自动化
4. 动作编排：单次请求可包含 5-10 个动作，支持 until（条件终止）和 loop（定时循环）两种模式

支持动作：chat、move_to、move_relative、dig、place、equip、use_item、attack、follow、jump 等。

显著优点

• 零代码侵入：纯 Markdown 文档型 Skill，无可执行代码，依赖风险极低
• 安全隔离：API 密钥与推理过程完全本地化处理，控制器仅接收脱敏后的 JSON 动作
• 灵活编排：批次动作机制支持复杂多步骤任务，减少网络往返
• 定时自治：原生 Cron 集成，适合长期挂机、资源采集、定时巡逻等场景
• 多模式执行：until 模式适合导航类任务，loop 模式适合周期性监控

潜在局限

• 端点可用性风险：硬编码 ngrok 动态域名，可能随时失效或被中间人攻击
• 功能边界：仅支持 JSON 载荷，暂不支持媒体附件；动作为尽力而为，连接中断或物品缺失会导致失败
• 信任门槛：T3 级来源可信度，缺乏开源仓库与许可证信息
• 权限管理：开放注册模式安全性较低，需人工评估是否启用

适合人群

• Minecraft 服务器管理员需批量管理机器人
• 开发者构建游戏自动化测试或数据监控场景
• 希望实现无人值守挂机、自动聊天、路径巡逻的玩家

常规风险

• 动态 DNS 隐患：ngrok 隧道域名非固定，服务变更将导致 Skill 失效
• Token 泄露：JWT 长期有效需妥善保管，建议定期轮换
• 游戏合规：部分服务器禁止自动化脚本，使用前需确认服务器规则
• 网络稳定性：依赖外部控制器服务，断网或控制器宕机将中断自动化流程