mc-skills/catalog

Fork 0

mc-skills c8e8049202 catalog: 更新 2026-04-06 19:01

2026-04-06 19:01:37 +08:00

11 KiB

Raw Permalink Blame History

宝塔面板运维监控技能包

宝塔面板 运维监控 Python 服务器管理 OpenClaw

bt-skills

宝塔面板运维监控技能包 - 符合 OpenClaw/AgentSkills 规范的 Python 实现

功能特性

系统资源监控 - CPU、内存、磁盘、网络、负载实时监控
网站状态检查 - 支持 PHP/Java/Node/Go/Python/.NET/Proxy/HTML 等多种项目类型
服务状态检查 - Nginx/Apache/Redis/MySQL/PHP 等服务状态检测
SSH安全审计 - SSH服务状态、登录日志分析、IP归属地查询
计划任务管理 - 定时任务查看、备份任务监控
日志读取 - Nginx/Apache/Redis/PostgreSQL 日志读取
多服务器管理 - 支持同时管理多台宝塔面板服务器

目录结构

bt-skills/
├── src/                        # 源码目录（开发时使用）
│   ├── bt_common/              # 公共模块
│   │   ├── __init__.py
│   │   ├── api_endpoints.py    # API 端点定义
│   │   ├── bt_client.py        # 宝塔 API 客户端
│   │   ├── config.py           # 配置管理
│   │   ├── utils.py            # 工具函数
│   │   ├── files_client.py     # 文件操作客户端
│   │   └── scripts/
│   │       └── bt-config.py    # 配置管理工具
│   │
│   ├── btpanel/                # 宝塔面板运维监控技能
│   │   ├── SKILL.md            # 技能说明
│   │   └── scripts/
│   │       ├── monitor.py      # 系统资源监控
│   │       ├── sites.py        # 网站状态检查
│   │       ├── services.py     # 服务状态检查
│   │       ├── logs.py         # 日志读取
│   │       ├── ssh.py          # SSH 状态和日志
│   │       ├── crontab.py      # 计划任务检查
│   │       └── bt-config.py    # 配置管理工具
│   │
│   ├── btpanel_files/          # 宝塔面板文件管理技能
│   │   ├── SKILL.md            # 技能说明
│   │   ├── README.md           # 使用说明
│   │   └── scripts/
│   │       ├── files.py        # 文件/目录操作
│   │       ├── download.py     # 文件下载
│   │       └── unzip.py        # 文件解压
│   │
│   └── btpanel_phpsite/        # 宝塔面板 PHP 网站管理技能
│       ├── SKILL.md            # 技能说明
│       └── scripts/
│           ├── site.py         # 站点管理
│           ├── domain.py       # 域名管理
│           ├── php.py          # PHP 版本管理
│           ├── ssl_cert.py     # SSL 证书管理
│           ├── rewrite.py      # 伪静态规则
│           ├── database.py     # 数据库管理
│           └── bt-config.py    # 配置管理工具
│
├── skills/                     # 打包输出目录
│   ├── btpanel/                # 打包后的 btpanel 技能
│   ├── btpanel.zip             # btpanel 技能压缩包
│   ├── btpanel_files/          # 打包后的 btpanel_files 技能
│   ├── btpanel_files.zip       # btpanel_files 技能压缩包
│   ├── btpanel_phpsite/        # 打包后的 btpanel_phpsite 技能
│   └── btpanel_phpsite.zip     # btpanel_phpsite 技能压缩包
│
├── config/
│   └── servers.yaml            # 配置示例
│
├── tests/                      # 单元测试
├── scripts/
│   └── build_skills.py         # 技能打包脚本
│
├── docs/                       # API 文档
├── pyproject.toml              # 项目配置
└── requirements.txt            # 依赖列表

技能矩阵

当前宝塔面板技能包共包含 3 个相互关联的技能：

技能名称	描述	依赖关系
btpanel	运维监控技能	✅ 基础技能，提供资源监控、网站状态检查、服务状态检查、SSH 审计、计划任务管理等
btpanel-files	文件管理技能	✅ 提供远程服务器文件/目录浏览、读取、编辑、创建、删除、权限管理等基本文件操作
btpanel-phpsite	PHP 网站管理技能	✅ 提供 PHP 网站全生命周期管理，包括站点创建、域名管理、SSL 证书、伪静态、数据库管理等

技能详情

btpanel（宝塔面板运维监控）

综合运维监控技能，提供服务器资源监控、网站状态检查、服务状态检查、SSH 安全审计、计划任务管理、日志读取等功能。

可用脚本

脚本	功能
monitor.py	系统资源监控（CPU、内存、磁盘、网络、负载）
sites.py	网站状态检查（运行状态、SSL 证书有效期）
services.py	服务状态检查（Nginx、Apache、MySQL、Redis、PHP 等）
logs.py	日志读取（Nginx、Apache、Redis、MySQL、PostgreSQL）
ssh.py	SSH 服务状态和登录日志审计
crontab.py	计划任务和备份任务检查
bt-config.py	服务器配置管理工具

btpanel-files（文件管理）

远程服务器文件操作技能，提供完整的文件/目录管理能力。

可用脚本

脚本	功能
files.py	文件/目录操作（ls、cat、edit、mkdir、touch、rm、rmdir、stat、chmod）
download.py	远程文件下载（支持 URL 下载到服务器）
unzip.py	远程文件解压（支持 zip 格式）

支持的操作

目录浏览 - 列出目录内容，支持分页
文件读取 - 读取文件内容，支持显示最后 N 行
文件编辑 - 修改文件内容，支持从本地文件导入
目录/文件管理 - 创建、删除目录和文件
权限管理 - 查看和修改文件权限、所有者

btpanel-phpsite（PHP 网站管理）

PHP 网站全生命周期管理技能，提供站点创建、配置、维护等完整功能。

可用脚本

脚本	功能
site.py	站点管理（创建、删除、启用、停用）
domain.py	域名管理（添加、删除、列出绑定域名）
php.py	PHP 版本管理（查看、切换版本）
ssl_cert.py	SSL 证书管理（申请、上传、强制 HTTPS）
rewrite.py	伪静态规则管理（应用模板、自定义规则）
database.py	数据库管理（查看、优化、修复、删除）
bt-config.py	服务器配置管理工具

支持的 PHP 版本

52, 53, 54, 55, 56, 70, 71, 72, 73, 74, 80, 81, 82, 83, 84, 00（纯静态）

支持的伪静态模板

WordPress、ThinkPHP、Laravel5、DedeCMS、Discuz、Typecho、Z-Blog、Drupal、ECShop、PHPCMS、MacCMS、CRMEB、ShopWind、EmpireCMS、EduSoho 等

快速开始

1. 安装依赖

pip install requests pyyaml rich

2. 配置服务器

# 使用配置工具添加服务器
python3 src/btpanel/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_API_TOKEN

# 查看已配置的服务器
python3 src/btpanel/scripts/bt-config.py list

SSL 证书验证配置：

添加服务器时，程序会询问您的宝塔面板是否使用受信任的 SSL 证书：

✅ 受信任证书（Let's Encrypt、商业 CA）→ 使用默认配置或直接回车
⚠️ 自签名证书（宝塔默认）→ 输入 false 或添加 --verify-ssl false 参数

# 自签名证书场景（宝塔默认）
python3 src/btpanel/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_TOKEN --verify-ssl false

# 受信任证书场景（默认）
python3 src/btpanel/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_TOKEN

或手动创建配置文件 ~/.openclaw/bt-skills.yaml:

servers:
  - name: "prod-01"
    host: "https://your-panel.com:8888"
    token: "YOUR_API_TOKEN"
    timeout: 10000
    enabled: true

global:
  thresholds:
    cpu: 80      # CPU使用率告警阈值(%)
    memory: 85   # 内存使用率告警阈值(%)
    disk: 90     # 磁盘使用率告警阈值(%)

3. 获取宝塔API Token

登录宝塔面板
进入 面板设置 -> API接口
开启API接口
复制API密钥（Token）

4. 运行监控

# 查看所有服务器资源状态
python3 src/btpanel/scripts/monitor.py --format table

# 查看指定服务器的网站状态
python3 src/btpanel/scripts/sites.py --server prod-01

# 检查服务状态
python3 src/btpanel/scripts/services.py

# 查看SSH登录日志
python3 src/btpanel/scripts/ssh.py --logs --filter failed

# 查看Nginx错误日志
python3 src/btpanel/scripts/logs.py --service nginx --lines 200

技能打包

使用打包脚本将技能打包为独立可用的压缩包：

# 打包所有技能
python3 scripts/build_skills.py

# 打包指定技能
python3 scripts/build_skills.py --skill btpanel

# 只构建目录，不创建压缩包
python3 scripts/build_skills.py --no-zip

# 创建 tar.gz 格式
python3 scripts/build_skills.py --format tar.gz

打包后的文件位于 skills/ 目录，可直接部署使用。

与 OpenClaw 集成

技能规范

技能目录包含 SKILL.md 文件，符合 OpenClaw 技能规范：

---
name: btpanel
description: 宝塔面板(BT-Panel)运维监控技能
user-invocable: true
disable-model-invocation: false
metadata:
  openclaw:
    requires:
      bins:
        - python3
---

安装到 OpenClaw

推荐方式（首选）：通过 ClawHub 一键安装

clawhub install btpanel

手动方式（本地开发/离线场景）

# 复制技能目录到 OpenClaw 技能目录
cp -r skills/btpanel ~/.openclaw/skills/

# 重启 OpenClaw 会话

Python API 使用

from bt_common import BtClientManager

# 初始化客户端管理器
manager = BtClientManager()
manager.load_config()

# 获取服务器列表
print(manager.get_server_list())

# 检查连接状态
connections = manager.check_all_connections()
print(connections)

# 获取特定服务器的系统状态
client = manager.get_client("prod-01")
status = client.get_system_status()
print(status)

版本要求

宝塔面板: >= 9.0.0
Python: >= 3.10

开发

运行测试

python3 -m pytest tests/ -v

代码风格

# 格式化代码
ruff format .

# 检查代码
ruff check .

注意事项

安全存储 Token - 请勿将包含真实 Token 的配置文件提交到版本控制
SSL 证书验证 - 宝塔面板默认使用自签名证书，添加服务器时需设置 --verify-ssl false
API 权限 - 确保宝塔面板 API 接口已开启
网络访问 - 确保运行本工具的服务器能访问宝塔面板

许可证

MIT

11 KiB Raw Permalink Blame History Unescape Escape

宝塔面板运维监控技能包

bt-skills

功能特性

目录结构

技能矩阵

技能详情

btpanel（宝塔面板运维监控）

可用脚本

btpanel-files（文件管理）

可用脚本

支持的操作

btpanel-phpsite（PHP 网站管理）

可用脚本

支持的 PHP 版本

支持的伪静态模板

快速开始

1. 安装依赖

2. 配置服务器

3. 获取宝塔API Token

4. 运行监控

技能打包

与 OpenClaw 集成

技能规范

安装到 OpenClaw

Python API 使用

版本要求

开发

运行测试

代码风格

注意事项

许可证

11 KiB

Raw Permalink Blame History