Skip to main content

OpenClaw security audit tool

Project description

Foresight ClawAudit

Security audit tool for OpenClaw instances. Scans runtime configuration, system environment, Skill plugins, supply chain integrity, and known CVEs — covering 31 check points across 8 categories.

What OpenClaw Leaves on Your System

Type Path Content
Main config ~/.openclaw/ openclaw.json, API keys, workspace, memory
Workspace ~/.openclaw/workspace/ Files the AI operated on, Skill plugin code
Memory ~/.openclaw/memory/ SQLite + Markdown memory data
Agent auth ~/.openclaw/agents/*/agent/auth-profiles.json OAuth tokens, third-party authorizations
Logs ~/.openclaw/logs/ Gateway runtime logs
Legacy dirs ~/.clawdbot/, ~/.moltbot/, ~/.molthub/ Pre-rename configs (Clawdbot -> Moltbot -> OpenClaw)
System service LaunchAgent (macOS) / systemd (Linux) Gateway daemon on 127.0.0.1:18789, runs 24/7
Exec approvals ~/.openclaw/exec-approvals.json Shell command allowlist

Foresight ClawAudit helps you identify security risks across all of these.

Quick Start

# Install uv if not already installed (https://docs.astral.sh/uv/)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run directly without install Foresight ClawAudit
uvx clawaudit scan --mode local

Platform Requirements

  • Linux / macOS: Supported natively
  • Windows: Must run under WSL. Native Windows is not supported

Installation

pip install clawaudit
# or
uv pip install clawaudit

Usage

# Local scan (auto-detect OpenClaw path)
clawaudit scan --mode local
clawaudit scan --mode local --path ~/.openclaw

# Filter by category or check
clawaudit scan --mode local --category NET,AUTH

# Output: terminal (default) / json / sarif / markdown
clawaudit scan --mode local --format json -o report.json

# CVE database
clawaudit cvedb update
clawaudit cvedb list

Root is not required. Checks needing elevated privileges will SKIP with a reason. Exit codes: 0 = all pass, 1 = has FAIL, 2 = has CRITICAL.

Check Categories

Code Category Checks Summary
NET Network Exposure 4 Port binding, TLS, IOC
AUTH Authentication 2 Weak token, UI bypass
CONF Configuration 4 Permissions, flags, baseline
EXEC Execution Sandbox 8 Injection, sandbox, prompt
SC Supply Chain 3 Source, integrity, poisoning
DATA Data Security 4 Keys, leakage, exfiltration
SYS System Security 6 Privileges, cron, SSH
CVE Known Vulnerabilities Dynamic Version matching (271 advisories)

License

Proprietary. For personal and internal use only. Redistribution and modification are not permitted.

About

Developed by Beijing Institute of AI Safety and Governance (Beijing-AISI). Beijing-AISI focuses on safe development, safety and security assessment, and governance of AI.

Contact

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clawaudit-0.2.0a6-py3-none-any.whl (54.1 kB view details)

Uploaded Python 3

File details

Details for the file clawaudit-0.2.0a6-py3-none-any.whl.

File metadata

  • Download URL: clawaudit-0.2.0a6-py3-none-any.whl
  • Upload date:
  • Size: 54.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for clawaudit-0.2.0a6-py3-none-any.whl
Algorithm Hash digest
SHA256 42a035df7977fbf961c0351c2d8d559c12dca6e6deea3a6904b34d6f87768bbb
MD5 4366fe4b96115cbf7b99083420ecc583
BLAKE2b-256 a10e5b8dd0259b7b2f206c88a909e0c12081cd90d1aa713929da3bd9db4717ca

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page