1panel-skills
1Panel operation skill for agent runtimes. Use when the user wants an assistant to interact with a 1Panel instance for resource monitoring, websites, certifi...
Rank
62
Safety
84
Downloads
1.9k
Updated
Oct 9, 2026
Version
0.0.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 1.9K downloadsadoption · observed Oct 9, 2026
- Latest release
- 0.0.3release · observed May 22, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178v9mfknrkdzqqsvtc1dvajn83hm9t:1panel-skills- Install using `clawhub skill install s178v9mfknrkdzqqsvtc1dvajn83hm9t:1panel-skills` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/1panel/1panel-skills before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-1panel-1panel-skills/snapshot"
Documentation
CLAWHUB
79,944 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: 1panel-skills description: 1Panel operation skill for agent runtimes. Use when the user wants an assistant to interact with a 1Panel instance for resource monitoring, websites, certificates, app status, container status, logs, cronjobs, task-center records, node-management status, and future management actions. The current implementation focuses on query and inspection interfaces and keeps module-grouped mutation definitions reserved for later expansion. --- # 1panel-skills ## Overview Use this skill to interact with a 1Panel instance through authenticated HTTP API calls. The bundled resources are TypeScript source files grouped by module, with query-oriented actions implemented now and mutation endpoints reserved for later expansion. ## Requirements - Require a 1Panel API key with access to the target instance. - Require these environment variables when executing the TypeScript resources in a host runtime: - `ONEPANEL_BASE_URL` - `ONEPANEL_API_KEY` - optional: `ONEPANEL_TIMEOUT_MS` - optional: `ONEPANEL_SKIP_TLS_VERIFY=true` ## Workflow 1. Choose the module that matches the user's request. 2. Start with a list or search action to identify the exact target. 3. Read detail, status, or logs only after the target is confirmed. 4. If the user asks for create, update, delete, restart, stop, or any other mutation: - do not fabricate or guess a write workflow - surface the matching reserved mutation endpoint from the module - implement the write path only when that behavior is intentionally added to the skill ## Module Groups - `monitoring` Resource monitoring, dashboard current status, top processes, historical monitor data, GPU history. - `websites` Website list/detail, Nginx config reads, domain list, HTTPS config, SSL certificate reads, website log reads. - `apps` App catalog lookup, installed app list, installed app detail, service list, port/connection info. - `containers` Container list/status/detail, inspect, stats, streaming log reads. - `logs` Operation logs, login logs, system log file list, generic line-by-line log reads. - `cronjobs` Cronjob list/detail, next execution preview, execution records, record log reads. - `task-center` 1Panel task-center list and executing count. - `nodes` Node list, simple node list, node options, node summary. Some endpoints may require Pro/XPack. ## Resources - [references/module-groups.md](references/module-groups.md) Human-readable overview of module boundaries, common entrypoints, and reserved write scope. - [scripts/client.ts](scripts/client.ts) Shared authenticated 1Panel client. - [scripts/cli.ts](scripts/cli.ts) Executable CLI entry for runtime or shell-based tool calls. - [scripts/index.ts](scripts/index.ts) Registry of all module definitions. - `scripts/modules/*.ts` Module-specific actions and reserved mutation endpoint definitions. ## Execution Notes - Prefer the CLI instead of letting the model construct signed HTTP requests itself.
README.md
# 1Panel Skills
[English](./README.md) | [简体中文](./README.zh-CN.md)
TypeScript-based 1Panel operations skill for agent runtimes such as Hermes and OpenClaw.
## Features
- **Resource monitoring**: current node metrics, dashboard metrics, top CPU and memory processes, monitor history, GPU history
- **Website inspection**: website list and detail, Nginx config reads, domain reads, HTTPS config reads, SSL certificate reads, website log reads
- **Application inspection**: app catalog reads, installed app status checks, service reads, port and connection info reads
- **Container inspection**: container list, status, inspect, stats, and log reads
- **Log inspection**: operation logs, login logs, system log file list, generic log file reads
- **Cronjob inspection**: cronjob list and detail, next-run preview, execution records, record log reads
- **Task center inspection**: task center records and executing count
- **Node inspection**: node list, simple node list, node options, and node status reads
- **Future write operations reserved**: module-grouped mutation definitions are already reserved for create, update, delete, restart, and other managed actions
## Project Layout
```text
1Panel-skills/
├── SKILL.md # Skill instructions
├── README.md # English README
├── README.zh-CN.md # Chinese README
├── package.json # Node package metadata
├── tsconfig.json # TypeScript typecheck config
├── tsconfig.build.json # TypeScript build config
├── agents/
│ └── openai.yaml # UI metadata
├── dist/ # Prebuilt runtime files used by runtimes and CLI
│ ├── plugin.js
│ └── scripts/
│ ├── cli.js
│ ├── client.js
│ ├── index.js
│ └── modules/
├── references/
│ └── module-groups.md # Module overview and API notes
└── scripts/
├── cli.ts # Local CLI entry
├── client.ts # Signed 1Panel API client
├── index.ts # Module registry
├── types.ts # Shared types
└── modules/
├── monitoring.ts
├── websites.ts
├── apps.ts
├── containers.ts
├── logs.ts
├── cronjobs.ts
├── task-center.ts
└── nodes.ts
```
## Skill Overview
### 1panel-skills
General-purpose 1Panel operations skill for agent runtimes. The current implementation focuses on inspection and status-check interfaces while keeping grouped mutation endpoints reserved for future expansion.
#### Modules
| Module | Scope |
|------|------|
| `monitoring` | Dashboard metrics, current node status, top processes, monitor history, GPU history |
| `websites` | Website list/detail, config reads, HTTPS reads, certificate reads, website log reads |
| `apps` | App catalog reads, installed app status checks, service reads, port and connection info |
| `containers` | Container list, status, inspect, stats, and log reads |
| `logs` | Operation logs, login logs, syste_meta.json
{
"ownerId": "kn71e5k7bs22dwqepjnx1xwfcn82ddsf",
"slug": "1panel-skills",
"version": "0.0.3",
"publishedAt": 1779434141097
}references/module-groups.md
# Module Groups
This skill is organized as a general 1Panel operation skill.
## Authentication
The TypeScript client signs every request with:
- `1Panel-Timestamp`
- `1Panel-Token = md5("1panel" + API_KEY + TIMESTAMP)`
Environment variables:
- `ONEPANEL_BASE_URL`
- `ONEPANEL_API_KEY`
- optional: `ONEPANEL_TIMEOUT_MS`
- optional: `ONEPANEL_SKIP_TLS_VERIFY=true`
## Modules
### monitoring
- Dashboard OS and live resource status
- Current node summary
- Historical monitor series
- GPU monitor options and GPU history
Primary endpoints:
- `GET /api/v2/dashboard/base/os`
- `GET /api/v2/dashboard/base/:ioOption/:netOption`
- `GET /api/v2/dashboard/current/node`
- `GET /api/v2/dashboard/current/:ioOption/:netOption`
- `GET /api/v2/dashboard/current/top/cpu`
- `GET /api/v2/dashboard/current/top/mem`
- `GET /api/v2/hosts/monitor/setting`
- `POST /api/v2/hosts/monitor/search`
- `GET /api/v2/hosts/monitor/gpuoptions`
- `POST /api/v2/hosts/monitor/gpu/search`
### websites
- Website list and detail reads
- Nginx config reads
- Domain list
- HTTPS config reads
- SSL certificate list/detail reads
- Website log line reads through the generic file-log endpoint
Primary endpoints:
- `POST /api/v2/websites/search`
- `GET /api/v2/websites/list`
- `GET /api/v2/websites/:id`
- `GET /api/v2/websites/:id/config/:type`
- `GET /api/v2/websites/domains/:id`
- `GET /api/v2/websites/:id/https`
- `POST /api/v2/websites/ssl/search`
- `POST /api/v2/websites/ssl/list`
- `GET /api/v2/websites/ssl/:id`
- `POST /api/v2/files/read`
Reserved mutations are kept for create/update/delete/operate, SSL changes, and domain changes.
### apps
- Installed app list and detail
- App catalog lookup
- App version detail lookup
- Service/port/connection info reads
Primary endpoints:
- `POST /api/v2/apps/installed/search`
- `GET /api/v2/apps/installed/list`
- `GET /api/v2/apps/installed/info/:installId`
- `POST /api/v2/apps/search`
- `GET /api/v2/apps/:key`
- `GET /api/v2/apps/detail/:appId/:version/:type`
- `GET /api/v2/apps/services/:key`
- `POST /api/v2/apps/installed/loadport`
- `POST /api/v2/apps/installed/conninfo`
Use the installed app detail to resolve app status. Use the container module for app runtime logs.
### containers
- Container list and detail
- Docker status and resource limit
- Inspect and stats
- Streaming log reads
Primary endpoints:
- `POST /api/v2/containers/search`
- `POST /api/v2/containers/list`
- `GET /api/v2/containers/status`
- `GET /api/v2/containers/limit`
- `POST /api/v2/containers/info`
- `POST /api/v2/containers/inspect`
- `GET /api/v2/containers/stats/:id`
- `GET /api/v2/containers/list/stats`
- `GET /api/v2/containers/search/log`
### logs
- Core panel operation logs
- Core panel login logs
- System log file list
- Generic line-by-line log reads
Primary endpoints:
- `POST /api/v2/core/logs/operation`
- `POST /api/v2/core/logs/login`
- `GET /api/v2/logs/system/files`
- `POST /api/v2/files/read`
Common `files/read` log types:
- `website`
README.zh-CN.md
# 1Panel Skills
[English](./README.md) | [简体中文](./README.zh-CN.md)
面向 Hermes、OpenClaw 等 Agent 运行时的 1Panel 运维技能包,基于 TypeScript 实现。
## 功能特性
- **资源监控**:当前节点状态、仪表盘指标、CPU/内存 Top 进程、监控历史、GPU 历史
- **网站检查**:网站列表与详情、Nginx 配置读取、域名读取、HTTPS 配置读取、SSL 证书读取、网站日志读取
- **应用检查**:应用市场读取、已安装应用状态检查、服务信息读取、端口与连接信息读取
- **容器检查**:容器列表、状态、Inspect、资源统计、日志读取
- **日志检查**:操作日志、登录日志、系统日志文件列表、通用日志文件读取
- **定时任务检查**:定时任务列表与详情、下次执行预览、执行记录、记录日志读取
- **任务中心检查**:任务中心记录与执行中数量
- **节点检查**:节点列表、简化节点列表、节点选项、节点状态读取
- **预留写操作**:已经按模块预留创建、更新、删除、重启等变更接口定义,后续可继续扩展
## 目录结构
```text
1Panel-skills/
├── SKILL.md # 技能说明
├── README.md # 英文 README
├── README.zh-CN.md # 中文 README
├── package.json # Node 包元数据
├── tsconfig.json # TypeScript 类型检查配置
├── tsconfig.build.json # TypeScript 构建配置
├── agents/
│ └── openai.yaml # UI 元数据
├── dist/ # 运行时与 CLI 使用的预编译产物
│ ├── plugin.js
│ └── scripts/
│ ├── cli.js
│ ├── client.js
│ ├── index.js
│ └── modules/
├── references/
│ └── module-groups.md # 模块说明与 API 备注
└── scripts/
├── cli.ts # 本地 CLI 入口
├── client.ts # 1Panel 签名客户端
├── index.ts # 模块注册表
├── types.ts # 公共类型
└── modules/
├── monitoring.ts
├── websites.ts
├── apps.ts
├── containers.ts
├── logs.ts
├── cronjobs.ts
├── task-center.ts
└── nodes.ts
```
## 技能说明
### 1panel-skills
这是一个通用的 1Panel 操作技能,可供 OpenClaw、Hermes 等 Agent 运行时调用。当前实现以查询、读取、状态校验为主,同时保留了按模块分组的写操作预留定义,后续可以继续扩展。
#### 模块列表
| 模块 | 说明 |
|------|------|
| `monitoring` | 仪表盘指标、当前节点状态、Top 进程、监控历史、GPU 历史 |
| `websites` | 网站列表/详情、配置读取、HTTPS 读取、证书读取、网站日志读取 |
| `apps` | 应用市场读取、已安装应用状态检查、服务读取、端口与连接信息 |
| `containers` | 容器列表、状态、Inspect、资源统计、日志读取 |
| `logs` | 操作日志、登录日志、系统日志文件、通用日志读取 |
| `cronjobs` | 定时任务列表/详情、下次执行预览、记录、记录日志、脚本选项 |
| `task-center` | 任务中心记录与执行中数量 |
| `nodes` | 节点列表、节点选项、简化节点列表、节点状态 |
## 快速开始
### 1. 环境要求
- 建议使用 Node.js 18 或更高版本
- 可访问的 1Panel 实例
- 可用的 1Panel API Key
### 2. 配置 1Panel API
1. 登录 1Panel。
2. 进入 **设置** -> **API 接口**。
3. 开启 API 接口。
4. 复制 API Key。
5. 测试时建议放通客户端 IP:
- IPv4: `0.0.0.0/0`
- IPv6: `::/0`
1Panel API 鉴权需要这两个 Header:
- `1Panel-Timestamp`
- `1Panel-Token = md5("1panel" + API_KEY + TIMESTAMP)`
### 3. 安装到运行时
推荐本地安装方式:
```bash
mkdir -p ~/.openclaw/skills
ln -s /path/to/1Panel-skills ~/.openclaw/skills/1panel-skills
```
仓库已经包含 `dist/` 下的预编译运行产物,正常使用时不需要先手动重新构建。
### 4. 配置运行环境变量
```bash
export ONEPANEL_BASE_URL="http://192.168.1.2:9999"
export ONEPANEL_API_KEY="你的 1Panel API Key"
export ONEPANEL_TIMEOUT_MS="30000"
export ONEPANEL_SKIP_TLS_VERIFY="false"
```
## CLI 用法
查看支持的模块:
```bash
node dist/scripts/cli.js modules
```
查看某个模块的动作:
```bash
node dist/scripts/cli.js actions monitoring
```
发一个原始签名请求:
```bash
node dist/scripts/cli.js request GET /api/v2/dashboard/base/os
```
执行模块化动作:
```bash
node dist/scripts/cli.js run monitoring getCurreAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/1panel/skills/1panel-skills",
"sourceUrl": "https://clawhub.ai/1panel/skills/1panel-skills",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T23:53:08.361Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-1panel-1panel-skills/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-1panel-1panel-skills/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T23:53:08.361Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.9K downloads",
"href": "https://clawhub.ai/1panel/1panel-skills",
"sourceUrl": "https://clawhub.ai/1panel/1panel-skills",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T23:53:08.361Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.0.3",
"href": "https://clawhub.ai/1panel/1panel-skills",
"sourceUrl": "https://clawhub.ai/1panel/1panel-skills",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T07:15:41.097Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-1panel-1panel-skills/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-1panel-1panel-skills/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.0.3",
"description": "- Renamed the skill to 1panel-skills for neutral agent runtime usage and updated all documentation. - Improved README and added LICENSE and multilingual README documents. - Modernized skill packaging; removed legacy plugin and manifest files. - Updated CLI and core scripts to reflect new naming and agent integration approach.",
"href": "https://clawhub.ai/1panel/1panel-skills",
"sourceUrl": "https://clawhub.ai/1panel/1panel-skills",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T07:15:41.097Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
