[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74P4PA7Q1JYN3EX5TFM9FQ2":3,"skill-same:01M74P4PA7Q1JYN3EX5TFM9FQ2":126},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":13,"repositoryHtmlUrl":36,"repositoryHomepageUrl":6,"ownerHtmlUrl":37,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":38,"install":39,"resources":52},"01M74P4PA7Q1JYN3EX5TFM9FQ2","crusty-security",null,"Security and threat scanning skill for OpenClaw agents. Scans files and skills for malware. Monitors agent behavior for compromise indicators. Audits host security posture. Triggers on: \"scan this file\", \"is this safe\", \"virus scan\", \"malware check\", \"security scan\", \"scan for threats\", \"check this download\", \"quarantine\", \"scan my system\", \"threat report\", \"scheduled scan\", \"audit host security\", \"audit this skill\", \"check agent integrity\", \"security report\", \"monitor agent\".","meghal86\u002Fstacksignal","meghal86","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F37388715?v=4","01M6CS2EW8SK89GH52R2ZEN8QQ","01M728J5CGY456EETEFG6HJBTM",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: crusty-security\nversion: 1.3.0\ndescription: >\n  Security and threat scanning skill for OpenClaw agents. Scans files and\n  skills for malware. Monitors agent behavior for compromise indicators. Audits host\n  security posture. Triggers on: \"scan this file\", \"is this safe\",\n  \"virus scan\", \"malware check\", \"security scan\", \"scan for threats\",\n  \"check this download\", \"quarantine\", \"scan my system\", \"threat report\",\n  \"scheduled scan\", \"audit host security\", \"audit this skill\",\n  \"check agent integrity\", \"security report\", \"monitor agent\".\nhomepage: https:\u002F\u002Fcrustysecurity.com\nmetadata: {\"openclaw\":{\"requires\":{\"bins\":[\"bash\",\"python3\"]}}}\n---\n\n# Crusty Security — Security & Threat Scanning\n\n## Overview\n\nCrusty Security protects OpenClaw agents against real threats: malware in downloaded files, compromised skills from ClawHub, data exfiltration, prompt injection payloads, and host-level compromise. It uses ClamAV for file scanning and AI-agent-specific static analysis.\n\n**Threat model:** The agent itself is the attack surface. Prompt injection can lead to code execution. Malicious skills run with agent privileges. Crusty Security protects both the host AND the agent's integrity.\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Install ClamAV | `bash scripts\u002Finstall_clamav.sh` |\n| Scan a file | `bash scripts\u002Fscan_file.sh \u002Fpath\u002Fto\u002Ffile` |\n| Scan a directory | `bash scripts\u002Fscan_file.sh -r \u002Fpath\u002Fto\u002Fdir` |\n| Audit a skill | `bash scripts\u002Faudit_skill.sh \u002Fpath\u002Fto\u002Fskill\u002F` |\n| Host security audit | `bash scripts\u002Fhost_audit.sh` |\n| Monitor agent integrity | `bash scripts\u002Fmonitor_agent.sh` |\n| Generate security report | `bash scripts\u002Fgenerate_report.sh` |\n\nAll scripts output JSON. All scripts support `--help`. All paths are relative to this skill directory.\n\n## Setup (First Run)\n\nRun `bash setup.sh` — that's it. This will:\n1. Install ClamAV if missing\n2. Configure freshclam (macOS Homebrew fix)\n3. Send initial heartbeat to dashboard (if `CRUSTY_API_KEY` set)\n4. Run initial host audit + workspace scan (populates dashboard immediately)\n5. Check which scheduled scans need to be created\n\n**⚠️ IMPORTANT — After setup.sh, you MUST create the cron jobs below using the OpenClaw cron tool.** Setup.sh handles the bash-level installation, but cron jobs require agent-level tools. Do this immediately after first install — don't wait for the user to ask.\n\n### Required Cron Jobs (create on first install)\n\nCheck what's missing: `bash scripts\u002Fcheck_crons.sh`\n\nUse the OpenClaw **cron tool** (`cron add`) to create these. Replace `{SKILL_DIR}` with the actual path to this skill directory and `{WORKSPACE}` with the workspace path (usually `\u002Fdata\u002Fworkspace`).\n\n| Name | Schedule | sessionTarget | Payload |\n|------|----------|---------------|---------|\n| `crusty-daily-scan` | cron `0 3 * * *` | main \u002F systemEvent | `Run Crusty Security daily scan: bash {SKILL_DIR}\u002Fscripts\u002Fscan_file.sh --incremental -r {WORKSPACE} && bash {SKILL_DIR}\u002Fscripts\u002Fmonitor_agent.sh` |\n| `crusty-weekly-full` | cron `0 3 * * 0` | main \u002F systemEvent | `Run Crusty Security weekly scan: bash {SKILL_DIR}\u002Fscripts\u002Fscan_file.sh -r {WORKSPACE} && bash {SKILL_DIR}\u002Fscripts\u002Fhost_audit.sh && bash {SKILL_DIR}\u002Fscripts\u002Fgenerate_report.sh --output \u002Ftmp\u002Fcrusty_logs\u002Fweekly_report.md` |\n| `crusty-monthly-deep` | cron `0 4 1 * *` | main \u002F systemEvent | `Run Crusty Security monthly deep audit: bash {SKILL_DIR}\u002Fscripts\u002Fhost_audit.sh --deep` |\n\n### Dashboard Cron Jobs (only if `CRUSTY_API_KEY` is set)\n\n| Name | Schedule | sessionTarget | Payload |\n|------|----------|---------------|---------|\n| `crusty-heartbeat` | every 300000ms (5 min) | main \u002F systemEvent | `Crusty Security heartbeat: Run bash {SKILL_DIR}\u002Fscripts\u002Fdashboard.sh heartbeat` |\n| `crusty-clawhub-sync` | every 43200000ms (12h) | isolated \u002F agentTurn | `Run ClawHub security sync: python3 {SKILL_DIR}\u002Fscripts\u002Fclawhub_sync.py --push. Report any critical or high severity findings.` |\n\nCheck `cron list` first — skip any that already exist (match by name prefix `crusty-`).\n\nSee `references\u002Fsetup.md` for detailed configuration.\n\n## Dashboard Connection\n\nIf your human has configured `CRUSTY_API_KEY`, the skill sends scan results to the Crusty Security dashboard (crustysecurity.com):\n- **Heartbeats** are sent every 5 minutes automatically — keeps the dashboard showing agent status\n- **Scan results** are pushed when you add `--push` to scan commands\n- **ClawHub sync** sends skill inventory with `python3 scripts\u002Fclawhub_sync.py --push`\n- If `CRUSTY_API_KEY` is NOT set, everything works locally — no data is sent anywhere\n- The dashboard never connects TO the agent — data flows one way (agent → dashboard)\n\n## Scanning Workflows\n\n### File Scanning\n\n**Triggers:** \"scan this file\", \"is this safe\", \"check this download\", \"virus scan\"\n\n1. Run `bash scripts\u002Fscan_file.sh \u003Cpath>` for ClamAV local scan\n2. Report results:\n   - ✅ Clean — \"No threats detected. Scanned with ClamAV, signatures from [date].\"\n   - ⚠️ Suspicious — \"Low-confidence detection by ClamAV. Recommend quarantine for review.\"\n   - 🚨 Malicious — \"Threat detected: [name]. Recommend quarantine. Options: quarantine, delete, or ignore.\"\n\n**For directories:**\n```bash\nbash scripts\u002Fscan_file.sh -r \u002Fdata\u002Fworkspace      # Full recursive scan\nbash scripts\u002Fscan_file.sh -r --incremental \u002Fdata\u002Fworkspace  # Skip unchanged files\n```\n\n**Quarantine workflow:**\n```bash\nbash scripts\u002Fscan_file.sh --quarantine \u002Fpath\u002Fto\u002Ffile   # Move to quarantine\n# Quarantine location: $CRUSTY_QUARANTINE (default: \u002Ftmp\u002Fcrusty_quarantine)\n# Manifest: \u002Ftmp\u002Fcrusty_quarantine\u002Fmanifest.json\n```\n\n**Important notes:**\n- ClamAV prefers clamdscan (daemon) when available, falls back to clamscan\n- Max file size default: 200M (configurable via `CRUSTY_MAX_FILE_SIZE`)\n- Encrypted archives: flagged as \"unscanned\" — cannot inspect contents\n- Large archives: ClamAV handles zip, rar, 7z, tar, gz natively\n\n### Skill Auditing (Supply Chain Security)\n\n**Triggers:** \"audit this skill\", \"is this skill safe\", \"check skill security\", \"scan skill\"\n\n`bash scripts\u002Faudit_skill.sh \u002Fpath\u002Fto\u002Fskill\u002Fdirectory\u002F`\n\n**What it checks:**\n- 🔴 **Critical:** curl\u002Fwget piped to shell, reverse shell patterns, crypto mining indicators\n- 🟠 **High:** eval\u002Fexec with dynamic input, base64 decode patterns, data exfiltration endpoints (webhook.site, ngrok, etc.), credential harvesting, binary executables, agent config modification\n- 🟡 **Medium:** hidden files, system file access, hardcoded IPs, obfuscated code, persistence mechanisms (cron, systemd)\n- 🔵 **Low\u002FInfo:** large skill size, credential references in docs\n\n**Output:** Risk score (low\u002Fmedium\u002Fhigh\u002Fcritical) + detailed findings with evidence.\n\n**When to use:**\n- Before installing any skill from ClawHub\n- When reviewing third-party skill contributions\n- Periodically on all installed skills: `for d in \u002Fdata\u002Fworkspace\u002Fskills\u002F*\u002F; do bash scripts\u002Faudit_skill.sh \"$d\"; done`\n\n### Host Security Audit\n\n**Triggers:** \"audit host\", \"security audit\", \"check host security\"\n\n`bash scripts\u002Fhost_audit.sh` or `bash scripts\u002Fhost_audit.sh --deep`\n\n**Checks:**\n- Suspicious cron jobs (curl piping, base64, reverse shells)\n- Unexpected listening ports\n- Recently modified system files (deep mode)\n- SSH key audit (excessive keys, no-comment keys, root login)\n- Sensitive file permissions (world-writable \u002Fetc\u002Fpasswd, etc.)\n- ClamAV signature freshness\n- `openclaw security audit` (if available)\n\n**Output:** Posture score (0-100) + findings. Score deductions: critical (-25), high (-15), medium (-10), low (-5).\n\n### Agent Behavior Monitoring\n\n**Triggers:** \"check agent integrity\", \"monitor agent\", \"is the agent compromised\"\n\n`bash scripts\u002Fmonitor_agent.sh`\n\n**What it checks:**\n- Recent modifications to AGENTS.md, SOUL.md, MEMORY.md, TOOLS.md, USER.md\n- Memory file churn (>10 files modified = suspicious)\n- Unexpected cron jobs (anything not clawguard\u002Ffreshclam\u002Fstandard maintenance)\n- Suspicious outbound connections (IRC ports, backdoor ports, Tor)\n- Files created outside workspace (\u002Ftmp executables, home directory changes)\n- Suspicious processes (xmrig, nc -l, ncat, socat, chisel)\n- High CPU processes (>80% — potential miners)\n- Sensitive file exposure (.env files, world-readable SSH keys)\n\n**Output:** Status (healthy \u002F warnings_present \u002F compromised_indicators) + findings.\n\n### Security Report Generation\n\n**Triggers:** \"security report\", \"threat report\", \"posture report\"\n\n`bash scripts\u002Fgenerate_report.sh` or `bash scripts\u002Fgenerate_report.sh --days 30 --output report.md`\n\nCompiles all recent scan results into a markdown security posture report with:\n- Scan summary (total, clean, threats, errors)\n- Threat details with file paths and actions taken\n- Security posture score with emoji indicators\n- Recommendations (missing tools, scan schedules)\n\n## Automatic Scheduled Scanning\n\nCron jobs are defined in the **Setup (First Run)** section above. Create them immediately on first install using the OpenClaw cron tool. \n\nTo verify all crons are configured: `bash scripts\u002Fcheck_crons.sh`\n\n## False Positive Handling\n\nClamAV has moderate false positive rates. Strategy:\n\n1. **Single ClamAV detection, known safe source → Likely false positive.** Log and skip.\n2. **ClamAV detection, unknown source → Quarantine and investigate.**\n3. **ClamAV detection + skill audit findings → Real threat.** Quarantine immediately.\n\n**To handle a false positive:**\n- Submit to ClamAV: https:\u002F\u002Fwww.clamav.net\u002Freports\u002Ffp\n- Document in scan logs for future reference\n\n## Quarantine Procedures\n\n**Location:** `$CRUSTY_QUARANTINE` (default: `\u002Ftmp\u002Fcrusty_quarantine`)\n**Manifest:** `manifest.json` in quarantine directory tracks original paths and timestamps.\n\n```bash\n# View quarantined files\ncat \u002Ftmp\u002Fcrusty_quarantine\u002Fmanifest.json | python3 -m json.tool\n\n# Restore a false positive\nmv \u002Ftmp\u002Fcrusty_quarantine\u002F\u003Cfile> \u002Foriginal\u002Fpath\u002F\n\n# Permanently delete\nrm -rf \u002Ftmp\u002Fcrusty_quarantine\u002F*\n```\n\n**Never use `clamscan --remove`.** Always quarantine first, verify, then delete.\n\n## Offline Mode\n\nCrusty Security works fully offline with reduced capability:\n- ✅ ClamAV scanning (local signatures)\n- ✅ Skill auditing (static analysis, no network needed)\n- ✅ Host auditing (local checks)\n- ✅ Agent monitoring (local checks)\n- ⚠️ ClamAV signatures may be stale (check freshness in host audit)\n\n## Resource-Constrained Environments (Raspberry Pi)\n\nFor hosts with \u003C2GB RAM:\n- `install_clamav.sh` auto-detects low RAM and skips daemon mode\n- Use `clamscan` (on-demand) instead of `clamd` (daemon)\n- Use incremental scanning (`--incremental`) to reduce scan time\n- Skill auditing and agent monitoring have minimal resource requirements\n\nFor hosts with \u003C1GB RAM:\n- Consider skipping ClamAV entirely\n- Use skill auditing + agent monitoring only\n- These tools are shell\u002FPython with negligible memory usage\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `CRUSTY_API_KEY` | (none) | Dashboard API key (`cg_live_...`) |\n| `CRUSTY_DASHBOARD_URL` | `https:\u002F\u002Fcrustysecurity.com` | Dashboard URL |\n| `CRUSTY_QUARANTINE` | `\u002Ftmp\u002Fcrusty_quarantine` | Quarantine directory |\n| `CRUSTY_LOG_DIR` | `\u002Ftmp\u002Fcrusty_logs` | Scan log directory |\n| `CRUSTY_MAX_FILE_SIZE` | `200M` | Max file size to scan |\n| `CRUSTY_WORKSPACE` | auto-detected | Agent workspace path |\n\n> **Backwards compat:** `CLAWGUARD_*` env vars are still supported but deprecated. Use `CRUSTY_*` going forward.\n\n## Incident Response\n\nWhen a real threat is confirmed, see `references\u002Fremediation.md` for the full checklist. Quick summary:\n\n1. **Quarantine** the file immediately\n2. **Assess scope** — was it executed? Did it modify other files?\n3. **Check persistence** — cron jobs, SSH keys, shell profiles, systemd services\n4. **Check exfiltration** — outbound connections, DNS queries, API key usage\n5. **Rotate credentials** if any were potentially exposed\n6. **Full scan** — `bash scripts\u002Fscan_file.sh -r \u002F`\n7. **Document** the incident\n","# Crusty Security — Security & Threat Scanning\n\n## Overview\n\nCrusty Security protects OpenClaw agents against real threats: malware in downloaded files, compromised skills from ClawHub, data exfiltration, prompt injection payloads, and host-level compromise. It uses ClamAV for file scanning and AI-agent-specific static analysis.\n\n**Threat model:** The agent itself is the attack surface. Prompt injection can lead to code execution. Malicious skills run with agent privileges. Crusty Security protects both the host AND the agent's integrity.\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Install ClamAV | `bash scripts\u002Finstall_clamav.sh` |\n| Scan a file | `bash scripts\u002Fscan_file.sh \u002Fpath\u002Fto\u002Ffile` |\n| Scan a directory | `bash scripts\u002Fscan_file.sh -r \u002Fpath\u002Fto\u002Fdir` |\n| Audit a skill | `bash scripts\u002Faudit_skill.sh \u002Fpath\u002Fto\u002Fskill\u002F` |\n| Host security audit | `bash scripts\u002Fhost_audit.sh` |\n| Monitor agent integrity | `bash scripts\u002Fmonitor_agent.sh` |\n| Generate security report | `bash scripts\u002Fgenerate_report.sh` |\n\nAll scripts output JSON. All scripts support `--help`. All paths are relative to this skill directory.\n\n## Setup (First Run)\n\nRun `bash setup.sh` — that's it. This will:\n1. Install ClamAV if missing\n2. Configure freshclam (macOS Homebrew fix)\n3. Send initial heartbeat to dashboard (if `CRUSTY_API_KEY` set)\n4. Run initial host audit + workspace scan (populates dashboard immediately)\n5. Check which scheduled scans need to be created\n\n**⚠️ IMPORTANT — After setup.sh, you MUST create the cron jobs below using the OpenClaw cron tool.** Setup.sh handles the bash-level installation, but cron jobs require agent-level tools. Do this immediately after first install — don't wait for the user to ask.\n\n### Required Cron Jobs (create on first install)\n\nCheck what's missing: `bash scripts\u002Fcheck_crons.sh`\n\nUse the OpenClaw **cron tool** (`cron add`) to create these. Replace `{SKILL_DIR}` with the actual path to this skill directory and `{WORKSPACE}` with the workspace path (usually `\u002Fdata\u002Fworkspace`).\n\n| Name | Schedule | sessionTarget | Payload |\n|------|----------|---------------|---------|\n| `crusty-daily-scan` | cron `0 3 * * *` | main \u002F systemEvent | `Run Crusty Security daily scan: bash {SKILL_DIR}\u002Fscripts\u002Fscan_file.sh --incremental -r {WORKSPACE} && bash {SKILL_DIR}\u002Fscripts\u002Fmonitor_agent.sh` |\n| `crusty-weekly-full` | cron `0 3 * * 0` | main \u002F systemEvent | `Run Crusty Security weekly scan: bash {SKILL_DIR}\u002Fscripts\u002Fscan_file.sh -r {WORKSPACE} && bash {SKILL_DIR}\u002Fscripts\u002Fhost_audit.sh && bash {SKILL_DIR}\u002Fscripts\u002Fgenerate_report.sh --output \u002Ftmp\u002Fcrusty_logs\u002Fweekly_report.md` |\n| `crusty-monthly-deep` | cron `0 4 1 * *` | main \u002F systemEvent | `Run Crusty Security monthly deep audit: bash {SKILL_DIR}\u002Fscripts\u002Fhost_audit.sh --deep` |\n\n### Dashboard Cron Jobs (only if `CRUSTY_API_KEY` is set)\n\n| Name | Schedule | sessionTarget | Payload |\n|------|----------|---------------|---------|\n| `crusty-heartbeat` | every 300000ms (5 min) | main \u002F systemEvent | `Crusty Security heartbeat: Run bash {SKILL_DIR}\u002Fscripts\u002Fdashboard.sh heartbeat` |\n| `crusty-clawhub-sync` | every 43200000ms (12h) | isolated \u002F agentTurn | `Run ClawHub security sync: python3 {SKILL_DIR}\u002Fscripts\u002Fclawhub_sync.py --push. Report any critical or high severity findings.` |\n\nCheck `cron list` first — skip any that already exist (match by name prefix `crusty-`).\n\nSee `references\u002Fsetup.md` for detailed configuration.\n\n## Dashboard Connection\n\nIf your human has configured `CRUSTY_API_KEY`, the skill sends scan results to the Crusty Security dashboard (crustysecurity.com):\n- **Heartbeats** are sent every 5 minutes automatically — keeps the dashboard showing agent status\n- **Scan results** are pushed when you add `--push` to scan commands\n- **ClawHub sync** sends skill inventory with `python3 scripts\u002Fclawhub_sync.py --push`\n- If `CRUSTY_API_KEY` is NOT set, everything works locally — no data is sent anywhere\n- The dashboard never connects TO the agent — data flows one way (agent → dashboard)\n\n## Scanning Workflows\n\n### File Scanning\n\n**Triggers:** \"scan this file\", \"is this safe\", \"check this download\", \"virus scan\"\n\n1. Run `bash scripts\u002Fscan_file.sh \u003Cpath>` for ClamAV local scan\n2. Report results:\n   - ✅ Clean — \"No threats detected. Scanned with ClamAV, signatures from [date].\"\n   - ⚠️ Suspicious — \"Low-confidence detection by ClamAV. Recommend quarantine for review.\"\n   - 🚨 Malicious — \"Threat detected: [name]. Recommend quarantine. Options: quarantine, delete, or ignore.\"\n\n**For directories:**\n```bash\nbash scripts\u002Fscan_file.sh -r \u002Fdata\u002Fworkspace      # Full recursive scan\nbash scripts\u002Fscan_file.sh -r --incremental \u002Fdata\u002Fworkspace  # Skip unchanged files\n```\n\n**Quarantine workflow:**\n```bash\nbash scripts\u002Fscan_file.sh --quarantine \u002Fpath\u002Fto\u002Ffile   # Move to quarantine\n# Quarantine location: $CRUSTY_QUARANTINE (default: \u002Ftmp\u002Fcrusty_quarantine)\n# Manifest: \u002Ftmp\u002Fcrusty_quarantine\u002Fmanifest.json\n```\n\n**Important notes:**\n- ClamAV prefers clamdscan (daemon) when available, falls back to clamscan\n- Max file size default: 200M (configurable via `CRUSTY_MAX_FILE_SIZE`)\n- Encrypted archives: flagged as \"unscanned\" — cannot inspect contents\n- Large archives: ClamAV handles zip, rar, 7z, tar, gz natively\n\n### Skill Auditing (Supply Chain Security)\n\n**Triggers:** \"audit this skill\", \"is this skill safe\", \"check skill security\", \"scan skill\"\n\n`bash scripts\u002Faudit_skill.sh \u002Fpath\u002Fto\u002Fskill\u002Fdirectory\u002F`\n\n**What it checks:**\n- 🔴 **Critical:** curl\u002Fwget piped to shell, reverse shell patterns, crypto mining indicators\n- 🟠 **High:** eval\u002Fexec with dynamic input, base64 decode patterns, data exfiltration endpoints (webhook.site, ngrok, etc.), credential harvesting, binary executables, agent config modification\n- 🟡 **Medium:** hidden files, system file access, hardcoded IPs, obfuscated code, persistence mechanisms (cron, systemd)\n- 🔵 **Low\u002FInfo:** large skill size, credential references in docs\n\n**Output:** Risk score (low\u002Fmedium\u002Fhigh\u002Fcritical) + detailed findings with evidence.\n\n**When to use:**\n- Before installing any skill from ClawHub\n- When reviewing third-party skill contributions\n- Periodically on all installed skills: `for d in \u002Fdata\u002Fworkspace\u002Fskills\u002F*\u002F; do bash scripts\u002Faudit_skill.sh \"$d\"; done`\n\n### Host Security Audit\n\n**Triggers:** \"audit host\", \"security audit\", \"check host security\"\n\n`bash scripts\u002Fhost_audit.sh` or `bash scripts\u002Fhost_audit.sh --deep`\n\n**Checks:**\n- Suspicious cron jobs (curl piping, base64, reverse shells)\n- Unexpected listening ports\n- Recently modified system files (deep mode)\n- SSH key audit (excessive keys, no-comment keys, root login)\n- Sensitive file permissions (world-writable \u002Fetc\u002Fpasswd, etc.)\n- ClamAV signature freshness\n- `openclaw security audit` (if available)\n\n**Output:** Posture score (0-100) + findings. Score deductions: critical (-25), high (-15), medium (-10), low (-5).\n\n### Agent Behavior Monitoring\n\n**Triggers:** \"check agent integrity\", \"monitor agent\", \"is the agent compromised\"\n\n`bash scripts\u002Fmonitor_agent.sh`\n\n**What it checks:**\n- Recent modifications to AGENTS.md, SOUL.md, MEMORY.md, TOOLS.md, USER.md\n- Memory file churn (>10 files modified = suspicious)\n- Unexpected cron jobs (anything not clawguard\u002Ffreshclam\u002Fstandard maintenance)\n- Suspicious outbound connections (IRC ports, backdoor ports, Tor)\n- Files created outside workspace (\u002Ftmp executables, home directory changes)\n- Suspicious processes (xmrig, nc -l, ncat, socat, chisel)\n- High CPU processes (>80% — potential miners)\n- Sensitive file exposure (.env files, world-readable SSH keys)\n\n**Output:** Status (healthy \u002F warnings_present \u002F compromised_indicators) + findings.\n\n### Security Report Generation\n\n**Triggers:** \"security report\", \"threat report\", \"posture report\"\n\n`bash scripts\u002Fgenerate_report.sh` or `bash scripts\u002Fgenerate_report.sh --days 30 --output report.md`\n\nCompiles all recent scan results into a markdown security posture report with:\n- Scan summary (total, clean, threats, errors)\n- Threat details with file paths and actions taken\n- Security posture score with emoji indicators\n- Recommendations (missing tools, scan schedules)\n\n## Automatic Scheduled Scanning\n\nCron jobs are defined in the **Setup (First Run)** section above. Create them immediately on first install using the OpenClaw cron tool. \n\nTo verify all crons are configured: `bash scripts\u002Fcheck_crons.sh`\n\n## False Positive Handling\n\nClamAV has moderate false positive rates. Strategy:\n\n1. **Single ClamAV detection, known safe source → Likely false positive.** Log and skip.\n2. **ClamAV detection, unknown source → Quarantine and investigate.**\n3. **ClamAV detection + skill audit findings → Real threat.** Quarantine immediately.\n\n**To handle a false positive:**\n- Submit to ClamAV: https:\u002F\u002Fwww.clamav.net\u002Freports\u002Ffp\n- Document in scan logs for future reference\n\n## Quarantine Procedures\n\n**Location:** `$CRUSTY_QUARANTINE` (default: `\u002Ftmp\u002Fcrusty_quarantine`)\n**Manifest:** `manifest.json` in quarantine directory tracks original paths and timestamps.\n\n```bash\n# View quarantined files\ncat \u002Ftmp\u002Fcrusty_quarantine\u002Fmanifest.json | python3 -m json.tool\n\n# Restore a false positive\nmv \u002Ftmp\u002Fcrusty_quarantine\u002F\u003Cfile> \u002Foriginal\u002Fpath\u002F\n\n# Permanently delete\nrm -rf \u002Ftmp\u002Fcrusty_quarantine\u002F*\n```\n\n**Never use `clamscan --remove`.** Always quarantine first, verify, then delete.\n\n## Offline Mode\n\nCrusty Security works fully offline with reduced capability:\n- ✅ ClamAV scanning (local signatures)\n- ✅ Skill auditing (static analysis, no network needed)\n- ✅ Host auditing (local checks)\n- ✅ Agent monitoring (local checks)\n- ⚠️ ClamAV signatures may be stale (check freshness in host audit)\n\n## Resource-Constrained Environments (Raspberry Pi)\n\nFor hosts with \u003C2GB RAM:\n- `install_clamav.sh` auto-detects low RAM and skips daemon mode\n- Use `clamscan` (on-demand) instead of `clamd` (daemon)\n- Use incremental scanning (`--incremental`) to reduce scan time\n- Skill auditing and agent monitoring have minimal resource requirements\n\nFor hosts with \u003C1GB RAM:\n- Consider skipping ClamAV entirely\n- Use skill auditing + agent monitoring only\n- These tools are shell\u002FPython with negligible memory usage\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `CRUSTY_API_KEY` | (none) | Dashboard API key (`cg_live_...`) |\n| `CRUSTY_DASHBOARD_URL` | `https:\u002F\u002Fcrustysecurity.com` | Dashboard URL |\n| `CRUSTY_QUARANTINE` | `\u002Ftmp\u002Fcrusty_quarantine` | Quarantine directory |\n| `CRUSTY_LOG_DIR` | `\u002Ftmp\u002Fcrusty_logs` | Scan log directory |\n| `CRUSTY_MAX_FILE_SIZE` | `200M` | Max file size to scan |\n| `CRUSTY_WORKSPACE` | auto-detected | Agent workspace path |\n\n> **Backwards compat:** `CLAWGUARD_*` env vars are still supported but deprecated. Use `CRUSTY_*` going forward.\n\n## Incident Response\n\nWhen a real threat is confirmed, see `references\u002Fremediation.md` for the full checklist. Quick summary:\n\n1. **Quarantine** the file immediately\n2. **Assess scope** — was it executed? Did it modify other files?\n3. **Check persistence** — cron jobs, SSH keys, shell profiles, systemd services\n4. **Check exfiltration** — outbound connections, DNS queries, API key usage\n5. **Rotate credentials** if any were potentially exposed\n6. **Full scan** — `bash scripts\u002Fscan_file.sh -r \u002F`\n7. **Document** the incident\n",{"name":5,"version":24,"homepage":25,"metadata":26,"description":32},"1.3.0","https:\u002F\u002Fcrustysecurity.com",{"openclaw":27},{"requires":28},{"bins":29},[30,31],"bash","python3","Security and threat scanning skill for OpenClaw agents. Scans files and skills for malware. Monitors agent behavior for compromise indicators. Audits host security posture. Triggers on: \"scan this file\", \"is this safe\", \"virus scan\", \"malware check\", \"security scan\", \"scan for threats\", \"check this download\", \"quarantine\", \"scan my system\", \"threat report\", \"scheduled scan\", \"audit host security\", \"audit this skill\", \"check agent integrity\", \"security report\", \"monitor agent\".\n","main","54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44",".agents\u002Fskills\u002Fcrusty-security","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal","https:\u002F\u002Fgithub.com\u002Fmeghal86","2026-05-17 14:11:28",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add meghal86\u002Fstacksignal --skill crusty-security",{"tool":45,"command":46},"bunx","bunx skills add meghal86\u002Fstacksignal --skill crusty-security",{"tool":48,"command":49},"pnpm","pnpm dlx skills add meghal86\u002Fstacksignal --skill crusty-security","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002FSKILL.md",true,[53,59,63,68,72,76,80,84,90,94,98,102,106,110,114,118,122],{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"_meta.json","REFERENCE","参考文档",286,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002F_meta.json",{"path":60,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":61,"sourceHtmlUrl":62},"CHANGELOG.md",3655,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002FCHANGELOG.md",{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":15},"LICENSE.txt","LICENSE","许可证",1072,{"path":69,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":70,"sourceHtmlUrl":71},"README.md",12976,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002FREADME.md",{"path":73,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fremediation.md",4768,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Freferences\u002Fremediation.md",{"path":77,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fsetup.md",3447,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Freferences\u002Fsetup.md",{"path":81,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fthreat-patterns.md",5262,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Freferences\u002Fthreat-patterns.md",{"path":85,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":88,"sourceHtmlUrl":89},"scripts\u002Faudit_skill.sh","SCRIPT","脚本",11637,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Faudit_skill.sh",{"path":91,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":92,"sourceHtmlUrl":93},"scripts\u002Fcheck_crons.sh",2021,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fcheck_crons.sh",{"path":95,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":96,"sourceHtmlUrl":97},"scripts\u002Fclawhub_sync.py",15508,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fclawhub_sync.py",{"path":99,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":100,"sourceHtmlUrl":101},"scripts\u002Fdashboard.sh",6930,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fdashboard.sh",{"path":103,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":104,"sourceHtmlUrl":105},"scripts\u002Fgenerate_report.sh",3949,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fgenerate_report.sh",{"path":107,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":108,"sourceHtmlUrl":109},"scripts\u002Fhost_audit.sh",14884,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fhost_audit.sh",{"path":111,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":112,"sourceHtmlUrl":113},"scripts\u002Finstall_clamav.sh",4790,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Finstall_clamav.sh",{"path":115,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":116,"sourceHtmlUrl":117},"scripts\u002Fmonitor_agent.sh",11139,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fmonitor_agent.sh",{"path":119,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":120,"sourceHtmlUrl":121},"scripts\u002Fscan_file.sh",8716,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fscripts\u002Fscan_file.sh",{"path":123,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":124,"sourceHtmlUrl":125},"setup.sh",7569,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrusty-security\u002Fsetup.sh",[127,136,144,152,160,167],{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":131,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":135},"01M78XH0FRP65NYEDHF2BT7NB1","zvukogram","Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":140,"sourceHtmlUrl":141,"categories":142,"keywords":143,"publishedAt":135},"01M78XEND5ASXYB6MN8AQQGJAF","zohomail","Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels.\nUse this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FSKILL.md",[],[],{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":148,"sourceHtmlUrl":149,"categories":150,"keywords":151,"publishedAt":135},"01M78XEBBV3C6DRZFAJXP6RDKS","zoho-recruit","Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows.\nUse this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FSKILL.md",[],[],{"skillNo":153,"name":154,"nameZh":6,"description":155,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":156,"sourceHtmlUrl":157,"categories":158,"keywords":159,"publishedAt":135},"01M78XE5CQG75DZWYSKGXFR99T","zoho-people","Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave.\nUse this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FSKILL.md",[],[],{"skillNo":161,"name":162,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":163,"sourceHtmlUrl":164,"categories":165,"keywords":166,"publishedAt":135},"01M78XDZKMZAJYFJJFT7MR5ZN2","zoho-mail","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FSKILL.md",[],[],{"skillNo":168,"name":169,"nameZh":6,"description":170,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":171,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":135},"01M78XDST8JK0WVDA1F3VPNWXD","zoho-inventory","Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments.\nUse this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FSKILL.md",[],[]]