Adguard Test

What This Skill Does

The Adguard Test skill by foxleoly provides a robust interface for interacting with AdGuard Home instances directly from your OpenClaw workspace. It enables seamless monitoring and management of your DNS infrastructure by bridging the gap between your local terminal and your network security services. This skill allows you to retrieve real-time DNS statistics, analyze blocked domain traffic, view client activity, and monitor the overall health status of your DNS server instances. It is designed for system administrators and privacy-conscious users who want to keep a close eye on their network traffic without needing to navigate complex web dashboards every time they need quick diagnostics.

Installation

Installation is streamlined for maximum efficiency. The recommended approach is using the ClawHub CLI: run clawhub install openclaw/skills/skills/foxleoly/adguard-test to pull the latest version directly from the registry. For those who prefer manual control, you can clone the repository from the official source at https://github.com/foxleoly/adguard-home-skill.git, place the contents into your ~/.openclaw/workspace/skills/adguard-home/ directory, and initialize your configuration. Post-installation, it is mandatory to create a secure adguard-instances.json file in your workspace containing the URL and credentials for each of your AdGuard instances, ensuring you set the file permissions to 600 for security.

Use Cases

This skill is perfect for home lab environments and small office networks. Use it to troubleshoot connectivity issues by checking service status, identify potential malicious activity by reviewing the blocked domain leaderboard, or verify the effectiveness of your custom filtering rules. It acts as an early warning system, letting you know if a DNS service has gone down or if specific clients are experiencing unusual traffic patterns, helping you maintain a secure and reliable internet connection for all devices on your local network.

Example Prompts

1. "Check the current health and service status of my home DNS instance dns1."
2. "Show me the top 10 blocked domains on dns1 so I can see what is being filtered."
3. "List the most recent 20 DNS queries captured by the dns1 server."

Tips & Limitations

To get the most out of this skill, ensure that your AdGuard Home instances have their API ports reachable from the machine where OpenClaw is installed. Always use HTTPS if your AdGuard instance supports it to prevent credentials from being transmitted in plain text. Note that this skill is read-heavy for monitoring purposes; perform any major configuration changes (like adding new blocklists) through the official AdGuard web dashboard, as this skill focuses primarily on reporting and real-time observability.