1Panel Skill
Manage 1Panel servers through AI agents. Full access to 580+ API endpoints covering containers, databases, websites, SSL, file management, system monitoring, and more.
Prerequisites
Configuration
Set environment variables:
export
export # optional, default: localhost
export # optional, default: 8080
export # optional, default: http
Quick Start
# List containers
node {baseDir}/scripts/1panel.mjs containers
# Get container info
node {baseDir}/scripts/1panel.mjs container <id>
# Start/Stop/Restart container
node {baseDir}/scripts/1panel.mjs start <id>
node {baseDir}/scripts/1panel.mjs stop <id>
node {baseDir}/scripts/1panel.mjs restart <id>
# List images
node {baseDir}/scripts/1panel.mjs images
# List websites
node {baseDir}/scripts/1panel.mjs websites
# List databases
node {baseDir}/scripts/1panel.mjs databases
# List files
node {baseDir}/scripts/1panel.mjs files /opt
# Get system info
node {baseDir}/scripts/1panel.mjs system
# Get dashboard info
node {baseDir}/scripts/1panel.mjs dashboard
Available Commands
| Command |
Description |
containers |
List all Docker containers |
container <id> |
Get container details |
start <id> |
Start a container |
stop <id> |
Stop a container |
restart <id> |
Restart a container |
images |
List Docker images |
websites |
List websites |
databases |
List databases |
files <path> |
List files in directory |
system |
Get system information |
dashboard |
Get dashboard information |
API Coverage
Container & Docker (24 tools)
- Container lifecycle (create, start, stop, restart, pause, kill, remove)
- Image management (pull, push, build, tag, save, load)
- Network & Volume management
- Docker Compose operations
Website Management (24 tools)
- Website creation and configuration
- Domain management
- SSL certificate (Let's Encrypt, manual upload)
- HTTPS configuration
- Nginx configuration
- OpenResty (XPack)
Database (24 tools)
- MySQL (create, delete, bind user, change password)
- PostgreSQL
- Redis (config, password, status)
File Operations (19 tools)
- List, upload, download
- Compress/Decompress (zip, tar, tar.gz)
- Move, rename, delete
- Permissions (chmod, chown)
System & Security (20+ tools)
- System settings
- Firewall rules
- Fail2ban
- SSH management
- ClamAV antivirus
- FTP server
Monitoring (8 tools)
- Dashboard
- System monitor
- Device info
- Disk management
Backup & Recovery (13 tools)
- Backup operations
- Backup accounts (local, SFTP, OSS, S3)
- System snapshots
- Recycle bin
XPack Features (47 tools)
- AI Agent management
- MCP Server
- Ollama models
- GPU monitoring
- OpenResty
- Node.js runtime
Output Format
All commands output JSON:
{
"data": [...],
"success": true
}
Or on error:
{
"error": true,
"message": "Error description"
}
Advanced Usage
For full API access, use as a library:
import { OnePanelClient } from '1panel-skill';
const client = new OnePanelClient({
host: 'localhost',
port: 8080,
apiKey: 'your-api-key',
protocol: 'http'
});
// Full API access
const containers = await client.containers.list();
const websites = await client.websites.list();
Links
1---2name: 1panel3version: 1.0.04description: Comprehensive 1Panel server management skill for AI agents. Manage Linux servers, Docker containers, databases, websites, SSL certificates, and more through 580+ API endpoints.5homepage: https://github.com/EaveLuo/1panel-skill6metadata:7 source: https://skillmd.com/skills/lord1egypt/1panel8 clawdbot:9 emoji: 🖥️10 requires:11 bins:12 - node13 env:14 - ONEPANEL_API_KEY15 primaryEnv: ONEPANEL_API_KEY16---1718# 1Panel Skill1920Manage 1Panel servers through AI agents. Full access to 580+ API endpoints covering containers, databases, websites, SSL, file management, system monitoring, and more.2122## Prerequisites2324- 1Panel server (https://1panel.cn/)25- API key from 1Panel Dashboard → Profile → API2627## Configuration2829Set environment variables:3031```bash32export ONEPANEL_API_KEY="your-api-key"33export ONEPANEL_HOST="localhost" # optional, default: localhost34export ONEPANEL_PORT="8080" # optional, default: 808035export ONEPANEL_PROTOCOL="http" # optional, default: http36```3738## Quick Start3940```bash41# List containers42node {baseDir}/scripts/1panel.mjs containers4344# Get container info45node {baseDir}/scripts/1panel.mjs container <id>4647# Start/Stop/Restart container48node {baseDir}/scripts/1panel.mjs start <id>49node {baseDir}/scripts/1panel.mjs stop <id>50node {baseDir}/scripts/1panel.mjs restart <id>5152# List images53node {baseDir}/scripts/1panel.mjs images5455# List websites56node {baseDir}/scripts/1panel.mjs websites5758# List databases59node {baseDir}/scripts/1panel.mjs databases6061# List files62node {baseDir}/scripts/1panel.mjs files /opt6364# Get system info65node {baseDir}/scripts/1panel.mjs system6667# Get dashboard info68node {baseDir}/scripts/1panel.mjs dashboard69```7071## Available Commands7273| Command | Description |74|---------|-------------|75| `containers` | List all Docker containers |76| `container <id>` | Get container details |77| `start <id>` | Start a container |78| `stop <id>` | Stop a container |79| `restart <id>` | Restart a container |80| `images` | List Docker images |81| `websites` | List websites |82| `databases` | List databases |83| `files <path>` | List files in directory |84| `system` | Get system information |85| `dashboard` | Get dashboard information |8687## API Coverage8889### Container & Docker (24 tools)90- Container lifecycle (create, start, stop, restart, pause, kill, remove)91- Image management (pull, push, build, tag, save, load)92- Network & Volume management93- Docker Compose operations9495### Website Management (24 tools)96- Website creation and configuration97- Domain management98- SSL certificate (Let's Encrypt, manual upload)99- HTTPS configuration100- Nginx configuration101- OpenResty (XPack)102103### Database (24 tools)104- MySQL (create, delete, bind user, change password)105- PostgreSQL106- Redis (config, password, status)107108### File Operations (19 tools)109- List, upload, download110- Compress/Decompress (zip, tar, tar.gz)111- Move, rename, delete112- Permissions (chmod, chown)113114### System & Security (20+ tools)115- System settings116- Firewall rules117- Fail2ban118- SSH management119- ClamAV antivirus120- FTP server121122### Monitoring (8 tools)123- Dashboard124- System monitor125- Device info126- Disk management127128### Backup & Recovery (13 tools)129- Backup operations130- Backup accounts (local, SFTP, OSS, S3)131- System snapshots132- Recycle bin133134### XPack Features (47 tools)135- AI Agent management136- MCP Server137- Ollama models138- GPU monitoring139- OpenResty140- Node.js runtime141142## Output Format143144All commands output JSON:145146```json147{148 "data": [...],149 "success": true150}151```152153Or on error:154155```json156{157 "error": true,158 "message": "Error description"159}160```161162## Advanced Usage163164For full API access, use as a library:165166```typescript167import { OnePanelClient } from '1panel-skill';168169const client = new OnePanelClient({170 host: 'localhost',171 port: 8080,172 apiKey: 'your-api-key',173 protocol: 'http'174});175176// Full API access177const containers = await client.containers.list();178const websites = await client.websites.list();179```180181## Links182183- [GitHub](https://github.com/EaveLuo/1panel-skill)184- [npm](https://www.npmjs.com/package/1panel-skill)185- [1Panel](https://1panel.cn/)