← 返回 Skills 市场
ReefWatch
作者
Yassin Naeim
· GitHub ↗
· v1.3.0
542
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install reefwatch
功能描述
Continuous local security monitoring daemon for Linux and macOS. Detects brute-force attacks, malware, privilege escalation, suspicious processes, file tampe...
安全使用建议
This skill appears to do what it claims: a local host-based intrusion detection daemon that alerts OpenClaw via a webhook. Before installing or enabling it, consider the following:
- Review setup_rules.py and the rules download sources: rule updates are fetched from the network and will pull third-party YARA/Sigma rule repositories (expected, but verify the URLs and trust the sources).
- The instructions install Python packages via pip from the skill's requirements.txt. Pip installs can run code/build native extensions (e.g., yara-python). Prefer installing in a virtualenv, container, or test machine first rather than globally.
- The daemon reads system logs, enumerates processes, inspects network connections, and can hash files (including critical system files). These operations may require root/privileged access to be fully effective and will access sensitive data (e.g., auth logs, /etc). Only run if you accept that level of access.
- By default the AlertManager refuses external webhooks unless webhook.allow_external is explicitly enabled; if you do enable external alerting, ensure the webhook URL is trustworthy and HTTPS is used. The skill stores logs/history under ~/.openclaw and writes a pid file to /tmp when started.
- If you plan to run continuously, inspect the provided systemd/launchd service files before enabling them, and run the code in a controlled environment first (or audit the rule sets and config) to confirm it behaves as expected.
Overall: coherent with its purpose (benign), but treat it like any privileged monitoring agent — review network rule downloads, run in an isolated environment to validate, and avoid installing globally without inspection.
功能分析
Type: OpenClaw Skill
Name: reefwatch
Version: 1.3.0
The OpenClaw AgentSkills skill bundle 'reefwatch' is a Host-based Intrusion Detection System (HIDS) designed to monitor for and alert on security threats. Its code and documentation consistently align with this benign purpose. Key indicators supporting this classification include robust SSRF prevention in `alert_manager.py` for webhook communication, secure file handling with `0o600` permissions and `O_NOFOLLOW` flags for sensitive files (e.g., PID, status, history, rule files), and explicit detection mechanisms for prompt injection attacks (Unicode obfuscation, specific phrases) targeting OpenClaw's own configuration in `reefwatch/engines/custom_rules.py`. Furthermore, `setup_rules.py` employs supply chain best practices by pinning Git clones of YARA and Sigma rules to specific tags, mitigating risks from upstream changes. All system interactions (e.g., `subprocess.run` for log collection, `psutil` for system monitoring) are necessary for its stated security function and are implemented with security considerations.
能力评估
Purpose & Capability
Name/description (HIDS) match the actual code and runtime requirements: the package contains collectors for logs, files, processes, and network, detection engines (YARA, Sigma, custom rules), and an alert manager that posts to an OpenClaw webhook. Required binaries (python3, pip3) and the single env var (OPENCLAW_HOOKS_TOKEN for webhook auth) are proportionate to the described functionality.
Instruction Scope
SKILL.md instructions are narrowly scoped to installing Python deps, downloading rule sets (setup_rules.py), starting/stopping a local daemon, and invoking manual scans. These actions will read system logs, network state, process lists, and watched filesystem paths (including potentially sensitive paths such as /etc), which is expected for a HIDS but requires appropriate privileges and user awareness. The skill claims 'data stays local' but the webhook can be configured to send alerts externally if webhook.allow_external is set — by default the code refuses non-local webhooks unless explicitly allowed.
Install Mechanism
The skill is instruction-only (no platform install manifest) but ships full Python source and a requirements file and instructs to run pip3 install -r from the skill workspace. This is expected, but pip installing packages (yara-python, psutil, requests) may build native extensions and can run code at install time. setup_rules.py likely downloads rule sets from GitHub (expected for YARA/Sigma rules) — rule downloads are normal but represent external network activity that should be reviewed.
Credentials
Only OPENCLAW_HOOKS_TOKEN is declared and used to authenticate to the local OpenClaw webhook; this is appropriate. The skill does not request unrelated secrets or other environment credentials. Note: runtime behavior may require elevated OS permissions (reading system logs, network sockets, /etc/*) which are not declared as env vars but are inherent to HIDS operation.
Persistence & Privilege
The skill runs as a background daemon and provides instructions to launch as a user systemd/launchd service, which is appropriate for continuous monitoring. always:false (not force-included) and no modification of other skills observed. However, running the daemon (and enabling system service) grants continuous background access to system logs/files/network; review and run with least privilege and inspect service files before enabling system-wide.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install reefwatch - 安装完成后,直接呼叫该 Skill 的名称或使用
/reefwatch触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.3.0
Audit round 3: instant shutdown via RUNNING.wait(), O_NOFOLLOW on all writes, IPv6 URL bracketing, IOC subdomain matching, systemd hardening (12 directives), git SHA verification, 188 tests
v1.2.0
Fix security scan findings: declare env vars, fix paths, remove break-system-packages, base64-encode IDS signatures to avoid scanner false positives
v1.1.0
Security hardening: DNS rebinding prevention, symlink attack protection, thread-safe shutdown, supply chain pinning, 188 tests passing
v1.0.0
Initial release
元数据
常见问题
ReefWatch 是什么?
Continuous local security monitoring daemon for Linux and macOS. Detects brute-force attacks, malware, privilege escalation, suspicious processes, file tampe... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 542 次。
如何安装 ReefWatch?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install reefwatch」即可一键安装,无需额外配置。
ReefWatch 是免费的吗?
是的,ReefWatch 完全免费(开源免费),可自由下载、安装和使用。
ReefWatch 支持哪些平台?
ReefWatch 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(linux, darwin)。
谁开发了 ReefWatch?
由 Yassin Naeim(@yasnaak)开发并维护,当前版本 v1.3.0。
推荐 Skills