aaPanel / BT-Panel — Monitoring & File Management#

Combined server monitoring and file operations toolkit for aaPanel/BT-Panel. Supports multi-server management, resource monitoring, site status checks, service status, SSH security audits, cron job management, log reading, and remote file/directory operations.

Skill version: 1.0.7

aaPanel dependency: >= 9.0.0 | Python >= 3.10

---

aaPanel Skills Ecosystem#

This is a combined skill containing both monitoring and file management:

CapabilityDescriptionMonitoringCPU, memory, disk, network, site status, SSL certs, services, SSH logs, cron jobsFile OperationsBrowse, read, edit, create, delete, chmod files and directories

Official aaPanel: https://github.com/aaPanel

---

Quick Start#

1. Add a Server#

bash

python3 scripts/bt-config.py add -n my-server -H https://panel.example.com:8888 -t YOUR_TOKEN

Getting an API Token:

1. Log in to aaPanel → Panel Settings → API Interface → Get API Token
2. If using a self-signed certificate, add --verify-ssl false

2. Run a Health Check#

bash

python3 scripts/monitor.py --server my-server
python3 scripts/sites.py --server my-server
python3 scripts/services.py --server my-server

3. Browse Server Files#

bash

python3 scripts/files.py ls /www
python3 scripts/files.py cat /www/server/nginx/conf/nginx.conf

---

CLI Commands#

Monitoring#

bash

python3 scripts/monitor.py                          # All servers, JSON
python3 scripts/monitor.py --server my-server       # Specific server
python3 scripts/monitor.py --format table          # Table output

python3 scripts/sites.py --filter ssl-warning       # SSL expiring soon
python3 scripts/sites.py --filter stopped          # Stopped sites

python3 scripts/services.py                         # Service status
python3 scripts/services.py --service nginx         # Specific service

python3 scripts/ssh.py --logs --filter failed      # Failed SSH logins
python3 scripts/ssh.py --status                     # SSH service status

python3 scripts/logs.py --service nginx --lines 100  # Nginx error log
python3 scripts/logs.py --service mysql            # MySQL log

python3 scripts/crontab.py --backup-only           # Backup cron jobs

File Operations#

bash

python3 scripts/files.py ls /www                   # Browse directory
python3 scripts/files.py cat /www/config.php       # Read file
python3 scripts/files.py edit /www/config.php "new content"  # Edit file
python3 scripts/files.py mkdir /www/newdir         # Create directory
python3 scripts/files.py touch /www/test.txt       # Create file
python3 scripts/files.py rm /www/old.txt           # Delete file
python3 scripts/files.py chmod 755 /www/file.txt   # Change permissions
python3 scripts/files.py stat /www/file.txt        # View permissions

python3 scripts/download.py --url "https://..."    # Download file to server
python3 scripts/unzip.py /www/archive.zip          # Extract ZIP on server

Config Management#

bash

python3 scripts/bt-config.py list                   # List servers
python3 scripts/bt-config.py add -n s1 -H https://... -t TOKEN  # Add server
python3 scripts/bt-config.py remove my-server     # Remove server
python3 scripts/bt-config.py threshold --cpu 80    # Set alert thresholds

SSL Certificate Management#

bash

python3 scripts/ssl_certs.py list --server my-server           # List SSL certificates
python3 scripts/ssl_certs.py info --server my-server --site example.com  # Get site SSL info
python3 scripts/ssl_certs.py provision --server my-server --site example.com  # Let's Encrypt
python3 scripts/ssl_certs.py renew --server my-server --site example.com    # Renew certificate
python3 scripts/ssl_certs.py revoke --server my-server --site example.com   # Revoke/disable SSL

Site Management#

bash

python3 scripts/sites_mgmt.py list --server my-server            # List all sites
python3 scripts/sites_mgmt.py create --server my-server --name example.com --path /www/wwwroot/example.com --php 83  # Create site
python3 scripts/sites_mgmt.py delete --server my-server --name example.com  # Delete site
python3 scripts/sites_mgmt.py add-domain --server my-server --site example.com --domain www.example.com  # Add domain
python3 scripts/sites_mgmt.py remove-domain --server my-server --site example.com --domain www.example.com  # Remove domain
python3 scripts/sites_mgmt.py domains --server my-server --site example.com  # List site domains

Database Management#

bash

python3 scripts/databases.py list --server my-server                # List databases
python3 scripts/databases.py create --server my-server --name mydb --user dbuser --password Secret123  # Create database
python3 scripts/databases.py delete --server my-server --name mydb  # Delete database
python3 scripts/databases.py create-user --server my-server --user newuser --password Secret123  # Create user
python3 scripts/databases.py grant --server my-server --user dbuser --db mydb  # Grant privileges

Firewall Management#

bash

python3 scripts/firewall.py list --server my-server          # List firewall rules
python3 scripts/firewall.py status --server my-server        # Get firewall status
python3 scripts/firewall.py allow --server my-server --ip 192.168.1.100  # Whitelist IP
python3 scripts/firewall.py deny --server my-server --ip 10.0.0.50      # Blacklist IP
python3 scripts/firewall.py remove --server my-server --ip 10.0.0.50    # Remove IP from list

FTP Account Management#

bash

python3 scripts/ftp.py list --server my-server                    # List FTP accounts
python3 scripts/ftp.py create --server my-server --user ftpuser --password Secret123 --path /www/wwwroot  # Create FTP account
python3 scripts/ftp.py delete --server my-server --id 1           # Delete FTP account
python3 scripts/ftp.py set-password --server my-server --id 1 --password NewSecret123  # Set password

PHP Version Management#

bash

python3 scripts/php.py list --server my-server              # List installed PHP versions
python3 scripts/php.py set --server my-server --site example.com --version 83  # Set PHP version
python3 scripts/php.py get --server my-server --site example.com  # Get current PHP version

---

## Alert Configuration

Edit `~/.openclaw/bt-skills.yaml` to set alert thresholds:

```yaml
global:
  thresholds:
    cpu: 80      # CPU usage alert threshold (%)
    memory: 85   # Memory usage alert threshold (%)
    disk: 90     # Disk usage alert threshold (%)

SSL Certificate Alert Levels#

Days RemainingLevelExpiredcritical≤ 7 dayscritical≤ 30 dayswarning

---

Config File#

Location: ~/.openclaw/bt-skills.yaml

Contains: Server configs, API tokens, alert thresholds

Server configs and tokens are stored locally in ~/.openclaw/bt-skills.yaml.

---

Monitoring Metrics#

System Resources#

CPU usage, cores, model • Memory total/used/free • Disk usage per partition • Network speed/traffic • Load averages • System info (hostname, OS, uptime, panel version)

Site Status Checks#

PHP, Java, Node.js, Go, Python, .NET, Proxy, Static HTML — running/stopped/starting, SSL status, process info (PID, memory, CPU), backend health for proxies

Service Status#

Nginx, Apache, MySQL, Redis, Memcached, Pure-FTPD, PHP (multi-version), PostgreSQL — with error/slow logs where applicable

File Operations#

Browse • Read (with tail) • Edit (with concurrency protection) • Create files/dirs • Delete to recycle bin • chmod/chown with recursive support

---

Troubleshooting#

bash

# Check config
python3 scripts/bt-config.py list

# Test connection
python3 scripts/monitor.py --server my-server

# Check Python environment
python3 scripts/check_env.py