Troubleshooting & Fixes

"openclaw not found"

This is usually a PATH issue. Ensure you have installed the global package and your npm bin path is correctly set.

npm install -g @openclaw/core

Gateway Timeout

If the gateway fails to connect, check if port 3000 is being used by another application. You can change the port in your .env file.

Skill Permissions Denied

Ensure OpenClaw has write access to its /skills directory. on Unix, run:

chmod -R 755 ~/.openclaw/skills
Doctor Command: Run openclaw doctor to perform a full system health check.