You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 7f1d067
Browse filesBrowse the repository at this point in the historyBrowse files
**ClawShell** is a security-privileged process for the **OpenClaw** ecosystem. It sits between OpenClaw and upstream LLM API providers (OpenAI, Anthropic, OpenRouter), performing virtual-to-real API key mapping and DLP (Data Loss Prevention) scanning on request and response bodies. It can also expose an Email read endpoint with sender allowlist/denylist filtering.
15
+
**ClawShell** is a security-privileged process for the **OpenClaw/Hermes Agent** ecosystem. It sits between OpenClaw/Hermes Agent and upstream LLM API providers (OpenAI, Anthropic, OpenRouter), performing virtual-to-real API key mapping and DLP (Data Loss Prevention) scanning on request and response bodies. It can also expose an Email read endpoint with sender allowlist/denylist filtering.
16
16
17
-
OpenClaw never holds real API keys, only virtual keys that ClawShell swaps for real ones before forwarding requests upstream. Real keys are stored in a privileged config directory (`/etc/clawshell`) protected by Unix file system permissions.
17
+
OpenClaw/Hermes Agent never holds real API keys, only virtual keys that ClawShell swaps for real ones before forwarding requests upstream. Real keys are stored in a privileged config directory (`/etc/clawshell`) protected by Unix file system permissions.
18
18
19
19
## Key Features
20
20
21
21
### 1. API Token Secure Binding
22
22
23
-
ClawShell maps virtual API keys to real provider keys so that OpenClaw never has direct access to real credentials.
23
+
ClawShell maps virtual API keys to real provider keys so that OpenClaw/Hermes Agent never has direct access to real credentials.
24
24
25
-
-**Key Isolation**: Real API keys are stored in `/etc/clawshell/clawshell.toml`, readable only by the `clawshell` system user. OpenClaw holds only virtual keys.
25
+
-**Key Isolation**: Real API keys are stored in `/etc/clawshell/clawshell.toml`, readable only by the `clawshell` system user. OpenClaw/Hermes Agent holds only virtual keys.
26
26
-**Multi-Provider Support**: Maps keys to OpenAI or Anthropic, injecting the correct authentication header format (`Authorization: Bearer` for OpenAI, `x-api-key` for Anthropic).
27
27
28
28
### 2. PII Safety Net (DLP)
29
29
30
30
ClawShell scans HTTP request and response bodies for sensitive data using configurable regex patterns.
31
31
32
32
-**Request Scanning**: Detects PII (SSNs, credit card numbers, emails, etc.) in outbound requests. Patterns can be configured to either block the request or redact the matched text before forwarding.
33
-
-**Response Scanning**: Optionally scans upstream responses and redacts detected PII before returning to OpenClaw. Streaming (SSE) responses are passed through without scanning.
33
+
-**Response Scanning**: Optionally scans upstream responses and redacts detected PII before returning to OpenClaw/Hermes Agent. Streaming (SSE) responses are passed through without scanning.
34
34
-**Custom Patterns**: Define sensitive data patterns using regex in the TOML config, each with a `block` or `redact` action.
35
35
36
36
### 3. Sensitive Email Isolation
37
37
38
38
ClawShell supports sender-based email filtering so each virtual key only sees mailbox content based on sender rules.
39
39
40
40
-**Sender Filtering**: Filter emails by sender.
41
-
-**Key Isolation**: IMAP credentials are stored in `/etc/clawshell/clawshell.toml`, readable only by the `clawshell` system user. OpenClaw holds only virtual keys.
41
+
-**Key Isolation**: IMAP credentials are stored in `/etc/clawshell/clawshell.toml`, readable only by the `clawshell` system user. OpenClaw/Hermes Agent holds only virtual keys.
42
42
-**Provider Support**: Built-in Gmail and Outlook presets, with manual IMAP setup for other providers.
43
43
44
44
### 4. OAuth Authentication (Codex / ChatGPT)
@@ -84,8 +84,8 @@ ClawShell exposes running counters at `GET /admin/stats` so operators can audit
0 commit comments