OpenClaw Error Dictionary

Find fixes based on the exact error message you see in your terminal.

💡 How to use: Copy the error message from your terminal, then use Ctrl+F to search this page, or browse by category below.

---

🔧 Installation & Build Errors

These errors occur during npm install or when building native modules.

• gyp: No Xcode or CLT version detected — Missing build tools on Mac
• EACCES: permission denied — File permission issues on Mac/Linux
• npm ERR! code ERESOLVE — Dependency version conflicts

---

🔌 Runtime Errors

These errors occur when starting or running OpenClaw.

• EADDRINUSE: address already in use :::3000 — Another app is using Port 3000
• Cannot find module 'sharp' — Native module failed to install

---

🔐 API & Authentication Errors

These errors occur when connecting to AI providers (OpenAI, Anthropic).

• 401 Unauthorized / Invalid API Key — API key is wrong or missing
• 429 Too Many Requests — API quota or credits exhausted

---

🪟 Windows (WSL2) Specific

Issues specific to running OpenClaw on Windows with WSL2.

• Can't access localhost:3000 — WSL2 network mapping issues

---

📚 Still Need Help?

• Common Errors Summary — Quick reference for all errors
• Sandbox Setup Guide — Run OpenClaw safely in isolation

---

🔗 Note: This Error Dictionary is maintained by the OpenClaw Help community. For official support, check the OpenClaw GitHub Issues.