A specialized tool for programmatic management of Porkbun DNS records and domain assets using API v3.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install porkbun-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install porkbun-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Porkbun DNS Management?
This Openclaw Skills integration provides a robust interface for interacting with the Porkbun API v3. It enables developers and automated systems to manage domain DNS records—including A, AAAA, CNAME, MX, and TXT types—directly through a CLI or via agentic workflows. By leveraging this skill, you can streamline infrastructure setup, automate email configurations, and handle dynamic DNS updates without manual intervention in the Porkbun dashboard.
The tool is designed for reliability and speed, allowing you to query domain lists and manipulate records using a deterministic JavaScript-based CLI. This ensures that your DNS configurations are consistent and reproducible across different environments and projects.
Porkbun DNS Management Use Cases
- Automating website setup by creating root A records and www CNAMEs.
- Programmatically configuring MX and SPF records for email providers like Google Workspace.
- Updating Dynamic DNS records for home labs or remote servers using shell scripts.
- Managing wildcard DNS entries for complex application routing.
- Batch auditing or listing all domains and records across a Porkbun account.
How Porkbun DNS Management Works
- The skill initializes by loading API credentials from a local configuration file or environment variables.
- It establishes a secure connection to the Porkbun API v3 endpoint at api.porkbun.com.
- Users or agents issue commands through the provided JavaScript CLI tool to perform CRUD operations on DNS records.
- The skill validates record types and parameters (like the 600-second TTL minimum) before sending requests to the API.
- It processes the JSON response from Porkbun to confirm success or provide detailed error reporting for troubleshooting.
Porkbun DNS Management Setup
First, generate your API keys at the Porkbun account dashboard. Then, save your credentials to ~/.config/porkbun/config.json:
{
"apiKey": "your-api-key",
"secretApiKey": "your-secret-api-key"
}
Alternatively, you can set environment variables in your terminal:
export PORKBUN_API_KEY="your-api-key"
export PORKBUN_SECRET_API_KEY="your-secret-api-key"
Finally, ensure API Access is enabled for each specific domain within the Porkbun Domain Management settings. You can test the connection using the following command:
node ~/.openclaw/workspace/skills/public/porkbun/scripts/porkbun-dns.js ping
Porkbun DNS Management Data Schema & Taxonomy
The skill utilizes a configuration schema and interacts with Porkbun's record objects as defined below:
| Field | Description |
|---|---|
| id | Unique identifier for a DNS record |
| type | Record type (A, CNAME, MX, TXT, etc.) |
| name | Subdomain or host (use @ for root) |
| content | The value of the record (IP, hostname, or text) |
| ttl | Time to Live (minimum 600 seconds) |
| prio | Priority for MX or SRV records |
Porkbun DNS Management Advanced Features
- Bulk record editing using the edit-by command to update all matching subdomains simultaneously.
- Support for specialized and modern record types including ALIAS, TLSA, CAA, HTTPS, and SSHFP.
- Integration-ready CLI output designed for use in automated CI/CD pipelines or Openclaw Skills workflows.
- Deterministic record management allowing for precise deletions and updates by unique record ID.
- Flexible credential fallback system that supports both local JSON configuration and system environment variables.
SKILL.md
Loading
Related Openclaw Skills
Minecraft Server Monitor
A lightweight CLI tool for real-time monitoring of Minecraft server status, player counts, and connection latency.
clawl-register
A specialized skill for registering AI agents on Clawl to ensure discoverability and track ranking.
Superpowers AI Coding Workflow
A mandatory, spec-first TDD workflow that leverages subagents to brainstorm, plan, and execute robust software development tasks.
US-Iran War Situation Tracker (English)
A specialized intelligence skill designed for hyper-current tactical tracking and reporting on the US-Iran conflict using a strictly verified 6-hour intelligence cycle.
Tasmota Device Management
Automate the discovery and control of Tasmota-powered smart home devices on your local network using Openclaw Skills.
AI Project Learner
AI Project Learner analyzes project descriptions to generate structured concept dependency graphs and prioritized learning roadmaps for developers.
METADATA
Featured*
