🔧

Troubleshooting Guide

Lösungen für häufige Probleme bei der OpenClaw-Installation und -Nutzung.

Container startet nicht

⚠️

Problem: docker compose up zeigt Fehler oder Container restarten ständig. 

docker compose logs openclaw
docker compose ps
docker compose down
docker compose up -d
free -h
docker system prune -a

Datenbankverbindung fehlgeschlagen

docker compose logs db
docker compose exec db psql -U postgres -c "SELECT 1;"
docker compose down
docker volume rm openclaw_postgres_data
docker compose up -d

API-Fehler (OpenAI/Anthropic)

Häufige Ursachen:

  • • 401 Unauthorized: API-Key ungültig oder abgelaufen
  • • 429 Rate Limit: Zu viele Anfragen
  • • 500 Server Error: Problem beim API-Anbieter
  • • Timeout: Modell braucht zu lange
docker compose exec openclaw printenv OPENAI_API_KEY
cat .env
docker compose down
docker compose up -d

SSL/HTTPS Probleme

sudo journalctl -u certbot
sudo certbot renew --force-renewal
sudo nginx -t
sudo systemctl reload nginx

Langsame Performance

htop
docker stats
docker compose logs --tail=100 openclaw
docker compose exec openclaw npm run cache:clear
docker compose restart

Allgemeine Debug-Befehle

  • docker compose logs -f Live-Logs anzeigen
  • docker compose exec openclaw sh Shell im Container öffnen
  • docker compose restart Container neustarten
  • docker system df Speicherverbrauch anzeigen

Weiterführende Links