{"skill":{"slug":"play-minecraft","displayName":"play_minecraft","summary":"通过 Mindcraft HTTP API 控制 Minecraft Bot（无内置 LLM）。当用户提到 OpenClaw、外部 agent、REST 接口控制、读取状态、执行动作、批量任务编排时使用。","description":"---\r\nname: openclaw-mindcraft-controller\r\ndescription: 通过 Mindcraft HTTP API 控制 Minecraft Bot（无内置 LLM）。当用户提到 OpenClaw、外部 agent、REST 接口控制、读取状态、执行动作、批量任务编排时使用。\r\n---\r\n\r\n# OpenClaw Mindcraft Controller\r\n\r\n## 适用场景\r\n\r\n- 用户要用 OpenClaw 或任意外部系统控制 `mindcraft` Bot。\r\n- 用户要求“不要内置 LLM，只走接口调用”。\r\n- 用户需要：读取状态、查询动作 schema、执行动作、排错与恢复。\r\n\r\n## 快速流程\r\n\r\n1. 确认服务已启动：`node main.js`\r\n2. 确认配置为外控模式：`settings.js` 中 `external_controller_only: true`\r\n3. 用 `GET /api/v1/agents` 找到 agent 名（如 `andy`）\r\n4. 用 `GET /api/v1/agents/:agentName/actions/schema` 获取动作参数定义\r\n5. 用 `POST /api/v1/agents/:agentName/actions/execute` 执行动作\r\n6. 用 `GET /api/v1/agents/:agentName/state` 校验动作结果\r\n\r\n## 控制规则\r\n\r\n- 动作前先查 schema，不要硬编码参数类型和数量。\r\n- 长动作执行后必须二次读 state，避免“命令发送成功但未达成目标”。\r\n- 异常时先执行 `!stop`，再做恢复动作。\r\n- 多动作编排推荐“小步执行 + 每步校验”，不要一次提交过长链路。\r\n\r\n## API 基础信息\r\n\r\n- Base URL: `http://localhost:8080`\r\n- Content-Type: `application/json`\r\n- 关键接口：\r\n  - `GET /api/v1/agents`\r\n  - `GET /api/v1/agents/:agentName/state`\r\n  - `GET /api/v1/agents/:agentName/actions/schema`\r\n  - `POST /api/v1/agents/:agentName/actions/execute`\r\n\r\n详细字段和示例见 [reference.md](reference.md) 与 [examples.md](examples.md)。\r\n\r\n## 推荐执行模板\r\n\r\n1. **发现 Agent**\r\n   - 调用 `/agents`\r\n   - 选择 `in_game=true` 的 agent\r\n2. **加载能力**\r\n   - 调用 `/actions/schema`\r\n   - 缓存 command + params 描述\r\n3. **执行动作**\r\n   - 调用 `/actions/execute`，传 `command` + `args`\r\n4. **结果验证**\r\n   - 读 `/state`，核对位置、背包、健康、当前动作\r\n5. **失败恢复**\r\n   - 执行 `!stop`\r\n   - 重新规划下一步动作\r\n\r\n## 常见故障处理\r\n\r\n- `Agent 'xxx' not found`\r\n  - 先调 `/agents`，确认 agent 名称。\r\n- `Agent 'xxx' is not connected in game`\r\n  - Bot 未进服；检查 Minecraft 是否开放 LAN 端口，或进程是否重启失败。\r\n- 参数不匹配（args count/type）\r\n  - 以 `/actions/schema` 为准重建入参。\r\n- 命令存在但效果不符合预期\r\n  - 读 `/state` 二次确认，再做补偿动作（例如 `!stop`、`!goToCoordinates` 重试）。\r\n\r\n## 输出要求（给 OpenClaw 的调用层）\r\n\r\n- 每次动作调用都记录：\r\n  - request payload\r\n  - response payload\r\n  - state 前后快照（至少位置/背包/健康）\r\n- 失败返回要保留原始 `error` 字段，便于排查。\r\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":601,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773567603689,"updatedAt":1778491921387},"latestVersion":{"version":"1.0.0","createdAt":1773567603689,"changelog":"- Initial release of OpenClaw Mindcraft Controller.\n- Provides a REST API for external systems to control Minecraft bots without an internal LLM.\n- Supports querying agent list, reading state, retrieving action schemas, and executing actions.\n- Includes recommended usage flows, error handling, and output requirements for integration with OpenClaw or similar orchestration frameworks.\n- Focuses on robust state validation and stepwise task execution to ensure reliable bot control.","license":"MIT-0"},"metadata":null,"owner":{"handle":"songjc0511","userId":"s17ah0fcf5hyjhy2969byv4359884zh1","displayName":"Songjc0511","image":"https://avatars.githubusercontent.com/u/108270936?v=4"},"moderation":null}