CraftClose — AI Minecraft Server Monitor
AI-powered Minecraft server monitoring — crash detection, auto-restart, and smart alerts.
When to Use
✅ USE this skill when:
- - Monitoring a Minecraft server's health (TPS, players, uptime)
- Diagnosing crashes or performance issues
- Setting up auto-restart on crash detection
- Configuring Telegram bot or Discord webhook alerts
- Analyzing server logs with AI (Gemini)
- Managing servers via Pterodactyl panel
- Checking plugin conflicts or config issues
When NOT to Use
❌ DON'T use this skill when:
- - Bedrock-only servers (Java/Paper servers only)
- Non-Minecraft game servers
- Web application monitoring
- Network diagnostics unrelated to Minecraft
Install
CODEBLOCK0
Setup
CODEBLOCK1
Config (craftclose.yml)
CODEBLOCK2
CLI Commands
CODEBLOCK3
Key Features
| Feature | Description |
|---|
| Crash Detection | 20+ built-in patterns (OOM, plugin errors, world corruption, etc.) |
| Auto-Restart |
Configurable restart on crash with rate limiting |
|
AI Analysis | BYOK Gemini for deep crash analysis and optimization |
|
3 Connections | SSH, RCON, Pterodactyl — use any combo |
|
Alerts | Telegram bot + Discord webhook notifications |
|
History | TPS and player count stored in local SQLite |
|
Security | 6-layer sandbox (path jail, RCON filter, input sanitizer, audit log, action allowlist, confirmation gate) |
OpenClaw Integration
CraftClose is also an OpenClaw skill. When installed globally, OpenClaw can use it to monitor and manage Minecraft servers through natural language.
Links
技能名称: craftclose
详细描述:
CraftClose — AI Minecraft服务器监控器
基于AI的Minecraft服务器监控——崩溃检测、自动重启与智能告警。
适用场景
✅ 使用此技能的时机:
- - 监控Minecraft服务器运行状态(TPS、玩家数、运行时长)
- 诊断崩溃或性能问题
- 设置崩溃检测后的自动重启
- 配置Telegram机器人或Discord Webhook告警
- 使用AI(Gemini)分析服务器日志
- 通过Pterodactyl面板管理服务器
- 检查插件冲突或配置问题
不适用场景
❌ 请勿使用此技能的时机:
- - 仅限基岩版服务器(仅支持Java/Paper服务器)
- 非Minecraft游戏服务器
- Web应用监控
- 与Minecraft无关的网络诊断
安装
bash
npm install -g craftclose
配置
bash
复制示例配置
craftclose init
或手动创建 craftclose.yml
cp node_modules/craftclose/craftclose.example.yml ./craftclose.yml
配置文件 (craftclose.yml)
yaml
servers:
- name: my-server
host: 127.0.0.1
connections:
ssh:
port: 22
username: minecraft
keypath: ~/.ssh/idrsa
rcon:
port: 25575
password: changeme
pterodactyl:
panel_url: https://panel.example.com
apikey: ptlcxxxxx
server_id: abc123
monitoring:
interval: 60
auto_restart: true
max_restarts: 3
restart_window: 300
alerts:
telegram:
bot_token: 123456:ABC...
chat_id: -100123456
discord:
webhook_url: https://discord.com/api/webhooks/...
ai:
provider: gemini
apikey: ${GEMINIAPI_KEY}
CLI命令
bash
测试所有连接
craftclose test
检查服务器状态
craftclose status
启动持续监控
craftclose monitor
查看崩溃/事件历史
craftclose history
AI驱动的崩溃分析
craftclose analyze
配置优化建议
craftclose optimize
检查插件冲突
craftclose conflicts
Pterodactyl面板操作
craftclose panel status
craftclose panel restart
craftclose panel console say Hello
核心功能
| 功能 | 描述 |
|---|
| 崩溃检测 | 20+内置模式(内存溢出、插件错误、世界损坏等) |
| 自动重启 |
可配置的崩溃后重启,带频率限制 |
|
AI分析 | 自带密钥的Gemini,用于深度崩溃分析和优化 |
|
3种连接方式 | SSH、RCON、Pterodactyl——任意组合使用 |
|
告警通知 | Telegram机器人 + Discord Webhook通知 |
|
历史记录 | TPS和玩家数存储在本地SQLite中 |
|
安全机制 | 6层沙箱(路径隔离、RCON过滤、输入净化、审计日志、操作白名单、确认门禁) |
OpenClaw集成
CraftClose同时也是OpenClaw技能。全局安装后,OpenClaw可通过自然语言使用它来监控和管理Minecraft服务器。
相关链接