OpenClaw Integration

Protect your OpenClaw personal AI assistant from prompt injection, jailbreak attempts, and data exfiltration attacks.

What is OpenClaw?

OpenClaw is a self-hosted personal AI assistant that connects to 13+ messaging channels including WhatsApp, Telegram, Slack, Discord, Signal, iMessage, and Teams. RAXE adds a security layer that scans all incoming messages before they reach the AI.

Recommended Approach: MCPorter Integration

The recommended way to integrate RAXE with OpenClaw is via MCPorter, which gives your AI agent access to RAXE as a tool. The agent can then scan messages on-demand.

Architecture

User Message --> AI Agent --> mcporter skill --> RAXE MCP Server --> L1+L2 Detection
                                                        |
                                              SAFE --> Continue
                                              THREAT --> Block/Warn

MCPorter Tools Reference

MCPorter exposes three RAXE tools:

Tool	Purpose	Example
`scan_prompt`	Scan text for security threats	`mcporter call raxe.scan_prompt text="..."`
`list_threat_families`	List available threat categories	`mcporter call raxe.list_threat_families`
`get_rule_info`	Get details about a specific rule	`mcporter call raxe.get_rule_info rule_id="pi-001"`

How It Works

Message arrives (WhatsApp, Telegram, etc.)
    |
    v
AI Agent receives message
    |
    v
Agent calls RAXE via MCPorter
    |
    v
Scans with L1 (515+ rules) + L2 (ML)
    |
    v
+------------------+
| Threat detected  |--> Block or warn user
| Clean message    |--> Continue processing
+------------------+

The RAXE MCP server runs locally and never transmits your message content.

Configuration

Enable Blocking Mode

By default, RAXE logs threats but allows messages through. To block threats:

Environment Variable
OpenClaw Config

export RAXE_BLOCK_THREATS=true
openclaw gateway restart

{
  "hooks": {
    "internal": {
      "entries": {
        "raxe-security": {
          "enabled": true,
          "env": {
            "RAXE_BLOCK_THREATS": "true"
          }
        }
      }
    }
  }
}

Troubleshooting

mcporter not finding RAXE server

Verify your mcporter configuration:

# Check if raxe is configured
mcporter list

# Test the RAXE MCP server directly
raxe mcp serve --quiet <<< '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

If the MCP server works but mcporter doesn’t see it, check ./config/mcporter.json exists and has the correct format.

RAXE command not found

Ensure RAXE is installed and in your PATH:

pip install raxe
which raxe

If using a virtual environment, activate it before running OpenClaw commands.

Performance

Mode	Latency (P50)	Latency (P95)
Default (L1 + L2)	~3.5ms	~5.5ms
L1 only	~0.4ms	~0.5ms

Privacy

All scanning happens locally
Only prompt hashes are logged (not content)
No cloud API calls required
Matched patterns are never exposed

Next Steps

Detection Rules

Learn about RAXE’s 515+ detection rules

Custom Rules

Add your own detection patterns

Future: Native Message Hooks (Planned)

This API is not yet available. Use the MCPorter approach above for current integration.

OpenClaw’s hooks system currently supports command events (command:new, command:reset, command:stop), agent events (agent:bootstrap), and gateway events (gateway:startup).Message events (message:inbound, message:sent, message:received) are listed as “planned” in OpenClaw’s documentation but are not yet implemented (confirmed February 2026).Once message hooks are available, RAXE will support automatic scanning via:

raxe openclaw install

This will install a native hook that triggers on every inbound message without requiring MCPorter or agent-level configuration.

CLI Reference

# Standard install
raxe openclaw install

# Force reinstall (overwrites existing)
raxe openclaw install --force

# Check status
raxe openclaw status

# Uninstall
raxe openclaw uninstall

Getting Started

How It Works

Protect Your AI

Guides

Advanced

Enterprise

Reference

OpenClaw Integration

OpenClaw Integration

What is OpenClaw?

Recommended Approach: MCPorter Integration

Architecture

MCPorter Tools Reference

How It Works

Configuration

Enable Blocking Mode

Troubleshooting

Performance

Privacy

Next Steps

Detection Rules

Custom Rules

CLI Reference

​OpenClaw Integration

​What is OpenClaw?

​Recommended Approach: MCPorter Integration

​Architecture

​MCPorter Tools Reference

​How It Works

​Configuration

​Enable Blocking Mode

​Troubleshooting

​Performance

​Privacy

​Next Steps

Detection Rules

Custom Rules

​CLI Reference

OpenClaw Integration

What is OpenClaw?

Recommended Approach: MCPorter Integration

Architecture

MCPorter Tools Reference

How It Works

Configuration

Enable Blocking Mode

Troubleshooting

Performance

Privacy

Next Steps

CLI Reference