Troubleshooting

Solutions for common errors, connection issues, and debugging tips. Find answers to problems you might encounter.

Run these commands to check your OpenClaw installation:

openclaw status

Check if the gateway and services are running

openclaw health

Verify gateway health and connectivity

openclaw security audit --deep

Run a deep security and configuration audit

Common Issue

Moderate Issue

Rare Issue

Command Not Found

Resolve "openclaw: command not found" errors after installation.

Fix connection errors when the gateway fails to start or respond.

Solve file and directory permission issues on Linux and macOS.

Check the official OpenClaw documentation for the most up-to-date troubleshooting information.