# Send Adguard to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "adguard", "name": "Adguard", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/rowbotik/adguard", "canonicalUrl": "https://clawhub.ai/rowbotik/adguard", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/adguard", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=adguard", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "references/api.md", "scripts/adguard.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "adguard", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T10:08:09.310Z", "expiresAt": "2026-05-06T10:08:09.310Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=adguard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=adguard", "contentDisposition": "attachment; filename=\"adguard-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "adguard" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/adguard" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/adguard", "downloadUrl": "https://openagent3.xyz/downloads/adguard", "agentUrl": "https://openagent3.xyz/skills/adguard/agent", "manifestUrl": "https://openagent3.xyz/skills/adguard/agent.json", "briefUrl": "https://openagent3.xyz/skills/adguard/agent.md" } } ``` ## Documentation ### AdGuard Home Controller Manage AdGuard Home DNS filtering from the command line via the REST API. ### Requirements AdGuard Home running with web interface Admin username and password curl installed (usually default on macOS/Linux) ### Quick Start # Set password once export ADGUARD_PASSWORD=your_admin_password # Use commands ./adguard.sh status ./adguard.sh check example.com ./adguard.sh allow broken-site.com ./adguard.sh block malware.ru ### Configuration Set environment variables for your AdGuard instance: export ADGUARD_URL="http://192.168.1.100:3000" # Your AdGuard IP and port export ADGUARD_USERNAME="admin" # Usually 'admin' (default) export ADGUARD_PASSWORD="your_admin_password" # REQUIRED Add to ~/.bashrc or ~/.zshrc for persistence. ### Config File Alternative Create ~/.adguard/config.json (optional): { "url": "http://192.168.1.100:3000", "username": "admin" } Then set ADGUARD_PASSWORD separately for security. ### check Check if a domain is currently blocked or allowed. ./adguard.sh check doubleclick.net # ✗ doubleclick.net IS BLOCKED # Blocked by: Adblock Plus filter ./adguard.sh check example.com # ✓ example.com is NOT blocked (allowed) ### allow | whitelist Add a domain to the allowlist (whitelist). Creates an exception rule that overrides blocklists. ./adguard.sh allow broken-site.com # ✓ Added rule: @@||broken-site.com^ # Domain: broken-site.com # Action: allow ### block | blacklist Add a domain to the blocklist. Creates a custom blocking rule. ./adguard.sh block spyware-domain.ru # ✓ Added rule: ||spyware-domain.ru^ # Domain: spyware-domain.ru # Action: block ### status | stats Display DNS filtering statistics and protection state. ./adguard.sh status # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ # AdGuard Home Status # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ # Protection: ✓ ENABLED # # DNS Queries: 1,234 # Blocked by rules: 156 # Blocked by safe browsing: 23 # Safe search replacements: 5 # Block rate: 14% # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ### toggle | protection Enable or disable DNS protection. Useful for temporarily disabling filtering. ./adguard.sh toggle # Disabling protection... # ✓ Protection is now false ### cache-clear Clear the DNS cache to apply rule changes immediately. ./adguard.sh cache-clear # Clearing DNS cache... # ✓ Cache cleared ### Finding Your AdGuard Home Device If you don't know your AdGuard URL: Router admin panel — Look for a device named "AdGuard Home" or check for port 3000 Local network scan — Use nmap or check "Connected Devices" If running on same machine — Default is http://localhost:3000 mDNS/Bonjour — Try http://adguard-home.local:3000 (depends on network) ### Filtering Rules Syntax AdGuard uses a DNS filtering rule syntax: RuleEffect||example.com^Block example.com and subdomains@@||example.com^Allow example.com (exception/whitelist)example.comBlock exact domain only||ad.example.com^Block only ad.example.com See API Reference for complete syntax. ### Allow a site that's blocked by accident adguard.sh allow my-bank.com ### Block a known malware domain adguard.sh block malicious-tracker.xyz ### Check if a domain is being filtered adguard.sh check ads.google.com ### View today's statistics adguard.sh status ### Temporarily disable filtering (e.g., for troubleshooting) adguard.sh toggle ### Troubleshooting Error: Failed to authenticate → Check ADGUARD_PASSWORD is correct and set → Verify ADGUARD_URL points to the right IP and port Error: API call failed (HTTP 401) → Authentication failed, check credentials Rules don't take effect → Run adguard.sh cache-clear to flush DNS cache → Wait 5+ minutes for clients to refresh their cache → Restart your device's network connection Can't connect to AdGuard → Verify device is on the same network → Check firewall isn't blocking port 3000 → Ping the device: ping ### Advanced: Batch Operations Block multiple domains: for domain in tracker1.com tracker2.com tracker3.com; do adguard.sh block "$domain" done Check multiple domains: for domain in example.com test.org my-site.net; do echo "Checking $domain..." adguard.sh check "$domain" done ### API Reference See references/api.md for complete AdGuard Home API documentation. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: rowbotik - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T10:08:09.310Z - Expires at: 2026-05-06T10:08:09.310Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/adguard) - [Send to Agent page](https://openagent3.xyz/skills/adguard/agent) - [JSON manifest](https://openagent3.xyz/skills/adguard/agent.json) - [Markdown brief](https://openagent3.xyz/skills/adguard/agent.md) - [Download page](https://openagent3.xyz/downloads/adguard)