← 返回 Skills 市场
1999azzar

Pihole Ctl

作者 azzar budiyanto · GitHub ↗ · v1.0.1
cross-platform ✓ 安全检测通过
708
总下载
0
收藏
2
当前安装
2
版本数
在 OpenClaw 中安装
/install pihole-ctl
功能描述
Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity".
安全使用建议
This skill appears to do what it says: query the local Pi-hole FTL DB and call the pihole CLI. Before installing, verify you have python3 and the pihole CLI on the host; the metadata omits these required binaries. Do not grant sudo or add the agent's user to the pihole group unless you trust the skill and the environment — management commands (enable/disable/gravity) need elevated privileges. Because the skill's source/homepage are unknown, inspect the included script (small and readable) yourself; it opens the DB in read-only mode and prints JSON and does not contact external servers. If you want stricter safety, restrict the agent's ability to run privileged commands and only grant read access to /etc/pihole/pihole-FTL.db.
功能分析
Type: OpenClaw Skill Name: pihole-ctl Version: 1.0.1 The OpenClaw skill 'pihole-ctl' is designed to manage and monitor a local Pi-hole instance. The `SKILL.md` provides clear, non-manipulative instructions and capabilities. The core script `scripts/query_db.py` safely queries the Pi-hole FTL database using `sqlite3` in read-only mode (`mode=ro`) and employs parameterized queries to prevent SQL injection. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, prompt injection attempts against the agent, or obfuscation. While the `SKILL.md` notes that `pihole` CLI commands require `sudo`, this is a factual statement about the command's requirements, not a malicious instruction, and the script itself does not execute these commands.
能力评估
Purpose & Capability
The skill claims to query the Pi-hole FTL DB and control the pihole CLI. The included script reads /etc/pihole/pihole-FTL.db and returns JSON; management actions are intended to be performed with the system 'pihole' CLI. This is coherent with the description, but the package metadata lists no required binaries even though the SKILL.md and scripts expect python3 and (for management operations) the 'pihole' CLI and appropriate system privileges.
Instruction Scope
Runtime instructions are narrowly scoped: read-only queries of the local /etc/pihole/pihole-FTL.db (script opens DB in read-only mode) and optionally run pihole CLI commands for enable/disable/update. The skill does not instruct the agent to read unrelated files, transmit data to external endpoints, or access credentials.
Install Mechanism
No install spec (instruction-only with a small helper script). No downloads or archive extraction. Minimal on-disk footprint and no installer-based risks.
Credentials
The skill requests no environment variables or credentials. It does require the agent/user to have read access to /etc/pihole/pihole-FTL.db and (for management actions) sudo or membership in the pihole group. These filesystem and privilege needs are proportional to the stated tasks, but the metadata should have declared required binaries (python3 and 'pihole') to avoid surprise.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence. Model invocation is allowed (normal default). Be aware that if the agent is allowed to invoke skills autonomously, this skill could run local pihole commands that require elevated privileges — limit those permissions to trusted contexts.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install pihole-ctl
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /pihole-ctl 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
pihole-ctl 1.0.1 - Updated SKILL.md to clarify script requirements and permissions. - Added guidance for database read access and recommended group membership. - Noted that management commands may require sudo or proper user privileges. - Improved script description for clearer usage.
v1.0.0
Initial release of pihole-ctl: manage and monitor your local Pi-hole instance from the CLI. - Query FTL database for ad-blocking statistics (last 24h, top clients, top domains). - Enable or disable Pi-hole blocking via CLI. - Update Pi-hole gravity blocklists. - Audit and identify top blocked domains or chatty clients. - Includes a Python script for safe database queries.
元数据
Slug pihole-ctl
版本 1.0.1
许可证
累计安装 2
当前安装数 2
历史版本数 2
常见问题

Pihole Ctl 是什么?

Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity". 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 708 次。

如何安装 Pihole Ctl?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install pihole-ctl」即可一键安装,无需额外配置。

Pihole Ctl 是免费的吗?

是的,Pihole Ctl 完全免费(开源免费),可自由下载、安装和使用。

Pihole Ctl 支持哪些平台?

Pihole Ctl 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Pihole Ctl?

由 azzar budiyanto(@1999azzar)开发并维护,当前版本 v1.0.1。

💬 留言讨论