OpenClaw 1Panel
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 an OpenClaw runtime:
-
ONEPANEL_BASE_URL
-
ONEPANEL_API_KEY
- optional:
ONEPANEL_TIMEOUT_MS
- optional: INLINECODE3
Workflow
- 1. Choose the module that matches the user's request.
- Start with a list or search action to identify the exact target.
- Read detail, status, or logs only after the target is confirmed.
- 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
Resource monitoring, dashboard current status, top processes, historical monitor data, GPU history.
Website list/detail, Nginx config reads, domain list, HTTPS config, SSL certificate reads, website log reads.
App catalog lookup, installed app list, installed app detail, service list, port/connection info.
Container list/status/detail, inspect, stats, streaming log reads.
Operation logs, login logs, system log file list, generic line-by-line log reads.
Cronjob list/detail, next execution preview, execution records, record log reads.
1Panel task-center list and executing count.
Node list, simple node list, node options, node summary. Some endpoints may require Pro/XPack.
Resources
Human-readable overview of module boundaries, common entrypoints, and reserved write scope.
Shared authenticated 1Panel client.
Executable CLI entry for OpenClaw or shell-based tool calls.
Registry of all module definitions.
Module-specific actions and reserved mutation endpoint definitions.
Execution Notes
- - Prefer the CLI instead of letting the model construct signed HTTP requests itself.
- The repository can ship prebuilt runtime files under
dist/, so normal use should call node dist/scripts/cli.js ... directly without rebuilding first. - Run
npm run build only after changing TypeScript source files such as plugin.ts or scripts/**/*.ts. - OpenClaw plugin loading should target the compiled entry at
dist/plugin.js, not the TypeScript source file. - If the OpenClaw runtime can execute TypeScript directly, import from scripts/index.ts and call the module actions.
- If the runtime cannot execute TypeScript directly, use the TypeScript files as the source of truth for methods, paths, query parameters, and request payload shapes.
- The current implementation focuses on query and inspection actions; extend the reserved mutation definitions when you intentionally add managed write flows.
OpenClaw 1Panel
概述
使用此技能通过经过身份验证的HTTP API调用与1Panel实例进行交互。捆绑的资源是按模块分组的TypeScript源文件,目前已实现面向查询的操作,变更端点保留供后续扩展。
要求
- - 需要具有目标实例访问权限的1Panel API密钥。
- 在OpenClaw运行时中执行TypeScript资源时需要以下环境变量:
- ONEPANEL
BASEURL
- ONEPANEL
APIKEY
- 可选:ONEPANEL
TIMEOUTMS
- 可选:ONEPANEL
SKIPTLS_VERIFY=true
工作流程
- 1. 选择与用户请求匹配的模块。
- 从列表或搜索操作开始,以确定确切目标。
- 仅在确认目标后读取详情、状态或日志。
- 如果用户要求创建、更新、删除、重启、停止或任何其他变更操作:
- 不要编造或猜测写入工作流程
- 从模块中展示匹配的保留变更端点
- 仅在有意将该行为添加到技能中时实现写入路径
模块组
资源监控、仪表盘当前状态、进程排行、历史监控数据、GPU历史。
网站列表/详情、Nginx配置读取、域名列表、HTTPS配置、SSL证书读取、网站日志读取。
应用目录查询、已安装应用列表、已安装应用详情、服务列表、端口/连接信息。
容器列表/状态/详情、检查、统计、流式日志读取。
操作日志、登录日志、系统日志文件列表、通用逐行日志读取。
定时任务列表/详情、下次执行预览、执行记录、记录日志读取。
1Panel任务中心列表和执行计数。
节点列表、简单节点列表、节点选项、节点摘要。部分端点可能需要Pro/XPack。
资源
模块边界、通用入口点和保留写入范围的可读概述。
共享的经过身份验证的1Panel客户端。
用于OpenClaw或基于shell的工具调用的可执行CLI入口。
所有模块定义的注册表。
模块特定操作和保留的变更端点定义。
执行说明
- - 优先使用CLI,而不是让模型自行构造签名HTTP请求。
- 仓库可以在dist/下提供预构建的运行时文件,因此正常使用应直接调用node dist/scripts/cli.js ...,无需先重新构建。
- 仅在更改TypeScript源文件(如plugin.ts或scripts//*.ts)后运行npm run build。
- OpenClaw插件加载应针对编译后的入口dist/plugin.js,而不是TypeScript源文件。
- 如果OpenClaw运行时可以直接执行TypeScript,则从scripts/index.ts导入并调用模块操作。
- 如果运行时无法直接执行TypeScript,则将TypeScript文件作为方法、路径、查询参数和请求负载结构的真实来源。
- 当前实现侧重于查询和检查操作;当有意添加托管写入流程时,扩展保留的变更定义。