Fix your OpenClaw
in one command
AI-powered diagnostic and repair. No SSH access needed. Runs locally, sends redacted logs, gets a fix script back.
npx clawfix
Recommended โ auditable source on npm and GitHub
Want to inspect before running? npx clawfix --dry-run
Works on macOS, Linux, and WSL. Requires Node.js 18+.
How It Works
Run One Command
The diagnostic script scans your OpenClaw installation. Config, logs, plugins, ports โ everything checked in seconds.
AI Analyzes
Pattern matching catches known issues instantly. AI handles novel problems with deep analysis of your specific setup.
Review & Apply
You get a commented fix script. Read it, understand it, then run it. Nothing happens without your approval.
What It Detects
Gateway Crashes
Port conflicts, process hangs, restart loops
Memory Issues
Mem0 silent failures, missing flush, broken search
Browser Automation
CDP port failures, extension loading, headless issues
Plugin Configs
Broken plugins, missing dependencies, wrong settings
Token Waste
Excessive heartbeats, no pruning, bloated context
macOS Quirks
Metal GPU crashes, Apple Silicon issues, Peekaboo
Service Manager Crashes
launchd/systemd SIGTERM recovery, crash loops, backoff detection
Zombie Processes
PID exists but port not listening โ stale gateway detection
Error Log Bloat
Chrome extension spam, handshake storms, 200MB+ log files
Gateway Watchdog
Recommends independent health checks to avoid launchd backoff gaps
Pricing
Quick Scan
Pattern matching against 30+ known issues. Instant results, no AI needed.
Always free
AI Fix
Full AI analysis + generated fix script for novel issues. Pay after you see the fix.
๐ $0 during beta
Monitoring
Continuous health checks. Get alerts before things break. Coming soon.
Security & Transparency
You're right to be skeptical of tools from the internet. Here's exactly what ClawFix does and doesn't do โ verify it yourself.
Inspect Before Running
npx clawfix --dry-run shows exactly what data would be collected โ sends nothing. Read the output. Decide for yourself.
100% Open Source
Every line on GitHub. CLI source, server code, diagnostic script โ all public. Audit it.
Secrets Auto-Redacted
API keys, tokens, passwords โ all replaced with ***REDACTED*** before anything leaves your machine. The env block is skipped entirely.
No File Contents Read
ClawFix checks if SOUL.md exists โ it never reads what's inside. No chat history, no memory files, no personal data.
Consent Required
The diagnostic asks [y/N] before sending anything. No data leaves your machine without you typing "y".
Fix Scripts = Your Review
Fix scripts are saved to /tmp for you to read first. Every fix backs up your config. Nothing auto-executes.
๐ฆ What Exactly Is Sent
โ SENT (redacted)
- โข OS type, version, architecture
- โข Node.js and npm versions
- โข OpenClaw version
- โข Config structure (all secrets redacted)
- โข Recent error log lines
- โข Plugin names + enabled status
- โข Gateway status
- โข Hostname hash (8 chars of SHA-256)
โ NEVER SENT
- โข API keys, tokens, passwords
- โข File contents (SOUL.md, memory, etc.)
- โข Chat history or messages
- โข IP address or real hostname
- โข Environment variables
- โข Personal data of any kind