Porkbun DNS Management Skill for OpenClaw
Manage Porkbun DNS records and domains via API v3.
Overview
This skill enables OpenClaw to manage DNS records on Porkbun's DNS service. It includes a CLI tool for reliable, deterministic DNS operations.
Installation
For OpenClaw Users
Installation will be available via clawhub.ai once published. The skill file is porkbun.skill.
Manual Installation
- Download
porkbun.skill - Install in your OpenClaw skills directory
- Configure API credentials (see Setup below)
Setup
1. Get API Keys
Generate API keys at: https://porkbun.com/account/api
2. Configure Credentials
Create ~/.config/porkbun/config.json:
{
"apiKey": "your-porkbun-api-key",
"secretApiKey": "your-porkbun-secret-key"
}
Important: These keys are sensitive. Keep them secure and don't commit them to git.
3. Enable API Access
For each domain you want to manage:
- Go to Domain Management on Porkbun
- Click Details next to the domain
- Enable "API Access"
Usage
The skill integrates with OpenClaw and provides automated DNS management. Common operations:
- Create records: A, AAAA, CNAME, MX, TXT, and more
- List domains and records
- Update existing records
- Delete records
- Batch operations by type/subdomain
Example conversations:
- "Create an A record for www.example.com pointing to 1.1.1.1"
- "Update the MX record for example.com to use Google Workspace"
- "Delete all TXT records for old.example.com"
Features
- Full API v3 support: All Porkbun DNS endpoints
- CLI tool included: Deterministic operations via
scripts/porkbun-dns.js - Comprehensive documentation: Reference guides for all record types
- Batch operations: Edit/delete multiple records at once
- Common patterns: Pre-built workflows for websites, email, dynamic DNS
Documentation
Inside the skill:
- SKILL.md - Main usage guide
- references/dns-record-types.md - Complete DNS record reference
Online:
Development
Repository Structure
porkbun/
├── SKILL.md # Main skill documentation
├── scripts/
│ └── porkbun-dns.js # CLI tool
└── references/
└── dns-record-types.md # DNS reference
Building the .skill file
cd ~/.openclaw/workspace/skills/public/porkbun
zip -r ../porkbun.skill SKILL.md scripts/ references/
Testing
Test connection:
node scripts/porkbun-dns.js ping
List your domains:
node scripts/porkbun-dns.js list
Contributing
This skill is maintained for the OpenClaw community. For issues or improvements:
- Check this repository
- Open an issue or pull request
License
Provided as-is for use with OpenClaw.