---

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 连接失败

检查清单：

1. Bot Token 是否正确
2. Bot 是否已启动（/start）
3. 网络是否需要代理

# 测试连接
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

Discord 连接失败

检查清单：

1. Bot Token 是否正确
2. Bot 是否已加入服务器
3. intents 是否开启

钉钉连接失败

检查清单：

1. Client ID/Secret 是否正确
2. 机器人是否已创建
3. 回调地址是否配置

模型问题

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