Troubleshooting

Having issues with your ClawBox? This guide covers common problems and their solutions.

Quick Diagnostics

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

Common Issues

🔴

ClawBox Won't Boot

critical

Symptoms:

  • •No lights or activity
  • •Status LED stays off
  • •No response to power button

Solutions:

  1. 1Verify the power adapter is connected securely
  2. 2Try a different power outlet
  3. 3Check if the power LED on the adapter is lit
  4. 4Contact support if the issue persists
🌐

No Network Connection

high

Symptoms:

  • •Can't access clawbox.local
  • •Messages not being sent
  • •Status shows offline

Solutions:

  1. 1Check Ethernet cable connection (try reseating)
  2. 2Verify your router has available DHCP addresses
  3. 3Try connecting via Wi-Fi instead
  4. 4Check if other devices can access the network
🐢

Slow AI Responses

medium

Symptoms:

  • •Long delays before responses
  • •Timeouts on complex queries
  • •System feels sluggish

Solutions:

  1. 1Ensure adequate ventilation (avoid enclosed spaces)
  2. 2Check if other processes are running (top command)
  3. 3Restart the AI service: openclaw restart
  4. 4Consider using a smaller AI model for faster responses
💬

Messages Not Received

medium

Symptoms:

  • •Bot appears online but doesn't respond
  • •Messages show as sent but no reply
  • •Works on some platforms but not others

Solutions:

  1. 1Verify the platform is properly paired (check settings)
  2. 2Restart the messaging service: openclaw restart messaging
  3. 3Re-authorize the bot on the affected platform
  4. 4Check webhook URLs in platform developer settings
🌡️

Overheating

high

Symptoms:

  • •Fan running at full speed constantly
  • •Thermal throttling warnings in logs
  • •Device feels hot to touch

Solutions:

  1. 1Move to a well-ventilated area
  2. 2Clean dust from vents and fan
  3. 3Reduce ambient temperature
  4. 4Check for blocked airflow around the device

Viewing Logs

Logs are essential for diagnosing issues. Use these commands to access different log types.

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

Reset Options

⚠️

Warning

Some reset options will erase your data. Always back up important configurations first.

Reset Types

openclaw reset --softRestarts services without losing data
openclaw reset --hardClears cache and restarts all services
openclaw reset --factoryErases all data and restores to factory defaults
# 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 Status Indicators

Solid Green

System is running normally

Blinking Green

Processing a request or booting up

Solid Orange

System is starting up or updating

Blinking Orange

Warning state — check logs for details

Solid Red

Error state — intervention required

Getting Support

If you can't resolve the issue, our support team is ready to help.

Before Contacting Support:

  • □Note the exact error message or behavior
  • □Check the LED status indicator
  • □Try the relevant troubleshooting steps above
  • □Export logs: openclaw logs --export

Include in Your Request:

  • ✓ClawBox serial number (on bottom label)
  • ✓Description of the issue
  • ✓Steps to reproduce
  • ✓Log export file (if available)
🤖Telegram Support💬Discord Community✉️Email Support