Troubleshooting Hub
Find solutions to common OpenClaw issues and get back up and running quickly
Try searching for "Node.js version", "Telegram webhook", or "permission denied"
Browse by Category
Installation Issues
Node.js errors, dependency conflicts, permission problems
Channel Integration
Telegram, WhatsApp, Slack, Discord connection issues
Configuration Errors
JSON syntax, API keys, gateway connection problems
Platform-Specific
macOS, Linux, Windows, ARM64 compatibility issues
Most Common Issues
Error: Node.js version mismatch
OpenClaw requires Node.js 22+ (Node 22 LTS recommended). Check your version with node --version
Telegram webhook failed to connect
Common causes include incorrect bot token, network issues, or webhook URL configuration problems.
View solution →Invalid JSON syntax in configuration
JSON parsing errors are often caused by missing commas, trailing commas, or unquoted strings.
View solution →Permission denied error during installation
This usually occurs when trying to install globally without proper permissions. Use sudo or configure npm prefix.
View solution →macOS Sequoia compatibility issues
Some users on macOS Sequoia experience issues with certain Node.js versions or system permissions.
View solution →Still Need Help?
Can't find a solution? Our community is here to help you troubleshoot your issue