Omniclaw: Sovereign Sentinel v4.5.2

Table of Contents

• Overview
• Features
• Architecture
• Quick Start
• Documentation
• AI Agent Supervision
• Kernel Bridge (eBPF)
• Security
• Credits
• License

Overview

Omniclaw is an innovative autonomous cybersecurity platform that leverages a "Hybrid Hive" of AI agents to perform real-time threat detection, automated forensics, and kernel-level neutralization. Unlike traditional IPS/IDS, Omniclaw doesn't just watch—it acts.

Documentation 📚

Comprehensive documentation is available to help you deploy and master the Sovereign Sentinel platform:

• 🍼 Deployment Guide: Step-by-step instructions for Linux, macOS, and Android (Termux).
• 🚀 Use Cases: Real-world scenarios for security, sysadmin, and research.
• 📖 GitHub Wiki: Deep-dives into Architecture, Security Layers, and P2P Networking.
• 🛡️ Security Policy: Guidelines for reporting vulnerabilities.
• 🤝 Contributing Guide: How to join the ZeroDay development team.

Features

• 🛡️ Kernel-Level Defense. Rust-based eBPF probes provide deep, zero-overhead visibility into system calls and network traffic.
• 🤖 Autonomous Swarm. A decentralized team of AI agents that automatically determine and execute defensive steps without human intervention.
• 📉 Sovereign Risk Engine. (New) Real-time behavioral scoring system inspired by Tirreno, featuring automated LOCK and TERMINATE thresholds.
• 🧰 Advanced Security Toolkit. (New) Specialized skills for WiFi Recon, OSINT Reputation (AbuseIPDB), and Injection Auditing (CyberInject).
• ⚡ Zero-Trust Orchestration. Secure communication between agents using P2P encryption and hardware-backed identity.
• 🧩 Modular Plugin System. Hot-swap detection engines, notification connectors, and response playbooks.
• 📊 Mission Control. A sleek, real-time dashboard for system monitoring, telemetry visualization, and manual override.
• 🔗 External SIEM Integration. Out-of-the-box support for Splunk, Elastic, and custom webhooks.

Architecture

Omniclaw is built on a distributed micro-agent architecture designed for resilience and speed.

graph TB
    subgraph Core Services
        UI[Mission Control
React + TypeScript]
        ORCH[Orchestrator
Python + FastAPI]
        DB[(PostgreSQL + pgvector)]
        MQ[Task Queue
Redis]
        SWARM[AI Agent Swarm]
    end

    subgraph Security Layer
        PROBE[eBPF Probes
Rust]
        KERNEL[Linux Kernel]
    end

    UI --> |WebSocket| ORCH
    ORCH --> |Manage| SWARM
    SWARM --> |Telemetry| DB
    SWARM --> |Instructions| PROBE
    PROBE --> |Filter| KERNEL
    KERNEL --> |Events| PROBE
    PROBE --> |Alerts| MQ
    MQ --> |Process| ORCH

Quick Start

Installation

The fastest way to deploy the Sovereign Sentinel node is via the official setup script:

curl -fsSL https://omniclaw.vercel.app/setup.sh | bash

Manual Setup

1. Clone and Install Dependencies

git clone https://github.com/webspoilt/omniclaw.git
cd omniclaw
pip install -r requirements.txt

2. Configure Environment

cp .env.example .env
# Add your LLM API keys and configuration

3. Launch the Orchestrator

python orchestrator.py

AI Agent Supervision

Omniclaw includes sophisticated multi-layered agent supervision to ensure efficient task execution and prevent hallucination loops:

• Mentor Agent: Automatically monitors agent behavior and recommends alternative attack/defense vectors.
• Pattern Detection: Detects redundant tool calls and redirects agents to search for established solutions.
• Self-Healing: If an agent fails to reach a target, the Reflector agent analyzes the failure and updates the Hive context.

Kernel Bridge (eBPF)

The heart of Omniclaw's visibility is the Rust-based kernel bridge.

• Direct Link: Connects the AI Hive directly to the Linux kernel.
• Zero Overhead: eBPF bytecode executes in the kernel context for maximum performance.
• Packet-Level Inspection: Inspects every packet before it reaches the network stack.

Security

Please report security vulnerabilities to [email protected]. See SECURITY.md for more details.

Built with ❤️ by zeroday ⭐ Star on GitHub if you believe in the future of autonomous defense!

🚀 Quick Start

git clone https://github.com/webspoilt/omniclaw.git
cd omniclaw
pip install -r requirements.txt