宝塔面板运维监控技能包 - 符合 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 证书、伪静态、数据库管理等 |
综合运维监控技能，提供服务器资源监控、网站状态检查、服务状态检查、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 | 服务器配置管理工具 |
远程服务器文件操作技能，提供完整的文件/目录管理能力。
| 脚本 | 功能 |
|---|---|
| files.py | 文件/目录操作（ls、cat、edit、mkdir、touch、rm、rmdir、stat、chmod） |
| download.py | 远程文件下载（支持 URL 下载到服务器） |
| unzip.py | 远程文件解压（支持 zip 格式） |
- 目录浏览 - 列出目录内容，支持分页
- 文件读取 - 读取文件内容，支持显示最后 N 行
- 文件编辑 - 修改文件内容，支持从本地文件导入
- 目录/文件管理 - 创建、删除目录和文件
- 权限管理 - 查看和修改文件权限、所有者
PHP 网站全生命周期管理技能，提供站点创建、配置、维护等完整功能。
| 脚本 | 功能 |
|---|---|
| site.py | 站点管理（创建、删除、启用、停用） |
| domain.py | 域名管理（添加、删除、列出绑定域名） |
| php.py | PHP 版本管理（查看、切换版本） |
| ssl_cert.py | SSL 证书管理（申请、上传、强制 HTTPS） |
| rewrite.py | 伪静态规则管理（应用模板、自定义规则） |
| database.py | 数据库管理（查看、优化、修复、删除） |
| bt-config.py | 服务器配置管理工具 |
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 等
pip install requests pyyaml rich# 使用配置工具添加服务器
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 listSSL 证书验证配置：
添加服务器时，程序会询问您的宝塔面板是否使用受信任的 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 # 磁盘使用率告警阈值(%)- 登录宝塔面板
- 进入 面板设置 -> API接口
- 开启API接口
- 复制API密钥（Token）
# 查看所有服务器资源状态
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/ 目录，可直接部署使用。
技能目录包含 SKILL.md 文件，符合 OpenClaw 技能规范：
---
name: btpanel
description: 宝塔面板(BT-Panel)运维监控技能
user-invocable: true
disable-model-invocation: false
metadata:
openclaw:
requires:
bins:
- python3
---推荐方式（首选）：通过 ClawHub 一键安装
clawhub install btpanel手动方式（本地开发/离线场景）
# 复制技能目录到 OpenClaw 技能目录
cp -r skills/btpanel ~/.openclaw/skills/
# 重启 OpenClaw 会话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