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

• 1Panel server (https://1panel.cn/)
• API key from 1Panel Dashboard → Profile → API

Configuration

Set environment variables:

export ONEPANEL_API_KEY="your-api-key"
export ONEPANEL_HOST="localhost"      # optional, default: localhost
export ONEPANEL_PORT="8080"           # optional, default: 8080
export ONEPANEL_PROTOCOL="http"       # optional, default: http

Quick Start

# List containers
node {baseDir}/scripts/1panel.mjs containers

# Get container info
node {baseDir}/scripts/1panel.mjs container \x3Cid>

# Start/Stop/Restart container
node {baseDir}/scripts/1panel.mjs start \x3Cid>
node {baseDir}/scripts/1panel.mjs stop \x3Cid>
node {baseDir}/scripts/1panel.mjs restart \x3Cid>

# 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

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

• GitHub
• npm
• 1Panel