故障排除

ClawBox 遇到问题？本指南涵盖常见问题及其解决方案。

快速诊断

Terminal
# SSH into your ClawBox (user: clawbox, password: clawbox)
# Check system status
ssh clawbox@clawbox.local 'openclaw status'

# View recent logs
ssh clawbox@clawbox.local 'openclaw logs --tail 50'

# Check service health
ssh clawbox@clawbox.local 'openclaw health'

# Test network connectivity
ping clawbox.local

常见问题

🔴

ClawBox 无法启动

critical

症状：

  • •没有灯光或活动
  • •状态 LED 保持关闭
  • •电源按钮无响应

解决方案：

  1. 1确认电源适配器已牢固连接
  2. 2尝试使用其他电源插座
  3. 3检查适配器上的电源 LED 是否亮起
  4. 4如果问题持续，请联系支持
🌐

无网络连接

high

症状：

  • •无法访问 clawbox.local
  • •消息无法发送
  • •状态显示离线

解决方案：

  1. 1检查以太网线连接（尝试重新插拔）
  2. 2验证您的路由器是否有可用的 DHCP 地址
  3. 3尝试改用 Wi-Fi 连接
  4. 4检查其他设备是否可以访问网络
🐢

AI 响应缓慢

medium

症状：

  • •响应前等待时间长
  • •复杂查询超时
  • •系统感觉迟钝

解决方案：

  1. 1确保充分通风（避免封闭空间）
  2. 2检查是否有其他进程在运行（top 命令）
  3. 3重启 AI 服务：openclaw restart
  4. 4考虑使用较小的 AI 模型以获得更快的响应
💬

消息未收到

medium

症状：

  • •机器人显示在线但不响应
  • •消息显示已发送但无回复
  • •在某些平台可用但其他平台不可用

解决方案：

  1. 1验证平台是否正确配对（检查设置）
  2. 2重启消息服务：openclaw restart messaging
  3. 3在受影响的平台上重新授权机器人
  4. 4检查平台开发者设置中的 Webhook URL
🌡️

过热

high

症状：

  • •风扇持续全速运转
  • •日志中出现热节流警告
  • •设备触摸感觉烫手

解决方案：

  1. 1移至通风良好的区域
  2. 2清洁通风口和风扇上的灰尘
  3. 3降低环境温度
  4. 4检查设备周围是否有气流阻塞

查看日志

日志对于诊断问题至关重要。使用这些命令访问不同类型的日志。

Terminal
# View all logs
openclaw logs

# View specific service logs
openclaw logs --service chat
openclaw logs --service browser
openclaw logs --service voice

# Follow logs in real-time
openclaw logs -f

# Filter by log level
openclaw logs --level error

# Export logs for support
openclaw logs --export support-bundle.zip

重置选项

⚠️

警告

某些重置选项会清除您的数据。请务必先备份重要配置。

重置类型

openclaw reset --soft重启服务而不丢失数据
openclaw reset --hard清除缓存并重启所有服务
openclaw reset --factory清除所有数据并恢复出厂默认设置
# Soft reset (restart services)
openclaw reset --soft

# Hard reset (clear cache, restart)
openclaw reset --hard

# Factory reset (WARNING: erases all data)
openclaw reset --factory --confirm

LED 状态指示灯

常亮绿色

系统正常运行

闪烁绿色

正在处理请求或启动中

常亮橙色

系统正在启动或更新

闪烁橙色

警告状态 — 查看日志了解详情

常亮红色

错误状态 — 需要干预

获取支持

如果您无法解决问题，我们的支持团队随时准备提供帮助。

联系支持前：

  • □记录确切的错误消息或行为
  • □检查 LED 状态指示灯
  • □尝试上述相关的故障排除步骤
  • □导出日志：openclaw logs --export

请求中应包含：

  • ✓ClawBox 序列号（在底部标签上）
  • ✓问题描述
  • ✓复现步骤
  • ✓日志导出文件（如有）
🤖Telegram 支持💬Discord 社区✉️邮件支持