Troubleshoot
Quick fixes for common setup issues.
Node.js command not found
Reinstall Node.js and reopen your terminal. On macOS, verify Homebrew is in PATH.
Permission denied during npm install
Use sudo on macOS/Linux, or run PowerShell as Administrator on Windows.
OpenClaw starts but no response
Check that your API key is valid and that the channel token matches the bot you created.
Telegram bot not receiving messages
Send /start to your bot and confirm the token is correct.
Firewall or proxy issues
Try a different network or configure your proxy for npm and OpenClaw.