Netw0rkNoob/VulnClaw

VulnClaw – AI 驅動的滲透測試助手

What it is – VulnClaw 是一款基於 Python 的命令列（以及可選的 web/TUI）工具，讓使用者可以用自然語言描述滲透測試任務。接著，它會驅動大型語言模型 (LLM) 來執行整個測試流程：偵察、漏洞發現、漏洞利用、以及報告生成。LLM 會決定呼叫哪些內建工具以及何時呼叫，而框架會將每個工具的原始輸出紀錄為 evidence（證據），模型必須在聲稱發現漏洞之前引用這些證據。

Key capabilities

• Model‑led solve engine – LLM 控制迴圈（類似於 Claude‑Code），負責選擇工具、解釋結果，並決定任務是否完成。
• Evidence memory – 所有工具結果都儲存在 AgentState.evidence 中。模型只有在該特定字串出現在證據中時，才能聲稱發現了 flag 或漏洞，從而防止了幻覺結果。
• MCP toolchain – 一個輕量級的 "Model‑Context‑Protocol" 層提供服務，例如 fetch (HTTP client)、memory (local JSON store)，以及用於瀏覽器自動化與流量重放的選擇性外部服務 (chrome‑devtools, burp)。
• Rich built‑in tools – HTTP 探測（單次與批次）、nmap 掃描、shell 命令執行、Python 代碼執行、29 種加密/編碼助手、源碼提取、運行時差異探測等。
• Skill references – 提供超過 50 種知識庫 "skills"（web pentest, CTF, crypto, Android, 等）供模型按需載入，提供上下文指導，而無需硬編碼腳本。
• Multi‑provider LLM support – 支援 OpenAI, Anthropic, MiniMax, DeepSeek, Zhipu, Moonshot, Qwen, SiliconFlow, Doubao, Baichuan, StepFun, SenseTime, Yi, 以及本地的 Ollama 模型。
• Output – 生成結構化的 Markdown 報告與任何發現的漏洞的執行性 Python PoC 腳本。
• Interfaces – CLI REPL, Typer‑based sub‑commands, 一個終端機 UI (vulnclaw tui)，以及可選的 Web UI (vulnclaw web)。提供 Docker 映像檔以方便部署。

Typical workflow

1. Configure 一個 LLM 提供商與 API key (vulnclaw config provider openai)。
2. Run 一個命令，例如 vulnclaw run http://target.example.com 或啟動 REPL 並輸入自然語言請求。
3. 模型會啟動多輪迭代：
   • Round 1: 偵察 (port scan, fingerprinting, directory enumeration)。
   • Round 2: 漏洞發現 (CVE checks, injection points)。
   • Round 3: 漏洞利用 (PoC validation, privilege escalation)。
   • Round 4: 報告生成。
4. 所有工具呼叫都會被紀錄為證據；模型必須引用該證據來聲稱發現 flag。
5. Markdown 報告與 PoC 腳本會寫入 ./reports/ 與 ./pocs/。

Why it matters – VulnClaw 展示了如何利用 LLM 進行自主安全測試，同時透過證據門檻系統降低了經典的幻覺風險。它將必要的基礎設施（工具編排、記憶、多提供商 LLM 存取）打包成一個單一的可安裝套件，讓 AI 增強的滲透測試對於授權紅隊工作、CTF 或安全訓練變得更加容易上手。

---

Quick start

pip install vulnclaw          # or `pip install -e .` from source
vulnclaw config provider openai
vulnclaw config set llm.api_key sk-xxxx
vulnclaw run http://target.example.com

Documentation links – English README (README_EN.md), Docker guide (DOCKER.md), MCP deployment docs, 與全套 CLI 參考文件皆包含在儲存庫中。