____         ____                       ____  _
    / __ \  ___  / __/___   ___   ___  ___  / ___|| | __ _ __      __
   / / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| |    | |/ _` |\ \ /\ / /
  / /_/ / /  __/ __//  __/| | | |\__ \  __/| |___ | | (_| | \ V  V /
 /_____/  \___/_/   \___/ |_| |_||___/\___| \____||_|\__,_|  \_/\_/

DefenseClaw एक Python ऑपरेटर CLI, एक Go गेटवे साइडकार और एक OpenClaw TypeScript प्लगइन को जोड़ता है। साथ मिलकर वे एक सरल संचालन नियम लागू करते हैं: अविश्वसनीय एजेंट क्षमताओं को स्कैन किया जाता है, शासित किया जाता है, लॉग किया जाता है, और जब नीति कहती है कि वे असुरक्षित हैं तो अवरुद्ध किया जाता है।

मुख्य बातें

• प्रवेश नियंत्रण - स्किल, MCP सर्वर, प्लगइन और कोड को चलने से पहले स्कैन करें।
• रनटाइम सुरक्षा रेलिंग - रेगेक्स नियमों, नीति, वैकल्पिक LLM जज और सिस्को एआई डिफेंस निरीक्षण के साथ प्रॉम्प्ट, कम्प्लीशन और टूल कॉल का निरीक्षण करें।
• CodeGuard - रहस्य, खतरनाक निष्पादन, असुरक्षित डिसीरियलाइज़ेशन, कमजोर क्रिप्टो, इंजेक्शन पैटर्न और जोखिमपूर्ण फ़ाइल एक्सेस के लिए अंतर्निहित स्थैतिक जाँच।
• OpenShell सैंडबॉक्स समर्थन - नेटवर्क, फ़ाइल सिस्टम, सिस्कॉल और नीति नियंत्रणों के साथ लिनक्स सैंडबॉक्स सेटअप।
• रजिस्ट्री - SSRF गार्ड, स्कैनर-ऑपरेटेड निर्णय और संपत्ति नीति में ऑटो-प्रमोशन के साथ बाहरी स्किल / MCP कैटलॉग (कॉर्पोरेट HTTPS YAML, smithery.ai, skills.sh, git, ClawHub) को शामिल करें। docs/REGISTRIES.md देखें।
• ऑडिट और अवलोकन क्षमता - बकेट संग्रह, अनिवार्य SQLite इतिहास, केंद्रीकृत रिडक्शन और स्वतंत्र JSONL, OTLP, Prometheus, Splunk HEC, Galileo, HTTP, कंसोल और स्थानीय Grafana/Splunk गंतव्यों के लिए एक कॉन्फ़िग- v8 ग्राफ।
• ऑपरेटर UX - सेटअप, स्वास्थ्य जाँच, अलर्ट, ब्लॉक/अनुमति सूचियाँ, स्कैनर परिणाम और नीति कार्यप्रवाहों के लिए एक CLI और TUI।

दायरा और सीमाएँ

DefenseClaw एजेंटिक एआई तैनातियों के लिए एक प्रवर्तन और साक्ष्य परत है। यह स्कैनर परिणामों, रनटाइम निरीक्षण, नीति निर्णयों, सैंडबॉक्स नियंत्रणों और ऑडिट ट्रेल्स को मिलाकर सुरक्षा में सुधार करता है, लेकिन यह साबित नहीं करता है कि कोई एजेंट, स्किल, प्लगइन या मॉडल इंटरैक्शन जोखिम-मुक्त है।

उच्च-जोखिम वाली तैनातियों को DefenseClaw के साथ मानव समीक्षा, न्यूनतम-विशेषाधिकार क्रेडेंशियल्स, सैंडबॉक्सिंग, CI गेट और उत्पादन निगरानी जोड़नी चाहिए। अवलोकन मोड में, निष्कर्षों को अवरुद्ध किए बिना लॉग किया जाता है। कार्रवाई मोड में, कॉन्फ़िगर किए गए HIGH और CRITICAL निष्कर्ष प्रॉम्प्ट, टूल कॉल या घटक प्रवेश को अवरुद्ध कर सकते हैं।

दस्तावेज़ीकरण

प्रोजेक्ट Markdown दस्तावेज़ीकरण docs/ के अंतर्गत केंद्रीकृत है। पैकेज-स्थानीय README उन बंडलों या उदाहरणों के पास रहते हैं जिन्हें स्थानीय संदर्भ की आवश्यकता होती है।

स्थापना

पूर्वापेक्षाएँ

स्रोत से बिल्ड करें (केवल डेवलपर्स के लिए)

इच्छा के अनुसार कमांड चुनें:

स्रोत लक्ष्य और `scripts/install-dev.sh` डेवलपमेंट टूलिंग हैं, अपग्रेड पथ नहीं। प्रत्यक्ष स्थापना लक्ष्य एक रिलीज़-प्रबंधित स्थापना या किसी अन्य चेकआउट के स्वामित्व वाली स्थापना को ओवरराइट करने से इनकार करते हैं। `make all` स्पष्ट डेवलपर-मशीन पुनर्स्थापना कार्यप्रवाह है: जब स्थापित CLI पहले से ही वर्तमान चेकआउट की ओर इंगित करता है, तो यह मार्करलेस या पिछली-रिलीज़ स्रोत स्थिति को पुनः प्राप्त कर सकता है और पुनर्निर्माण के बाद एक सख्त स्वामित्व मार्कर रिकॉर्ड करता है। यह चेकआउट के वर्तमान माइग्रेशन को डेवलपर स्थिति के विरुद्ध चला सकता है और इसे रिलीज़ अपग्रेड के रूप में उपयोग नहीं किया जाना चाहिए। रिलीज़-प्रबंधित स्थापनाओं को रिलीज़-स्वामित्व वाले `scripts/upgrade.sh` या `scripts/upgrade.ps1` रिज़ॉल्वर का उपयोग करना चाहिए। `make install`, `make dev-install`, और `scripts/install-dev.sh` एक नए या पृथक डेवलपमेंट होम के लिए निचले-स्तरीय सख्त प्लंबिंग हैं; वे सामान्य दोहराए जाने वाले डेवलपमेंट कमांड नहीं हैं।

### रिलीज़ स्क्रिप्ट के साथ स्थापित करें```bash
VERSION=0.8.6
INSTALL_URL="https://raw.githubusercontent.com/cisco-ai-defense/defenseclaw/${VERSION}/scripts/install.sh"
curl -LsSf "$INSTALL_URL" | VERSION="$VERSION" bash
defenseclaw init --enable-guardrail

प्लेटफ़ॉर्म-विशिष्ट चरणों के लिए, docs/INSTALL.md देखें।

मूल Windows x64 पर, मूल Setup EXE और हुक-केवल कनेक्टर पथ का उपयोग करें नेटिव विंडोज गाइड में। WSL समर्थित नहीं है। Codex CLI और Claude Code ही एकमात्र प्रमाणित विंडोज कनेक्टर हैं।

त्वरित आरंभ```bash

Check the local install and dependencies

defenseclaw doctor

Initialize config, scanner defaults, and guardrail plumbing

defenseclaw init --enable-guardrail

Scan installed agent capabilities

defenseclaw skill scan all defenseclaw mcp list defenseclaw plugin scan extensions/defenseclaw

Start the Go gateway sidecar

defenseclaw-gateway start

Open the operator dashboard

defenseclaw tui

ट्यूनिंग के दौरान guardrail को observe mode में चलाएं:```bash
defenseclaw setup guardrail --mode observe --restart

जब नीति ब्लॉक करने के लिए तैयार हो तो एक्शन मोड पर स्विच करें:```bash defenseclaw setup guardrail --mode action --restart

पूर्ण वॉकथ्रू के लिए [docs/QUICKSTART.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/QUICKSTART.md) देखें।

---

## आर्किटेक्चर

| घटक | रनटाइम | भूमिका |
|-----------|---------|------|
| Python CLI | Python | ऑपरेटर कमांड्स, स्कैनर आर्केस्ट्रेशन, कॉन्फ़िग सेटअप, स्थानीय बंडल |
| Gateway sidecar | Go | REST API, WebSocket ब्रिज, पॉलिसी इंजन, गार्डरेल प्रॉक्सी, ऑडिट स्टोर, टेलीमेट्री |
| OpenClaw plugin | TypeScript | फेच इंटरसेप्शन, टूल-कॉल इंस्पेक्शन हुक्स, स्लैश कमांड्स, साइडकार इंटीग्रेशन |
| Policies | YAML/Rego | एडमिशन निर्णय, गार्डरेल एक्शन्स, सैंडबॉक्स/फायरवॉल व्यवहार, स्कैनर प्रोफाइल |
| दस्तावेज़ीकरण | Markdown/JSON | केंद्रीकृत डॉक्स, पैकेज-लोकल READMEs, और DeepWiki कॉन्फ़िगरेशन |

गेटवे CLI और प्लगइन के लिए स्थानीय REST APIs को उजागर करता है, WebSocket पर OpenClaw से जुड़ता है, स्थानीय प्रॉक्सी के माध्यम से LLM ट्रैफ़िक का निरीक्षण करता है, और एक स्थायी ऑडिट स्टोर में निर्णय रिकॉर्ड करता है।```text
Agent runtime -> OpenClaw plugin -> DefenseClaw gateway -> policy + scanners + audit
                                    |
                                    +-> guardrail proxy -> LLM provider
                                    +-> OTLP / Splunk / webhooks / JSONL

आरेख और विस्तृत प्रवाह के लिए, देखें docs/ARCHITECTURE.md।

स्कैनिंग और गार्डरेल्स

DefenseClaw Cisco AI Defense स्कैनर्स और स्थानीय नीति को एक एकल प्रवेश प्रवाह में लपेटता है:

स्कैनर नीतियाँ policies/scanners/ में स्थित हैं। गार्डरेल नियम पैक policies/guardrail/ में स्थित हैं।

प्रेक्षणीयता

DefenseClaw कई चैनलों पर प्रवर्तन और रनटाइम साक्ष्य रिकॉर्ड करता है:

Config v8 स्रोत को संक्षिप्त रखता है जबकि चूक को एक पूर्ण प्रभावी योजना में संकलित करता है:```yaml config_version: 8 observability: {}

वह डिफ़ॉल्ट हर पंजीकृत लॉग, ट्रेस और मीट्रिक को एकत्र करता है और एकत्र किए गए प्रत्येक लॉग को अनरेडैक्टेड रूप में अनिवार्य स्थानीय SQLite में रखता है। कोई रिमोट एक्सपोर्ट तब तक नहीं होता जब तक कोई गंतव्य न जोड़ा जाए। बिना `send` या `routes` के सक्षम गंतव्य हर बकेट और हर सिग्नल प्राप्त करता है जो उसके प्रकार का समर्थन करता है, अनरेडैक्टेड: सामान्य OTLP को लॉग/ट्रेस/मीट्रिक मिलते हैं, Splunk HEC को लॉग मिलते हैं, Prometheus को मीट्रिक मिलते हैं, और Galileo प्रीसेट को ट्रेस मिलते हैं। कई गंतव्य स्वतंत्र प्रतियां प्राप्त करते हैं।

विस्तारित नीति और अनरेडैक्टेड लेग्स की समीक्षा करें:```bash
defenseclaw config show --effective --section observability
defenseclaw observability plan

प्रति बकेट या गंतव्य के अनुसार केंद्रीकृत none, sensitive, content, strict, या कस्टम फ़ील्ड-जागरूक रिडक्शन प्रोफ़ाइल का उपयोग करें। पूर्ण-निष्ठा डिफ़ॉल्ट में प्रॉम्प्ट, आउटपुट, टूल आर्गुमेंट/परिणाम, साक्ष्य, पथ और पहचानकर्ता शामिल हो सकते हैं, इसलिए किसी ऐसी ट्रस्ट सीमा के पार निर्यात करने से पहले एक रिडैक्टिंग प्रोफ़ाइल कॉन्फ़िगर करें जिसे वह सामग्री प्राप्त नहीं करनी चाहिए।

स्रोत फ़ाइल में बकेट और रिडक्शन नीति संपादित करें, गेटवे के देखने से पहले इसे मान्य करें, और उत्पन्न संदर्भ को पूरी तरह से कॉपी करने के बजाय संकलित परिणाम का निरीक्षण करें:```bash umask 077 cp "$HOME/.defenseclaw/config.yaml"
"$HOME/.defenseclaw/config.yaml.before-observability-edit" ${EDITOR:-vi} "$HOME/.defenseclaw/config.yaml"

defenseclaw config validate &&
defenseclaw config show --effective --section observability &&
defenseclaw observability plan &&
defenseclaw-gateway restart &&
defenseclaw doctor

सत्यापन विफलता के बाद पुनरारंभ न करें। निजी बैकअप पुनर्स्थापित करें, स्रोत को सही करें, और फिर से सत्यापित करें। एक वैश्विक या बकेट रिडक्शन प्रोफ़ाइल उत्पन्न स्थानीय SQLite प्रक्षेपण पर भी लागू होता है। पूर्ण-निष्ठा स्थानीय इतिहास रखते हुए केवल एक दूरस्थ ट्रस्ट सीमा को रिडैक्ट करने के लिए, वैश्विक/बकेट प्रोफ़ाइल को `none` पर छोड़ें और उस दूरस्थ गंतव्य पर `send.redaction_profile` या एक रूट प्रोफ़ाइल सेट करें।

स्थानीय ऑब्जर्वेबिलिटी इसके साथ शुरू करें:```bash
defenseclaw setup local-observability up
defenseclaw-gateway start
defenseclaw setup local-observability status

डैशबोर्ड खालीपन एक ही स्थिति नहीं है: 0 का अर्थ है कि इंस्ट्रूमेंटेड सिग्नल में शून्य मैचिंग इवेंट थे, No data का अर्थ है कि चयनित रेंज और फिल्टर के लिए कोई मैचिंग सीरीज़/लॉग/ट्रेस मौजूद नहीं है, और Not reported का अर्थ है कि कनेक्टर/प्रदाता ने टोकन या लागत जैसा कोई वैकल्पिक मान प्रदान नहीं किया। HITL, केवल-विफलता दृश्य, और Trace ID चयनित होने से पहले ट्रेस वॉटरफॉल जैसे सशर्त पैनल No data दिखाने की अपेक्षा करते हैं। गंतव्य परीक्षण केवल कनेक्टिविटी की जांच करता है और सामान्य डैशबोर्ड ट्रैफ़िक नहीं बनाता; संबंधित पैनलों को मान्य करने के लिए एक नया वास्तविक एजेंट टर्न, टूल कॉल, स्कैन या अनुमोदन उत्पन्न करें।

Agent360 का नोड ग्राफ़ Loki-समर्थित लाइफसाइकल DAG है: सत्र निर्माण एक अलग एंकर है, प्रति-रूट Prompt inputs नोड रेंज में विशिष्ट डेप्थ-ज़ीरो model.request तथ्यों की गणना करता है, और माता-पिता से बच्चे को प्रतिनिधिमंडल प्रति-एजेंट मॉडल, टूल, अनुमोदन, अपडेट, टर्न-परिणाम और टर्मिनल सारांश फीड करता है। Prompt inputs टर्न, मॉडल-अनुरोध, अनुरोध, ऑपरेशन, फिर occurrence ID द्वारा डिडुप्लिकेट होते हैं; ऑर्डर/रॉ व्यू व्यक्तिगत प्रारंभिक और अनुवर्ती रिकॉर्ड बनाए रखते हैं। सत्र और स्पॉन एंकर पिछले 24 घंटों से पुनर्प्राप्त किए जा सकते हैं ताकि सीमा विंडो रेंडरेबल बनी रहे; एक पुनर्प्राप्त स्पॉन तभी रखा जाता है जब उस बच्चे के पास चयनित रेंज में ग्राफ़-पात्र गतिविधि हो। दोहराए गए मॉडल कॉल को स्वामी एजेंट, प्रदाता और मॉडल द्वारा समूहित किया जाता है। दोहराए गए टूल कॉल को स्वामी एजेंट द्वारा Bash, MCP, Skills, Collaboration, File edits, Web/browser, Visual, या Task control में समूहित किया जाता है; एक अपरिचित टूल अपना रिपोर्ट किया गया नाम रखता है। सटीक collaboration.send_message अनुरोधों को सामान्य Collaboration परिवार से बाहर रखा जाता है ताकि वे केवल संदेश समूहों के रूप में दिखाई दें; अन्य सहयोग उपकरण उस परिवार में रहते हैं। अनुरोध रिकॉर्ड शामिल किए जाते हैं भले ही कोई टर्मिनल समकक्ष न आया हो। उनका समूहित कुल एक अनुरोध गणना है, यह दावा नहीं कि हर अनुरोध अभी भी लंबित है; टर्मिनल स्थिति लिंक किए गए रॉ रिकॉर्ड में उपलब्ध रहती है। डेप्थ 0 रूट है और रिकर्सिव चिल्ड्रन को डेप्थ 64 तक रिपोर्ट किया जा सकता है; क्लिक विवरण पहचानता है कि प्रत्येक वंश किनारा कनेक्टर द्वारा रिपोर्ट किया गया था या DefenseClaw द्वारा अनुमानित। नोड क्लिक सटीक गणना और स्थिर एजेंट/रूट/पैरेंट पहचान को उजागर करते हैं, प्रत्येक समूह के पीछे कच्ची OTEL घटनाओं के फ़िल्टर्ड लिंक के साथ। वैकल्पिक current/root/parent session फ़ील्ड लाइफसाइकल, सत्र, ऑर्डर और रॉ सतहों पर बने रहते हैं; वे एजेंट-नोड समूहीकरण कुंजी नहीं हैं, इसलिए लापता या देर से सत्र मेटाडेटा एक एजेंट के कुल को विभाजित नहीं कर सकता।

डैशबोर्ड फ़ील्ड को फिर से रिडैक्ट, मास्क या छिपाते नहीं हैं। DefenseClaw कैनोनिकल OTEL निर्यात से पहले केंद्रीकृत v8 रिडैक्शन लागू करता है; Grafana उस प्रक्षेपण में वास्तव में मौजूद प्रत्येक फ़ील्ड को दिखाता या लिंक करता है, जिसमें वह सामग्री भी शामिल है जब उत्पादक ने इसे निर्यात किया था। निर्यात से पहले हटाया या रूपांतरित किया गया फ़ील्ड स्थानीय स्टैक द्वारा पुनर्प्राप्त नहीं किया जा सकता। अपडेट किनारे केवल वास्तविक collaboration.send_message टूल रिकॉर्ड से आते हैं। प्रत्येक प्रेषक के लिए, /root और /root/* लक्ष्य एक Messages to root नोड में विलीन हो जाते हैं जिसका लक्ष्य एजेंट ID निर्यात किए गए रूट पर हल होता है। सटीक रूट कार्य पथ और कॉल ऑर्डर/रॉ ड्रिल-डाउन में बने रहते हैं। गैर-रूट लक्ष्य स्पष्ट रूप से सटीक कार्य पथ द्वारा समूहित रहते हैं और जब कनेक्टर ने उस मैपिंग की रिपोर्ट नहीं की तो अपारदर्शी एजेंट-ID जॉइन के रूप में आविष्कार नहीं किए जाते हैं। सामान्य संगतता इवेंट को कभी भी अपडेट के रूप में पुनः लेबल नहीं किया जाता है।

वैकल्पिक गंतव्यों के पास स्वतंत्र बाध्य कतारें हैं। डिफ़ॉल्ट 2,048 रिकॉर्ड और 64 MiB प्रति कतार हैं; पुश बैच डिफ़ॉल्ट 512 रिकॉर्ड, 8 MiB और 5 सेकंड (छोड़े गए Galileo प्रीसेट विलंब के लिए 1 सेकंड) हैं। कतार ओवरफ़्लो नवीनतम प्रयासित एनक्यू को गिरा देता है बिना पुराने FIFO कार्य को हटाए या अनिवार्य SQLite और सहोदर गंतव्यों को प्रभावित किए। सटीक फ़ील्ड, सीमाएं और एडॉप्टर अंतर docs/OBSERVABILITY.md में हैं।

Galileo Cloud या सेल्फ-होस्टेड Galileo को स्थानीय रूट को बदले बिना जोड़ें:```bash export GALILEO_API_KEY='...' defenseclaw setup galileo --project defenseclaw --logstream production defenseclaw setup galileo test

देखें [docs/OBSERVABILITY.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/OBSERVABILITY.md), [Galileo गाइड](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs-site/content/docs/observability/galileo.mdx), और [स्कीमा स्वामित्व मानचित्र](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/schemas/README.md)। Splunk-विशिष्ट सेटअप [docs/SPLUNK_APP.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/SPLUNK_APP.md) में है।

प्रत्येक समर्थित मौजूदा POSIX इंस्टॉलेशन, जिसमें पहले से `0.8.4` पर चल रहा एक भी शामिल है, प्रमाणित टार्गेट-रिलीज़ `defenseclaw-upgrade.sh` एसेट के साथ नवीनतम मोड में, बिना किसी वर्जन ओवरराइड के `0.8.5` हार्ड कट को पार करता है। अपरिवर्तनीय `0.8.4` बिल्ट-इन पार्सर उस सत्य लक्ष्य मैनिफेस्ट को स्वीकार नहीं कर सकता जिसका Windows ब्रिज मैट्रिक्स खाली है। किसी भी जमे हुए बिल्ट-इन CLI द्वारा मुद्रित पुराने raw-network संकेत को निष्पादित न करें। रिलीज़-स्वामित्व वाला रिज़ॉल्वर `source → 0.8.4 bridge → fresh 0.8.4 controller → 0.8.5 hard cut` को एक लेन-देन के रूप में निष्पादित करता है। माइग्रेशन कॉन्फ़िगरेशन का बैकअप लेता है और परमाणु रूप से रूपांतरित करता है, संकुचित रूटिंग/रेडक्शन व्यवहार और रूट/सबएजेंट Agent360 संगतता को संरक्षित करता है, वॉल्यूम रीसेट किए बिना स्वामित्व वाले स्थानीय डैशबोर्ड को ताज़ा करता है, और कभी भी एक अलग apply कमांड की आवश्यकता नहीं होती है। प्रमाणित रिज़ॉल्वर बूटस्ट्रैप के लिए [CLI संदर्भ — upgrade](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/CLI.md#upgrade) देखें।

Splunk Observability Cloud के लिए, निम्नलिखित डैशबोर्ड बंडल का उपयोग करें [bundles/splunk_o11y_dashboards/README.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/bundles/splunk_o11y_dashboards/README.md):```bash
defenseclaw setup splunk dashboards apply \
  --api-url <api-endpoint> \
  --o11y-api-token <api-access-token> \
  --with-detectors \
  --enable-detectors \
  --yes

विकास```bash

Build all components

make build

Run primary test suites

make test

Run lint checks

make lint

[docs/TESTING.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/TESTING.md) और [docs/CONTRIBUTING.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/CONTRIBUTING.md) में संकेंद्रित परीक्षण और विकास मार्गदर्शन दिया गया है।

---

## योगदान

योगदान का स्वागत है। [CONTRIBUTING.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/CONTRIBUTING.md), [docs/CONTRIBUTING.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/docs/CONTRIBUTING.md) और उस क्षेत्र के विशिष्ट दस्तावेज़ों से शुरुआत करें जिसे आप बदल रहे हैं।

## सुरक्षा

कृपया [SECURITY.md](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/SECURITY.md) में दी गई प्रक्रिया के माध्यम से कमजोरियों की रिपोर्ट करें।

## लाइसेंस

Apache 2.0 - [LICENSE](https://github.com/cisco-ai-defense/defenseclaw/blob/HEAD/LICENSE) देखें।

कॉपीराइट 2026 Cisco Systems, Inc. और इसके सहयोगी।