- name
- openclaw-troubleshoot-cn
- version
- 1.0.0
- description
- OpenClaw 故障排查 - 常见问题解决方案。适合：遇到问题的用户、运维人员。
- metadata
- openclaw
- emoji
- 🔧
- requires
- bins
- []
OpenClaw 故障排查
常见问题快速解决。
安装问题
Node 版本过低
# 检查版本
node -v
# 需要 18+
# 升级方法
brew upgrade node # macOS权限错误
# 修复 npm 权限
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules网络超时
# 使用国内镜像
npm config set registry https://registry.npmmirror.com连接问题
Telegram 连接失败
检查清单：
- Bot Token 是否正确
- Bot 是否已启动（/start）
- 网络是否需要代理
# 测试连接
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMeDiscord 连接失败
检查清单：
- Bot Token 是否正确
- Bot 是否已加入服务器
- intents 是否开启
钉钉连接失败
检查清单：
- Client ID/Secret 是否正确
- 机器人是否已创建
- 回调地址是否配置
模型问题
API Key 无效
# 验证 DeepSeek Key
curl -H "Authorization: Bearer YOUR_KEY" \
https://api.deepseek.com/v1/models余额不足
- DeepSeek：platform.deepseek.com 充值
- Claude：console.anthropic.com 充值
- OpenAI：platform.openai.com 充值
响应超时
# 增加超时时间
openclaw config set timeout 60000运行问题
内存不足
# 增加 Node 内存
export NODE_OPTIONS="--max-old-space-size=4096"端口被占用
# 查找占用进程
lsof -i :3000
# 终止进程
kill -9 <PID>日志查看
# 实时日志
openclaw logs -f
# 日志位置
~/.openclaw/logs/高级问题
数据库损坏
# 备份数据
cp -r ~/.openclaw/data ~/.openclaw/data.bak
# 重建数据库
openclaw db reset配置丢失
# 查看当前配置
openclaw config list
# 重置配置
openclaw config reset需要帮助？
如果以上方案都无法解决：
- 📖 文档：https://docs.openclaw.ai
- 💬 社区：https://discord.gg/clawd
- 🔧 远程支持：
- 基础诊断：¥99 - 深度排查：¥299 - 企业支持：¥999
联系：微信 yang1002378395 或 Telegram @yangster151