← Back to Skills Marketplace
115
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install adguard-home-manager
Description
Manage AdGuard Home network-wide DNS ad blocking. Query blocklist stats, add/remove custom DNS rules, check filtering status, and view top blocked domains fr...
README (SKILL.md)
AdGuard Home
Manage AdGuard Home — the network-wide DNS server that blocks ads, trackers, and malware for your entire network.
Setup
- Install AdGuard Home on your VPS or home server
- Create a user for the agent: Settings → AdGuard Home → Users → Add User
- Get your base URL (e.g.
http://192.168.1.1:3000orhttps://your-vps.example.com) - Export env vars:
export ADGUARD_USERNAME=your_username
export ADGUARD_PASSWORD=your_password
export ADGUARD_BASE_URL=http://192.168.1.1:3000
Tools
status
Get overall AdGuard Home status — DNS status, filtering enabled, protection level.
adguard-home-status
stats
Get filtering statistics: total blocked, allowed, queries today, top blocked domains.
adguard-home-stats [period] # period: hour, day, week, month, year (default: day)
blocked_domains
Get the most frequently blocked domains.
adguard-home-blocked-domains [limit] # default: 20
add_rule
Add a custom DNS blocking rule.
adguard-home-add-rule "\x3Cdomain or rule>"
# Examples:
# adguard-home-add-rule "example.com" # block single domain
# adguard-home-add-rule "||example.com^" # AdGuard blocking syntax
# adguard-home-add-rule "@||example.com^" # allowlist exception
remove_rule
Remove a custom DNS rule by content.
adguard-home-remove-rule "\x3Crule>"
list_rules
List all custom DNS rewrite rules.
adguard-home-list-rules
query_log
Query the DNS query log — find what domains were resolved on the network.
adguard-home-query-log [domain_filter] [limit]
# Example: adguard-home-query-log "ads" 50
toggle_filtering
Enable or disable DNS filtering (ad blocking).
adguard-home-toggle-filtering true # or false
Notes
- AdGuard Home API:
https://github.com/AdguardTeam/AdGuardHome/wiki/Config#web-interface - Authentication uses HTTP Basic Auth with username:password
- Rate limiting: avoid querying the query_log with very large limits
- DNS rewrite rules can create custom DNS responses (A, AAAA, CNAME records)
Usage Guidance
This skill appears to do exactly what it says: manage a self‑hosted AdGuard Home via its HTTP API using the provided credentials. Before installing: (1) only provide ADGUARD_USERNAME/ADGUARD_PASSWORD for a trusted AdGuard server (use HTTPS for remote servers); (2) prefer creating a dedicated account with only the permissions the agent needs (note: adding/removing rules and toggling filtering require write/admin rights); (3) review the included scripts yourself (they attempt multiple AdGuard endpoints and may behave differently across AdGuard versions); (4) avoid using this skill with highly privileged credentials on untrusted networks and rotate the password if it is later shared or exposed. If you need stricter safety, run the scripts manually or use a read‑only account for monitoring actions and a separate admin account only when you explicitly approve changes.
Capability Analysis
Type: OpenClaw Skill
Name: adguard-home-manager
Version: 1.0.0
The skill bundle provides legitimate tools for managing AdGuard Home, but it contains a significant security vulnerability in `scripts/rules.sh`. The script unsafely interpolates the `$RULE` variable directly into `jq` filters and JSON payloads (e.g., using `"rule": "'"$RULE"'"`), which allows for JSON injection or potential command injection if the input is crafted to break out of the shell quotes. While the behavior aligns with the stated purpose, the lack of input sanitization in a script handling network configuration is a high-risk flaw.
Capability Assessment
Purpose & Capability
The name/description match the requested environment variables (ADGUARD_USERNAME, ADGUARD_PASSWORD, ADGUARD_BASE_URL) and required binaries (curl, jq). Those credentials are exactly what is needed to call the AdGuard Home HTTP API; nothing extraneous is requested.
Instruction Scope
SKILL.md and the included scripts only call endpoints under ADGUARD_BASE_URL and use Basic Auth; they query status/stats, manage filtering rules, and toggle DNS filtering as described. The instructions do not attempt to read unrelated files or environment variables, nor do they transmit data to third‑party endpoints beyond the provided base URL.
Install Mechanism
There is no install step (instruction-only with bundled scripts). No external downloads or archive extraction are performed by the skill itself. The only runtime dependencies are curl and jq, which are declared.
Credentials
The skill requires three env vars which are proportionate to its function. The primary secret (ADGUARD_PASSWORD) is appropriate. No unrelated credentials or broad system config paths are requested.
Persistence & Privilege
always is false and autonomous invocation is the platform default. The skill does not attempt to modify other skills or system‑wide settings and does not request persistent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install adguard-home-manager - After installation, invoke the skill by name or use
/adguard-home-manager - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of AdGuard Home Manager skill.
- Manage AdGuard Home server via API: query status, stats, rules, and logs.
- Add, remove, and list custom DNS blocking rules.
- View top blocked domains and recent DNS queries.
- Enable or disable DNS filtering protection.
- Requires environment config: username, password, server URL.
Metadata
Frequently Asked Questions
What is AdGuard Home Manager?
Manage AdGuard Home network-wide DNS ad blocking. Query blocklist stats, add/remove custom DNS rules, check filtering status, and view top blocked domains fr... It is an AI Agent Skill for Claude Code / OpenClaw, with 115 downloads so far.
How do I install AdGuard Home Manager?
Run "/install adguard-home-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AdGuard Home Manager free?
Yes, AdGuard Home Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AdGuard Home Manager support?
AdGuard Home Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AdGuard Home Manager?
It is built and maintained by KRYZL19 (@kryzl19); the current version is v1.0.0.
More Skills