catalog/repos/aapanel--btpanel-skills.md

# 宝塔面板运维监控技能包

`宝塔面板` `运维监控` `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. 安装依赖

```bash
pip install requests pyyaml rich
```

### 2. 配置服务器

```bash
# 使用配置工具添加服务器
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` 参数

```bash
# 自签名证书场景（宝塔默认）
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`:

```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

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

### 4. 运行监控

```bash
# 查看所有服务器资源状态
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
```

## 技能打包

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

```bash
# 打包所有技能
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 技能规范：

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

### 安装到 OpenClaw

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

```bash
clawhub install btpanel
```

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

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

# 重启 OpenClaw 会话
```

### Python API 使用

```python
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

## 开发

### 运行测试

```bash
python3 -m pytest tests/ -v
```

### 代码风格

```bash
# 格式化代码
ruff format .

# 检查代码
ruff check .
```

## 注意事项

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

## 许可证

MIT