adguard
Control AdGuard Home DNS filtering via HTTP API. Use when managing blocklists/allowlists, checking domain filtering status, toggling protection, or clearing DNS cache. Supports blocking/allowing domains, viewing statistics, and protecting/disabling DNS filtering.
Why use this skill?
Easily manage your AdGuard Home DNS filtering, blocklists, and security statistics using natural language commands with OpenClaw AI.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/rowbotik/adguardWhat This Skill Does
The AdGuard Home controller skill provides a robust interface for managing your network-wide DNS filtering system directly from the OpenClaw AI agent. By interacting with the AdGuard Home REST API, this skill empowers you to toggle DNS protection, inspect domain filtering status, manage custom allowlists and blocklists, and monitor real-time DNS request statistics. It abstracts the complexity of cURL commands into intuitive natural language commands, enabling hands-free management of your home or office network's privacy and security settings.
Installation
To integrate this skill into your OpenClaw environment, execute the command: clawhub install openclaw/skills/skills/rowbotik/adguard. Post-installation, ensure you have set your ADGUARD_URL, ADGUARD_USERNAME, and ADGUARD_PASSWORD via environment variables. For improved security, you may optionally create a ~/.adguard/config.json file to store non-sensitive configuration data while keeping the password managed as an environment variable.
Use Cases
- Family Protection: Quickly block specific distracting sites or categories without logging into the web dashboard.
- Troubleshooting: If a website is not loading properly, use the AI to check if it's being blocked by AdGuard, then instantly whitelist it.
- System Health: Use the status command to check blocked request metrics to ensure your network filters are functioning as expected.
- Privacy Management: Temporarily disable protection for maintenance tasks or developer testing and re-enable it immediately after.
Example Prompts
- "Check if github.com is currently being blocked by my AdGuard filters."
- "I'm having trouble with payments on myshop.com, please add it to the allowlist immediately."
- "Show me the current DNS filtering statistics and tell me the block rate."
Tips & Limitations
This skill requires your AdGuard instance to be reachable via the network specified in your URL configuration. If you are using a local instance, ensure the port 3000 is open. Always remember to run the cache-clear command after applying significant blocklist changes to ensure the DNS resolver flushes its records immediately. Note that this tool does not provide full management of every sub-setting in the AdGuard UI, but focuses on the most critical operational tasks for day-to-day filtering control.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-rowbotik-adguard": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, external-api