首页 资讯 下载 教程 Skills 社群

AdGuard

网络安全 开发工具

安装命令

npx clawhub@latest install adguard

安装说明

1
确认环境

确保已安装 Node.js 22+ 和 OpenClaw。在终端运行 openclaw --version 确认 OpenClaw 正常工作。

2
执行安装

在终端中运行上方安装命令,ClawHub 会自动下载并安装 AdGuard 到 ~/.openclaw/skills/ 目录。

3
验证安装

运行 openclaw skills list 查看已安装技能列表,确认 AdGuard 已出现在列表中。

4
配置参数(可选)

根据下方介绍中的配置说明,在 ~/.config/openclaw/openclaw.json5 中添加技能的配置项。

手动安装方式:将 Skill 文件夹复制到 ~/.openclaw/skills/ 或项目目录下的 skills/ 文件夹,确保文件夹中包含 SKILL.md 文件。
DNS 过滤 广告拦截 域名管理 客户端控制 统计查询

详细介绍

AdGuard Skill 让 OpenClaw Agent 可以通过自然语言管理家庭或办公网络的 AdGuard Home DNS 过滤服务。

核心功能

  • DNS 过滤管理:启用/禁用过滤规则
  • 广告拦截:管理广告拦截列表
  • 域名管理:添加/移除域名到黑白名单
  • 客户端控制:针对特定设备的过滤策略
  • 统计查询:查看 DNS 请求和拦截统计

安装命令

clawhub install adguard

配置示例

skills:
  adguard:
    host: "http://192.168.1.1:3000"
    username: "admin"
    password: "$ADGUARD_PASSWORD"

使用场景

  • 家庭网络管理员通过聊天界面管理 DNS 过滤
  • 临时禁用某些域名(如学习时禁用社交媒体)
  • 查看每日广告拦截统计
  • 针对孩子设备的家长控制
  • 检测可疑域名访问

适合用户

  • 自托管 AdGuard Home 用户
  • 家庭网络管理员
  • 想用 AI 简化家庭网络管理
  • 注重网络隐私和安全

前置条件

  • 已部署 AdGuard Home(建议在路由器或 NAS 上)
  • AdGuard Home 启用了 HTTP API
  • OpenClaw 与 AdGuard Home 在同一网络或可访问

注意事项

  • 谨慎管理白名单避免误封必需的服务
  • 修改 DNS 规则可能影响家庭其他成员
  • 建议为重要操作配合 Lobster 审批门控
  • API 访问凭证建议放在 Secrets Management