宝塔面板文件管理

宝塔面板服务器文件操作工具，提供远程文件/目录浏览、读取、编辑、创建、删除、权限管理等基本文件操作能力。

图标资源

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

AI 使用约束

本技能用于查询和修改服务器文件，AI 应遵循以下原则：

1. 操作前确认：修改文件前先读取文件内容，确认修改范围
2. 执行前告知：文件操作会影响服务器状态，AI 应先向用户简述即将执行的操作步骤
3. 谨慎删除：删除文件/目录前需告知用户，并确认目标路径
4. 隐私保护：不主动读取敏感文件（如 /etc/shadow、.env、config.php 等含密码的文件）
5. 备份建议：修改重要配置文件前，建议用户先备份

执行流程示例：

AI: 我将为您执行以下操作：
    1. 读取配置文件 /www/server/nginx/conf/nginx.conf
    2. 修改指定配置项
    3. 保存文件
    正在获取数据，请稍候...
    [执行命令]
    [展示结果和修改内容]

宝塔面板相关技能矩阵

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

⚠️ 常见问题

问题 1: 配置文件不存在

错误：未找到配置文件
解决：运行 python3 bt-config.py add 添加服务器配置

问题 2: PYTHONPATH 未设置

# 运行脚本前需要设置
export PYTHONPATH=/path/to/btpanel-skills/src:$PYTHONPATH

检查命令

# 检查 bt_common 模块
python3 -c "from bt_common.bt_client import BtClient; print('✅ 模块正常')"

# 检查配置文件
ls -la ~/.openclaw/bt-skills.yaml

# 测试连接
python3 {baseDir}/scripts/monitor.py --server "你的服务器名"

服务器配置管理

重要: 没有服务器信息时需要先添加

本技能复用 btpanel 技能的配置系统，使用 bt-config.py 工具管理服务器：

# 查看帮助
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 remove prod-01

获取 API Token 的方法：

1. 登录宝塔面板
2. 进入「面板设置」->「API 接口」