What to do when OpenClaw shows Node.js version incompatible?

OpenClaw requires Node.js 22 or higher. Run nvm install 22 && nvm use 22 to upgrade Node.js version.

How to fix 'auth not configured' in openclaw health?

Run openclaw onboard to reconfigure authentication. If using setup-token, make sure to run claude setup-token to generate a new token.

What to do when WhatsApp QR code scan fails?

First run openclaw channels logout whatsapp to log out, then run openclaw channels login whatsapp to log in again and scan a new QR code.

How to fix Telegram bot not responding to messages?

You need to approve the pairing code first. Run openclaw pairing list telegram to see pending pairings, then run openclaw pairing approve telegram [CODE] to approve.

How to view OpenClaw logs to diagnose issues?

Run openclaw logs --follow to view logs in real-time, or use openclaw gateway to start in foreground for full output. Log files are stored in ~/.openclaw/logs/ directory.

How to reset all OpenClaw configuration?

Back up first, then delete the ~/.openclaw directory and re-run openclaw onboard for initial setup. Note: This will clear all authentication info and chat history.

What to do when OpenClaw gateway port 18789 is occupied?

Run lsof -i :18789 to check which process is using the port, use openclaw gateway --port 18790 to specify another port, or modify the default port in config file.

How to check current OpenClaw version?

Run openclaw --version to check the currently installed version, run openclaw status --all to get a complete system status report.

Troubleshooting

OpenClaw Troubleshooting

Having issues? Find quick diagnosis and solutions for common problems here

Quick Diagnosis

Use these commands to quickly diagnose issues

openclaw status --all

Best one-click diagnostic report with all status information

openclaw gateway status

Check daemon and RPC connectivity status

openclaw doctor

Repair common configuration issues automatically

It's recommended to run openclaw status --all first to get a complete diagnostic report, then locate the issue based on the output.

Startup & Installation Issues

Solve OpenClaw startup failures, missing dependencies and more

Debugging & Logs

Learn how to view logs, generate debug reports, and get help

View Logs

View detailed runtime information and errors through logs

View logs in real-time

$ openclaw logs --follow

Start in foreground to see full output

$ openclaw gateway

Generate Debug Report

Generate a complete debug report to help troubleshoot issues or seek assistance

$ openclaw status --all

The debug report contains system status, configuration information, and is the most useful information when seeking help.

Get Help

If the above methods cannot solve your problem, you can get help through these channels

Official FAQ Documentation GitHub Discussions (Ask questions) Discord Community

Problem Solved?

If your problem is resolved, you can continue exploring other OpenClaw features.

OpenClaw Troubleshooting

Quick Diagnosis

Startup & Installation Issues

Authentication & Model Issues

Channel Connection Issues

Message & Session Issues

Debugging & Logs

View Logs

Generate Debug Report

Get Help

Problem Solved?

Related Documentation