青龙面板技能

通过REST API控制您的青龙定时任务面板。

📦 ClawHub：https://clawhub.ai/nnnnzs/qinglong-skills
📖 GitHub：https://github.com/NNNNzs/qinglong-skills

前置条件

• - 已安装 curl 和 jq
• 运行中的青龙面板，并已启用Open API

获取青龙API凭证

1. 1. 打开青龙Web界面 → 系统设置 → 应用
2. 点击 创建应用
3. 选择所需的作用域（定时任务/环境变量/脚本/日志/系统）
4. 复制 Client ID 和 Client Secret

必需的环境变量

变量	描述
QINGLONGURL	面板基础URL（例如 http://192.168.1.100:5700）
QINGLONGCLIENT_ID

Open API Client ID | | QINGLONGCLIENTSECRET | Open API Client Secret |

配置Claude Code CLI

此技能适用于Claude Code CLI或任何可以执行shell命令的代理。

1. 设置环境变量

添加到您的 ~/.bashrc 或 ~/.zshrc：

bash
export QINGLONG_URL=https://ql.yourdomain.com
export QINGLONGCLIENTID=yourclientid
export QINGLONGCLIENTSECRET=yourclientsecret

然后重新加载：source ~/.bashrc

2. 测试连接

bash
scripts/ql.sh cron list

3. 与Claude Code配合使用

在项目根目录创建 CLAUDE.md：

markdown

青龙面板管理

使用 scripts/ql.sh 管理青龙面板。

常用命令：

• - scripts/ql.sh cron list — 列出所有定时任务
• scripts/ql.sh env list — 列出环境变量
• scripts/ql.sh system info — 获取系统信息

完整参考：参见本目录下的 SKILL.md。

然后运行：claude-code 帮我查看青龙面板的定时任务

配置OpenClaw

安装

bash

通过ClawHub（推荐）

clawhub install qinglong

或通过npx

npx skills add NNNNzs/qinglong-skills

或手动复制

cp -r qinglong-skills ~/.openclaw/workspace/skills/qinglong

配置环境变量

打开 ~/.openclaw/openclaw.json，在 skills.entries 下添加：

json5
{
skills: {
entries: {
qinglong: {
enabled: true,
env: {
QINGLONG_URL: https://ql.yourdomain.com,
QINGLONGCLIENTID: yourclientid,
QINGLONGCLIENTSECRET: yourclientsecret
}
}
}
}
}

重启网关：openclaw gateway restart

快速参考

定时任务

bash
scripts/ql.sh cron list # 列出所有
scripts/ql.sh cron get # 获取详情
scripts/ql.sh cron create --command task x.js --schedule 0 0 * --name 任务
scripts/ql.sh cron update --name 新名称
scripts/ql.sh cron delete # 删除（支持多个ID）
scripts/ql.sh cron run # 立即运行
scripts/ql.sh cron stop # 停止
scripts/ql.sh cron enable / disable # 启用/禁用
scripts/ql.sh cron pin / unpin # 置顶/取消置顶
scripts/ql.sh cron log # 查看日志

环境变量

bash
scripts/ql.sh env list # 列出所有
scripts/ql.sh env list JD # 搜索
scripts/ql.sh env create --name KEY --value VALUE --remarks 备注
scripts/ql.sh env update --id --name KEY --value NEW_VALUE
scripts/ql.sh env delete
scripts/ql.sh env enable / disable

脚本

bash
scripts/ql.sh script list # 列出所有
scripts/ql.sh script get --file test.js # 查看内容
scripts/ql.sh script save --file test.js --content console.log(hi)
scripts/ql.sh script run --file test.js # 运行
scripts/ql.sh script stop --file test.js # 停止
scripts/ql.sh script delete --file test.js # 删除

依赖

bash
scripts/ql.sh dep list # 列出所有
scripts/ql.sh dep install --name axios --type 0 # 0=node, 1=linux, 2=python3
scripts/ql.sh dep reinstall
scripts/ql.sh dep delete

订阅

bash
scripts/ql.sh sub list / run / stop / enable / disable / delete

系统

bash
scripts/ql.sh system info # 系统信息
scripts/ql.sh system config # 系统配置
scripts/ql.sh system check-update # 检查更新
scripts/ql.sh system reload # 重新加载
scripts/ql.sh system command-run --command task test.js # 运行命令
scripts/ql.sh system auth-reset --username admin --password newpass

Token管理

bash
scripts/ql.sh token refresh # 强制刷新
scripts/ql.sh token show # 显示缓存
scripts/ql.sh token clear # 清除缓存

故障排除

• - 401 未授权：检查clientid和clientsecret是否正确
• 连接被拒绝：验证QINGLONG_URL是否可从本机访问
• Token过期：脚本会自动刷新token，无需手动操作
• 作用域错误：确保青龙中的应用已启用所需的作用域

API参考

此技能封装了青龙Open API。关键端点：

资源	端点
定时任务	GET/POST/PUT/DELETE /crons，run/stop/enable/disable/pin/unpin
环境变量

GET/POST/PUT/DELETE /envs，enable/disable |
| 脚本 | GET/POST/PUT/DELETE /scripts，run/stop |
| 依赖 | GET/POST/PUT/DELETE /dependencies，reinstall |
| 订阅 | GET/POST/PUT/DELETE /subscriptions，run/stop/enable/disable |
| 日志 | GET/DELETE /logs |
| 系统 | GET /system，config，reload，update，command-run |
| 配置文件 | GET/POST /configs |

完整API文档请参见 references/api.md。