OpenClaw Minecraft

核心用法

OpenClaw Minecraft 是一款基于 Mineflayer 的 Minecraft 机器人控制器，通过 REST API 提供 JSON 格式的动作指令系统。用户需先通过开放注册或代理注册获取 JWT Token，然后依次完成创建机器人、连接服务器、读取状态、发送动作指令的工作流程。核心 API 包括 /bots（创建）、/bots/{id}/connect（连接）、/bots/{id}/state（状态读取）和 /bots/{id}/act-batch（批量动作执行）。

显著优点

1. 结构化动作系统：支持 chat、move_to、dig、place、attack 等 15+ 种原子动作，可通过 mode: until（条件终止）或 mode: loop（定时循环）实现复杂行为编排
2. 自主运行架构：基于 Gateway Cron 的 30 秒定时触发机制，无需持续心跳连接，配合本地 LLM 推理实现真正的无人值守自动化
3. 安全隔离设计：API Key 和 LLM 密钥完全本地化，控制器仅接收 JSON 动作指令，避免敏感信息外泄
4. 批量任务优化：单次请求可打包 5-10 个动作，减少网络往返，支持 queue 排队模式避免任务中断

潜在缺点与局限性

• 功能边界受限：仅支持 JSON 载荷，无法处理媒体文件或附件；动作执行为"尽力而为"模式，网络波动或物品缺失会导致失败
• 部署依赖较重：需要自行维护 ngrok 隧道或公网服务器，开放注册模式存在未授权访问风险
• 调试门槛较高：需同时理解 Minecraft 协议、Mineflayer API 和 cron 调度逻辑，错误排查涉及多层链路

适合人群

• 熟悉 JavaScript/Node.js 生态的开发者
• 需要 7×24 小时 Minecraft 自动化（农场、监控、聊天机器人）的服务器管理员
• 希望将 LLM 代理与游戏世界打通的 AI 实验者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 未授权访问 | 开放注册模式下任意 agentName 可获取 Token，建议生产环境使用 proxyKey 白名单 |

| 资源滥用 | 高频 cron 任务可能导致服务器 CPU/内存过载，需合理设置 `timeoutMs` 和 `intervalMs` |

| 游戏封禁 | 自动化行为可能触发 Minecraft 服务器的反作弊机制，建议控制操作频率 |

| 数据持久化 | Token 默认存储于 `memory/mc-auth.json`，需确保文件权限和备份策略 |

OpenClaw Minecraft 评估报告

核心用法

OpenClaw Minecraft 是一款基于 Mineflayer 框架的 Minecraft 机器人控制配置文档，通过 RESTful JSON API 实现远程游戏自动化。用户需先向控制器申请 JWT Token（支持开放注册、代理注册、预签发三种模式），随后可通过 API 完成机器人创建、服务器连接、状态读取及批量动作执行。

典型工作流：
1. 认证：调用 /v1/auth/open/register 获取 accessToken
2. 创建机器人：POST /v1/bots 指定 botId 与用户名
3. 连接服务器：POST /bots/{botId}/connect 配置目标服务器地址
4. 读取状态：GET /bots/{botId}/state 获取位置、背包、任务队列等上下文
5. 执行动作：POST /bots/{botId}/act-batch 发送批量 JSON 指令（支持 until/loop 两种模式）

Cron 自治模式：通过覆盖 CRON_PROMPT.md 实现每 30 秒的自主决策循环，适合挂机、巡逻、采集等长时任务。

显著优点

| 维度 | 说明 |

|------|------|

零代码风险 | 纯 Markdown 配置型 Skill，无可执行脚本，彻底杜绝本地代码注入 |
架构清晰 | LLM 推理完全本地化，仅向控制器发送 JSON 动作，API 密钥永不外泄 |
灵活调度 | 支持 until（条件终止）与 loop（定时重复）双模式，适配导航、聊天、扫描等多元场景 |
安全设计 | 强制 Token 隔离、仅操作自有 Bot、推荐队列模式防任务冲突 |
隐私合规 | 无用户数据收集，符合 GDPR/CCPA 数据最小化原则 |

潜在缺点与局限性

1. 基础设施依赖：必须使用 ngrok 动态 DNS 作为 API 端点，免费隧道地址可能随时变更，生产环境稳定性受限
2. 功能边界：仅支持文本 JSON 交互，暂不支持媒体/附件上传；动作执行为尽力而为，掉线或缺物资时可能失败
3. 开放性权衡：开放注册模式虽便利但安全性较低，需用户自行判断场景适用性
4. 维护状态：T3 社区项目，无企业级 SLA 保障，版本迭代依赖个人开发者

适合人群

• Minecraft 服主或开发者，需快速部署自动化 NPC、客服机器人、资源采集脚本
• 希望通过自然语言指令（经 LLM 转译为 JSON）间接控制游戏实体的 AI 应用实验者
• 对「本地推理 + 远程执行」架构有认知，能接受 ngrok 临时隧道作为 PoC 环境的用户

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

端点可用性 | 中 | ngrok 免费隧道会话过期或地址变更导致服务中断 |
认证模式误用 | 低 | 生产环境若未关闭 open registration，存在未授权访问隐患 |
网络延迟 | 低 | 控制器与 Minecraft 服务器之间的额外跳转可能增加操作延迟 |
依赖单一维护者 | 低 | T3 来源，代码未托管于主流平台，长期维护存在不确定性 |

安全认证摘要

本次扫描（CLS-Certify v2.1.0）综合评分 85/100，定级 S 级优秀。静态/动态/依赖/隐私/威胁情报全维度通过，唯一标记项为「ngrok 动态 DNS」属于功能必需而非恶意特征。