🔧 Диагностика проблем OpenClaw

Пошаговые решения для всех типичных проблем

🏠 База знаний 📊 AI Office ⚡ Команды

🔑 "No API key found for provider 'anthropic'"

Симптомы:

📋 Пошаговое решение:

Шаг 1:
Проверить наличие auth-profiles.json
ls -la ~/.openclaw-<name>/agents/main/agent/auth-profiles.json
Шаг 2:
Скопировать auth-profiles.json из рабочего бота
cp ~/.openclaw/agents/main/agent/auth-profiles.json \ ~/.openclaw-<name>/agents/main/agent/
Шаг 3:
Перезапустить бота
systemctl --user restart openclaw-<name>
Шаг 4:
Проверить статус
systemctl --user status openclaw-<name> journalctl --user -u openclaw-<name> --since "2 minutes ago"
Результат: Бот должен начать отвечать на сообщения

👥 Бот не отвечает в группах Telegram

Симптомы:

📋 Пошаговое решение:

Шаг 1:
Проверить groupPolicy в конфигурации
cat ~/.openclaw-<name>/openclaw.json | grep -A 5 -B 5 groupPolicy
Шаг 2:
Изменить groupPolicy на "open"
# Должно быть: "groupPolicy": "open" # НЕ должно быть: "groupPolicy": "allowlist"
Шаг 3:
Перезапустить бота
systemctl --user restart openclaw-<name>
⚠️ Важно: "allowlist" блокирует все группы кроме внесенных в whitelist

🔥 Высокая нагрузка CPU (>100%)

Симптомы:

📋 Пошаговое решение:

Шаг 1:
Найти проблемный процесс
ps aux | grep openclaw | sort -k 3 -nr
Шаг 2:
Остановить проблемный сервис
systemctl --user stop openclaw-<name>
Шаг 3:
Проверить логи на ошибки
journalctl --user -u openclaw-<name> --since "10 minutes ago" | grep -i error
Шаг 4:
Запустить заново и мониторить
systemctl --user start openclaw-<name> watch -n 1 "ps aux | grep openclaw-<name>"
⚠️ Если проблема повторяется, возможно потребуется пересоздать конфигурацию бота

📱 Telegram bot не подключается

Симптомы:

📋 Пошаговое решение:

Шаг 1:
Проверить валидность токена
curl "https://api.telegram.org/bot<TOKEN>/getMe"
Шаг 2:
Проверить токен в конфигурации
cat ~/.openclaw-<name>/openclaw.json | grep botToken
Шаг 3:
Проверить сетевое соединение
ping api.telegram.org curl -I https://api.telegram.org
Шаг 4:
Перезапустить с чистыми логами
systemctl --user restart openclaw-<name> journalctl --user -u openclaw-<name> -f

💾 Заканчивается память или место на диске

📋 Быстрая диагностика:

Проверка памяти:
free -h
Проверка диска:
df -h
Очистка логов:
# Очистка journal логов sudo journalctl --vacuum-time=7d # Очистка временных файлов sudo rm -rf /tmp/openclaw-* rm -f /tmp/*.log
Очистка бэкапов:
/opt/openclaw-watchdog/backup-manager.sh clean

Быстрый чеклист диагностики

🔍 При любой проблеме проверяйте по порядку:

  1. Статус сервиса: systemctl --user status openclaw-<name>
  2. Логи: journalctl --user -u openclaw-<name> --since "10 minutes ago"
  3. Процессы: ps aux | grep openclaw-<name>
  4. Порты: ss -tlnp | grep <port>
  5. Авторизация: ls -la ~/.openclaw-<name>/agents/main/agent/
  6. Конфигурация: cat ~/.openclaw-<name>/openclaw.json
  7. Ресурсы: free -h && df -h
💡 Совет: Используйте автоматический скрипт диагностики:
/opt/openclaw-watchdog/bot-activity.sh <bot-name>
💡 Не нашли решение? Обратитесь к справочнику команд или в базу знаний