跳到正文
🔥 TROUBLESHOOTING

OpenClaw 常见问题排查

遇到报错别慌——下面按问题类型分类，找到你的症状，照解法操作就行。
还是搞不定？¥99 帮你远程解决 →

🔧 安装问题 6 个问题 🔥 运行问题 1 个问题 ⚡ 技能问题 1 个问题 📱 渠道问题 1 个问题 🤖 模型问题 2 个问题

🔧 安装问题

npm 报错、权限问题、Docker 启动失败

Docker Compose 启动失败：容器反复重启或退出
LinuxDocker
▸
macOS M1/M2/M3 安装报错：sharp 预编译二进制不兼容
macOS
▸
Node.js 版本太低导致语法错误：SyntaxError Unexpected token
macOSWindowsLinux
▸
npm 安装超时：国内网络无法下载 OpenClaw
macOSWindowsLinux
▸
OpenClaw 安装失败：npm ERR!、权限不足或网络超时
macOSWindowsLinux
▸
WSL2 安装 OpenClaw 权限报错 EACCES
Windows
▸

🔥 运行问题

Gateway 崩溃、端口占用、内存溢出

Gateway 启动失败：端口 18789 被占用 EADDRINUSE
macOSWindowsLinux
▸

⚡ 技能问题

技能安装失败、配置报错、不生效

技能安装失败：clawhub install 报错或超时
macOSWindowsLinux
▸

📱 渠道问题

Telegram/微信/飞书连不上

Telegram Bot 无回复：消息发出去但没有响应
macOSWindowsLinuxDocker
▸

🤖 模型问题

API Key 无效、超时、模型切换

API Key 无效或过期：模型无法连接
macOSWindowsLinuxDocker
▸
模型回复超时：发送消息后长时间无响应
macOSWindowsLinuxDocker
▸

还是搞不定？

¥99 远程帮你解决一切部署问题，搞不定全额退款。

💰 了解付费服务 📖 查看安装教程