dvcrn openclaw-inwx
OpenClaw plugin for INWX (InterNetworX) domain registrar automation.
It provides 23 tools for domain lifecycle operations, DNS management, DNSSEC, contact handling, WHOIS, and account checks.
Features
- INWX DomRobot JSON-RPC integration via
domrobot-client - Environment switch:
productionorote - Optional 2FA login support (
otpSecret) - Safety controls:
readOnlyblocks all write toolsallowedOperationsallowlist for tool-level policy
- TypeScript strict mode
Installation
npm install @elvatis_com/openclaw-inwx
For local development:
npm install
npm run build
npm test
INWX Account Setup
- Create or use your INWX account.
- Enable API access in INWX account settings.
- If 2FA is enabled, provide a shared secret via
otpSecret. - For safe testing, use OTE environment (
ote.inwx.com).
Plugin Config
{
"username": "your-inwx-user",
"password": "your-inwx-password",
"otpSecret": "optional-2fa-secret",
"environment": "ote",
"readOnly": false,
"allowedOperations": []
}
Tool List
Read Tools
inwx_domain_check- INWX method:
domain.check - Params:
domain(string)
- INWX method:
inwx_domain_list- INWX method:
domain.list - Params: optional filters (object)
- INWX method:
inwx_domain_info- INWX method:
domain.info - Params:
domain(string)
- INWX method:
inwx_domain_pricing- INWX method:
domain.check - Params:
domain(string) ordomains(string[])
- INWX method:
inwx_nameserver_list- INWX method:
nameserver.listordomain.info - Params: optional
domain
- INWX method:
inwx_dns_record_list- INWX method:
nameserver.info - Params:
domain(string)
- INWX method:
inwx_dnssec_list- INWX method:
dnssec.info - Params: optional filters
- INWX method:
inwx_contact_list- INWX method:
contact.list - Params: optional filters
- INWX method:
inwx_whois- INWX method:
domain.whois - Params:
domain(string)
- INWX method:
inwx_account_info- INWX method:
account.info - Params: none
- INWX method:
Write Tools
inwx_domain_register- INWX method:
domain.create - Params:
domain,period,contacts,ns
- INWX method:
inwx_domain_update- INWX method:
domain.update - Params: method payload
- INWX method:
inwx_domain_delete- INWX method:
domain.delete - Params: method payload
- INWX method:
inwx_domain_transfer- INWX method:
domain.transfer - Params: method payload
- INWX method:
inwx_domain_renew- INWX method:
domain.renew - Params: method payload
- INWX method:
inwx_nameserver_set- INWX method:
domain.update - Params:
domain,ns(string[])
- INWX method:
inwx_dns_record_add- INWX method:
nameserver.createRecord - Params: method payload
- INWX method:
inwx_dns_record_update- INWX method:
nameserver.updateRecord - Params: method payload
- INWX method:
inwx_dns_record_delete- INWX method:
nameserver.deleteRecord - Params: method payload
- INWX method:
inwx_dnssec_enable- INWX method:
dnssec.create - Params: method payload
- INWX method:
inwx_dnssec_disable- INWX method:
dnssec.delete - Params: method payload
- INWX method:
inwx_contact_create- INWX method:
contact.create - Params: method payload
- INWX method:
inwx_contact_update- INWX method:
contact.update - Params: method payload
- INWX method:
OTE Test Environment
Set:
{ "environment": "ote" }
This points the client to INWX OTE API endpoint and allows free integration testing without production costs.
Integration with openclaw-ispconfig
This plugin exports provisionDomainWithHosting() for end-to-end domain-to-hosting provisioning. It orchestrates both plugins without a hard dependency:
- Domain check -
inwx_domain_check - Domain register -
inwx_domain_register(skipped if taken orskipRegistration=true) - Nameserver set -
inwx_nameserver_set - Hosting provision -
isp_provision_site(site, DNS zone, mail, database)
import { buildToolset, provisionDomainWithHosting } from "@elvatis_com/openclaw-inwx";
import ispPlugin from "@elvatis_com/openclaw-ispconfig";
const result = await provisionDomainWithHosting(
buildToolset(inwxConfig),
ispPlugin.buildToolset(ispConfig),
{ domain: "example.com", nameservers: ["ns1.host.de"], serverIp: "1.2.3.4", clientName: "Acme", clientEmail: "a@acme.com" },
);
Safety
readOnly=trueallows only:- domain check/list/info/pricing
- nameserver list
- dns record list
- dnssec list
- contact list
- whois
- account info
allowedOperationscan restrict to explicit tool names.
Notes
- No live tests are included in this repository.
- Unit tests use mocks only.