适用于 Openclaw 的 MCSManager Controller

一个专为 MCSManager 管理的 Minecraft 实例设计的专业级控制器,支持无缝的 API 驱动服务器操作、实时日志追踪和故障排除。

szabee13
v1.0.1
2026年3月21日
0
881
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install mcsmanager-controller

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 mcsmanager-controller。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 MCSManager Controller?

MCSManager Controller 是一项专门设计的集成功能,旨在将 AI 代理与 MCSManager 面板连接起来。它提供了一种结构化、安全且高效的方式来管理 Minecraft 服务器,无需手动操作面板。该技能专注于高可靠性操作,优先使用 API 交互而非脆弱的浏览器自动化,以确保结果的一致性。

作为 Openclaw Skills 生态系统的核心组件,它强调安全性和宿主机侧的上下文。它允许开发人员和服务器管理员自动执行常规任务,例如检查服务器运行状况、通过控制台命令管理白名单,以及通过自动日志分析诊断复杂的 Java 异常。

MCSManager Controller 应用场景

  • 通过自动获取和分析 Java 堆栈跟踪来排除服务器崩溃故障。
  • 对挂起的 Minecraft 实例执行正常重启或紧急强制停止。
  • 通过直接控制台命令注入实现白名单管理和玩家审核自动化。
  • 监控服务器可达性和实例状态,用于自愈服务器架构。
  • 配置本地实例默认值,用于快速多服务器管理环境。

MCSManager Controller 工作原理

  1. 身份验证:该技能从用户提供的上下文或本地配置文件中识别目标实例 UUID 和面板凭据。
  2. 预检:执行只读状态检查,以验证 MCSManager 服务可达性和当前实例电源状态。
  3. 日志分析:在任何状态更改之前,它会追踪或读取最新的日志,以识别端口绑定错误或世界损坏等现有问题。
  4. 执行动作:根据确定的需求发送特定的 API 请求,以启动、停止、重启或发送控制台命令。
  5. 验证与报告:执行后,它会验证状态更改并报告具体结果,包括相关的日志摘要或错误症状。

MCSManager Controller 配置指南

要开始使用 Openclaw Skills 库的这一成员,请按照以下步骤操作:

  1. 在您的代理工作区中找到技能目录。
  2. 通过复制示例创建您的本地配置文件:
cp config.example.json config.json
  1. 编辑 config.json 以包含您的 MCSManager 面板 URL、API 令牌和默认实例 UUID。
  2. 确保 references/api-notes.md 存在,用于备用请求模式。

MCSManager Controller 数据架构与分类体系

该技能通过结构化的配置和参考系统管理服务器交互:

文件 用途 访问级别
config.json 存储本地 API 凭据和实例默认值。 用户管理
config.example.json 环境配置模板。 只读
references/api-notes.md 包含技术请求模式和特定版本说明。 内部参考

处理的数据包括实例电源状态、实时日志缓冲区和控制台命令字符串。

MCSManager Controller 高级特性

  • 优雅停机协议:优先执行软停止命令而非强制结束进程,以防止世界数据损坏。
  • 日志解析引擎:专门识别 Java 异常和与插件相关的启动失败,以提供可操作的见解。
  • 多服务器配置支持:允许使用特定的本地配置键在不同的服务器实例之间切换。
  • 宿主机侧回退:如果 API 无法访问,它可以利用宿主机侧的详细信息来执行进程级健康检查。
  • 批量命令序列化:通过将多个控制台命令序列化为受控执行流,防止面板流量过载。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*