openclaw-ispconfig

OpenClaw 插件，用于通过 ISPConfig 的远程 JSON API 管理站点、DNS、邮件、数据库、定时任务（cron）等资源，提供 31 个工具，并支持一键式站点配置（provisioning）。

安装

ClawHub

clawhub install openclaw-ispconfig

npm

npm install @elvatis_com/openclaw-ispconfig

ISPConfig 配置

1. 在 ISPConfig 中创建一个远程用户（Remote User）。
2. 授予该用户所需的 API 权限。
3. 复制 API 终端地址（endpoint URL）及认证凭据（credentials）。
4. 在 OpenClaw 中配置本插件。

配置

openclaw.plugin.json 中支持的配置项：

• apiUrl（必需）：ISPConfig JSON API 地址
• username（必需）：远程用户名
• password（必需，密钥）：远程用户密码
• serverId（默认值 1）：默认服务器 ID
• defaultServerIp（可选）：用于自动配置 DNS A 记录的备用 IP 地址
• readOnly（默认值 false）：启用后将禁用所有写入类工具
• allowedOperations（默认值 []）：允许调用的工具名称白名单
• verifySsl（默认值 true）：是否校验 TLS 证书

工具列表

只读类工具

• isp_methods_list 参数：无
• isp_system_info 参数：无
• isp_client_list 参数：可选的筛选字段
• isp_client_get 参数：client_id
• isp_sites_list 参数：支持 sites_web_domain_get 接受的所有可选筛选参数
• isp_site_get 参数：primary_id（也可使用 site_id 或 domain_id）
• isp_domains_list 参数：无
• isp_dns_zone_list 参数：与用户相关的筛选参数
• isp_dns_record_list 参数：zone_id
• isp_mail_domain_list 参数：可选的筛选条件
• isp_mail_user_list 参数：可选的筛选条件
• isp_db_list 参数：与用户相关的筛选条件
• isp_ssl_status 参数：无
• isp_quota_check 参数：client_id
• isp_backup_list 参数：无（若对应 API 方法不可用，则返回跳过状态）
• isp_cron_list 参数：可选的筛选条件

写入类工具

• isp_client_add 参数：符合 ISPConfig client_add 接口要求的有效载荷（payload）
• isp_site_add 参数：符合 ISPConfig sites_web_domain_add 接口要求的有效载荷
• isp_domain_add 参数：isp_site_add 的别名
• isp_dns_zone_add 参数：符合 ISPConfig dns_zone_add 接口要求的有效载荷
• isp_dns_record_add 参数：需包含 type（如 A、AAAA、MX、TXT、CNAME）及对应类型所需字段的有效载荷
• isp_dns_record_delete 参数：需包含 type 及对应类型的删除操作有效载荷
• isp_mail_domain_add 参数：符合 ISPConfig mail_domain_add 接口要求的有效载荷
• isp_mail_user_add 参数：符合 ISPConfig mail_user_add 接口要求的有效载荷
• isp_mail_user_delete 参数：符合 ISPConfig mail_user_delete 接口要求的有效载荷
• isp_db_add 参数：符合 ISPConfig sites_database_add 接口要求的有效载荷
• isp_db_user_add 参数：符合 ISPConfig sites_database_user_add 接口要求的有效载荷
• isp_shell_user_add 参数：符合 ISPConfig sites_shell_user_add 接口要求的有效载荷
• isp_ftp_user_add 参数：符合 ISPConfig sites_ftp_user_add 接口要求的有效载荷
• isp_cron_add 参数：符合 ISPConfig sites_cron_add 接口要求的有效载荷

配置类工具

• isp_provision_site
• 必需参数：
  • domain
  • clientName
  • clientEmail
• 可选参数：
  • serverIp
  • createMail（默认值 true）
  • createDb（默认值 true）
  • serverId（默认使用配置文件中指定的值）

执行流程如下：

1. 创建客户（client）
2. 创建网站（site），并启用 SSL 和 Let's Encrypt 支持
3. 创建 DNS 区域（zone）
4. 添加 DNS 记录（包括 A、CNAME、SPF TXT、DMARC TXT）
5. （可选）创建邮件域名（mail domain）以及 info@ 和 admin@ 邮箱账户
6. （可选）创建数据库用户和数据库
7. 确保网站已启用 SSL 相关标志

安全性

• 设置 readOnly=true 将禁用全部写入类工具与配置类工具
• 设置 allowedOperations=[...] 仅允许调用白名单中明确列出的工具

开发

npm run build
npm test

运行集成测试时，请提供以下环境变量：

• ISPCONFIG_API_URL
• ISPCONFIG_USER
• ISPCONFIG_PASS

许可证

MIT