btpanel

# 宝塔面板运维监控

宝塔面板服务器的全方位运维监控工具，支持多服务器管理、资源监控、网站状态检查、服务状态检查、SSH安全审计、计划任务管理等功能。

![宝塔面板](icon/bt-logo.svg)

## 图标资源

技能包提供以下图标文件，可在生成报告时引用：

| 文件 | 格式 | 用途 |
|------|------|------|
| `icon/bt-logo.svg` | SVG | 矢量图标，适合缩放 |

**使用示例**（生成报告时）：
```markdown
# 服务器巡检报告

![宝塔面板](icon/bt-logo.svg)

## 概述
...
```

## AI 使用约束

本技能用于查询和展示服务器状态数据，AI应遵循以下原则：

1. **数据中立**：如实展示监控数据，不夸大或缩小问题严重性
2. **客观分析**：基于阈值配置给出告警，避免主观判断
3. **数据驱动**：建议和结论应基于实际数据，不得臆测
4. **隐私保护**：不主动泄露服务器敏感信息（如IP、Token、域名）
5. **执行前告知**：由于接口数据较多，获取和分析需要一定时间，AI应先向用户简述即将执行的操作步骤，然后再执行命令获取数据

**执行流程示例**：
```
AI: 我将为您执行以下操作：
    1. 获取服务器系统资源状态（CPU、内存、磁盘）
    2. 检查网站运行状态
    3. 检查服务运行状态
    正在获取数据，请稍候...
    [执行命令]
    [展示结果和分析]
```

## 服务器配置管理
> **重要:** 没有服务器信息时需要添加

使用配置工具管理服务器：

```bash
# 查看帮助
python3 {baseDir}/scripts/bt-config.py -h

# 添加服务器
python3 {baseDir}/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_TOKEN

# 列出服务器
python3 {baseDir}/scripts/bt-config.py list

# 设置阈值
python3 {baseDir}/scripts/bt-config.py threshold --cpu 75 --memory 80
```

## 常用场景

### 场景一：初次使用配置服务器

当用户第一次使用本技能时，需要先配置服务器连接信息：

```bash
# 添加服务器（需要面板地址和API Token）
python3 {baseDir}/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_API_TOKEN

# 查看已配置的服务器
python3 {baseDir}/scripts/bt-config.py list
```

**获取API Token的方法**：
1. 登录宝塔面板
2. 进入「面板设置」->「API接口」
3. 点击「获取API Token」

**用户意图识别**：
- "帮我配置宝塔服务器" → 引导用户添加服务器配置
- "添加一台服务器" → 执行 bt-...

# btpanel

宝塔面板(BT-Panel)运维监控技能，提供服务器资源监控、网站状态检查、服务状态检查、SSH安全审计、计划任务管理、日志读取等功能

## 版本要求

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

## 快速开始

1. 安装依赖:
   ```bash
   pip install requests pyyaml rich
   ```

2. 配置服务器:
   ```bash
   # 使用配置工具添加服务器
   python3 scripts/bt-config.py add --name prod-01 --host https://panel.example.com:8888 --token YOUR_TOKEN

   # 查看配置
   python3 scripts/bt-config.py list
   ```

   或手动编辑配置文件 `~/.openclaw/bt-skills.yaml`

3. 运行:
   ```bash
   # 查看帮助
   python3 scripts/monitor.py --help

   # 监控所有服务器
   python3 scripts/monitor.py
   ```

## 可用脚本

| 脚本 | 功能 |
|------|------|
| monitor.py | 系统资源监控 |
| sites.py | 网站状态检查 |
| services.py | 服务状态检查 |
| logs.py | 日志读取 |
| ssh.py | SSH状态和登录日志 |
| crontab.py | 计划任务检查 |
| bt-config.py | 配置管理工具 |

## 配置管理工具

```bash
# 初始化配置
python3 scripts/bt-config.py init

# 列出服务器
python3 scripts/bt-config.py list

# 添加服务器
python3 scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_TOKEN

# 更新服务器
python3 scripts/bt-config.py update prod-01 --disabled

# 删除服务器
python3 scripts/bt-config.py remove prod-01

# 设置阈值
python3 scripts/bt-config.py threshold --cpu 75 --memory 80

# 查看配置路径
python3 scripts/bt-config.py path
```

详细使用说明请参考 SKILL.md