Troubleshoot

Deployment Troubleshooting

Get unstuck fast with the most common deployment fixes.

Search by error

Search is static for now. Use the quick fixes below.

Top

Port already in use

Service fails to start or exits immediately.

Another service is bound to the same port.

Stop the conflicting service or change the OpenClaw port.

Permission denied

Commands fail with permission errors.

Incorrect file ownership or missing privileges.

Fix permissions or run with the required privileges.

Node version mismatch

Install scripts fail or runtime crashes.

Unsupported Node.js version installed.

Install the version specified by the official docs.

Endpoint not reachable

Health checks fail from another machine.

Firewall, security group, or routing blocks access.

Open the required ports and verify routing.

Service stops after reboot

OpenClaw is not running after restart.

No process manager or service configured.

Use a process manager or system service to keep it running.

Patterns

Most failures are from missing permissions or incorrect ownership.

Verify required ports are open and not already in use.

Use the exact Node.js version recommended by the docs.