Skip to main content

🦞🤠 Outclaw 🤠🦞
The shellriff every lobster needs.
Content security for OpenClaw.


The problem

Molty can run commands, edit files, and access the internet. That's what makes Molty useful. It's also what makes Molty dangerous. 🌶️

A prompt injection — hidden instructions in a webpage, a comment in code, a crafted API response — can hijack Molty into:

  • Deleting your files (rm -rf /)
  • Stealing your API keys and sending them to an attacker's server
  • Opening a backdoor on your machine (reverse shells)
  • Leaking your personal information — emails, passwords, credit card numbers — to the AI provider
  • Downloading and running malware from the internet

These aren't hypothetical. They happen today. Even if Molty's access controls are locked down, a single piece of untrusted content — a web page, a pasted log, an email attachment — can slip past the front door.

The fix

Outclaw is the shellriff that rides between Molty and the outside world. 🤠 It watches everything coming in and going out — and anything that looks like trouble gets stopped at the gate.

Your secrets trying to leave town? Outclawed. 🔑
A prompt injection sneaking in? Outclawed. 🧠
A destructive command about to fire? Outclawed. 🛡️

pip install outclaw
outclaw warmup                                        # download security models (one time)
UPSTREAM_BASE_URL=https://api.openai.com/v1 outclaw   # start the lobster tank 🦞
# point your agent at localhost:8080. done.

Six security checks. Every request. Every response. If it's clean, it rides through. If it's not — well, there's a new shellriff in town. 🤠

  You --> Molty --> Outclaw --> AI Service
                    🦞🤠
             watches everything
             stops the bad stuff
             lets the rest ride

How it fits with OpenClaw

OpenClaw already gives you strong controls: sandboxing, tool policies, DM pairing, allowlists. Those control who can talk to Molty and where Molty can act.

Outclaw adds a different layer — it inspects what is actually being sent and received. Even with perfect access controls, untrusted content can still sneak in through web fetches, browser pages, pasted code, or attachments. Outclaw catches that stuff.

OpenClaw is the bouncer at the door. Outclaw is the shellriff inside. 🦞🤠


Quick start

1. Install

pip install outclaw
outclaw warmup        # downloads security models (~90MB, one time)

2. Start Outclaw

Tell Outclaw which AI service Molty uses:

AI Service Command
OpenAI UPSTREAM_BASE_URL=https://api.openai.com/v1 outclaw
Anthropic UPSTREAM_BASE_URL=https://api.anthropic.com/v1 outclaw
Google Gemini UPSTREAM_BASE_URL=https://generativelanguage.googleapis.com/v1beta outclaw
Groq UPSTREAM_BASE_URL=https://api.groq.com/openai/v1 outclaw
Ollama (local) UPSTREAM_BASE_URL=http://127.0.0.1:11434/v1 outclaw

3. Point Molty at Outclaw

Change Molty's API base URL to http://localhost:8080/v1:

openclaw config set models.providers.openai.baseUrl http://localhost:8080/v1

That's it. Molty works exactly like before — but now every request rides through the shellriff first. 🤠🦞


What it protects against

Six guards riding patrol, all on by default. Batteries included — no configuration needed.

Protection What it stops Example
🛡️ Dangerous commands Blocks destructive shell commands, reverse shells, privilege escalation Molty told to run rm -rf / or open a backdoor
📁 File system escape Keeps Molty inside its project folder Molty told to write to /etc/passwd or ~/.ssh/authorized_keys
🌐 Data exfiltration Blocks connections to unknown or malicious websites Molty told to send your code to pastebin.com
🔑 Secret leaks Catches API keys, tokens, and credentials before they leave your machine Your .env file contents about to be sent to the AI
🙈 Personal info leaks Scrubs emails, SSNs, phone numbers, and 30+ types of personal data Your real name and email about to be included in a prompt
🧠 Prompt injection Detects attempts to manipulate Molty into doing harmful things Malicious instructions hidden in a webpage Molty reads

Learn more

  • 🔧 Configuration — customize guards, set environment variables, tune each protection
  • 🔒 Security — what Outclaw doesn't cover, roadmap, and hardening your setup
  • ⚙️ How it works — technical architecture and what each guard does under the hood
  • 🧑‍💻 Development — building from source and running tests

License

MIT — see LICENSE.


"There's a new shellriff in town. And never trust a lobster outside its shell." 🦞🤠

Metadata

Release files for outclaw 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for outclaw 0.1.0
File Size Uploaded Provenance
outclaw-0.1.0.tar.gz 301.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for outclaw 0.1.0
File Interpreter ABI Platform
outclaw-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 324.5 kB

Release files / outclaw-0.1.0.tar.gz

Download URL outclaw-0.1.0.tar.gz
Size 301.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e806c998271baaca773ab7c9517905c72d3e046c1bade9b4ea0e6a2b81d7151e
BLAKE2b-256 checksum
How to use checksums
823b6d46ce50fb2934567ac35a0fea8f8064528f8f3eaadd4509fd6ed32a0863
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release files / outclaw-0.1.0-py3-none-any.whl

Download URL outclaw-0.1.0-py3-none-any.whl
Size 23.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4bf2aba7878119bc516cd080e382cc579b1afd2f4fee094704fe1fdbd6e78d1c
BLAKE2b-256 checksum
How to use checksums
3af081f23e6b807ed677d2ce8b1417e3829ff7baaefc72e57be22fef2d9724e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Security for outclaw 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page