sentinel-proxy

Sentinel AI Firewall

Protect your Open Claw agent from prompt injection, jailbreaks, malicious skill output, and data exfiltration — automatically, on every message and tool result.

What It Does

Sentinel intercepts three critical points in the agent lifecycle:

• UserPromptSubmit — user input is scrubbed before your agent processes it
• PreToolUse — scans what your agent is about to send to a tool, blocking data exfiltration before it leaves the session
• PostToolUse — scans tool/skill responses before they reach the agent, catching malicious skills that try to hijack your agent via crafted output

PreToolUse is the primary defense against the malicious Clawhub skill attack pattern, where a compromised skill returns a crafted response designed to take over the agent or steal session data.

Setup

1. Get a Sentinel API key

1. Sign up at sentinelaifirewall.com with email and password — free Starter tier available, no credit card required.
2. Once signed in, go to Dashboard → Keys and generate a key. It starts with sk_live_.

2. Set environment variables

export SENTINEL_API_URL=https://api.sentinelaifirewall.com
export SENTINEL_KEY=sk_live_...

Add these to your shell profile or .env file so they persist across sessions.

3. Install the skill

openclaw skills install sentinel

That's it. The bootstrap hook will verify your credentials on next agent start.

---

Transparent Proxy Mode (Recommended)

For complete protection — including scanning what your agent sends to external tools — route your LLM traffic through Sentinel's transparent proxy. Sentinel sits between Open Claw and the Anthropic API, scanning all content in both directions with zero changes to your agent code.

export ANTHROPIC_BASE_URL=https://api.sentinelaifirewall.com/v1
export ANTHROPIC_API_KEY=sk_live_...   # your Sentinel key replaces your Anthropic key here

Your agent uses the Anthropic SDK exactly as before. Sentinel proxies the request, scans tool results before they return to your agent, and passes clean traffic through with no overhead.

---

Detection Layers

Every scrub request runs through three layers:

1. Text normalization — strips invisible characters, Unicode homoglyphs, bidi overrides, and Unicode tag blocks before scanning
2. Fast-path regex — 22 patterns catch high-confidence attacks (authority hijacks, prompt extraction, persona shifts, tool abuse) with near-zero latency
3. Deep-path vector similarity — semantic embedding compared against 30+ attack signatures in pgvector; catches novel attacks that bypass regex

Actions

---

Scrub Tier

The hooks use standard tier by default. To switch to strict mode (lower thresholds, more aggressive):

export SENTINEL_TIER=strict

---

What Gets Logged

Sentinel does not log or store the content of clean requests. Flagged, neutralized, and blocked events are logged locally by the hook scripts with the threat score and action taken.