Clawdbot AIClawdbot AI
Clawdbot Gateway

Устранение неполадок Clawdbot

Отладка и исправление распространённых проблем AI-ассистента Clawdbot. Узнайте, как диагностировать проблемы подключения, сбои сообщений и ошибки шлюза.

Обзор устранения неполадок Clawdbot

Это руководство поможет вам диагностировать и исправить распространённые проблемы с развёртыванием Clawdbot. Найдите решения для проблем подключения, сбоев сообщений и ошибок шлюза.

Распространённые проблемы

Шлюз не запускается

Симптомы: Шлюз не запускается или сразу завершает работу.

Решения:

  1. Проверить доступность порта:
lsof -i :3010
  1. Проверить конфигурацию:
clawdbot config validate
  1. Проверить логи:
clawdbot gateway logs

Сбой подключения WhatsApp

Симптомы: QR-код не отображается или соединение обрывается.

Решения:

  1. Очистить сессию WhatsApp:
rm -rf ~/.clawdbot/providers/whatsapp/session
  1. Перезапустить шлюз:
clawdbot gateway restart
  1. Проверить сетевое подключение

Сообщения не доставлены

Симптомы: Сообщения отправлены, но не получены.

Решения:

  1. Проверить статус сессии:
clawdbot sessions list
  1. Проверить подключение провайдера:
clawdbot providers status
  1. Проверить ограничения скорости

Агент не отвечает

Симптомы: Агент не генерирует ответы.

Решения:

  1. Проверить статус агента:
clawdbot agents status
  1. Проверить API-ключ:
echo $ANTHROPIC_API_KEY
  1. Проверить доступность модели

Диагностические команды

Статус шлюза

# Проверить здоровье шлюза
clawdbot gateway status

# Просмотреть активные подключения
clawdbot gateway connections

# Показать использование ресурсов
clawdbot gateway stats

Диагностика сессий

# Список всех сессий
clawdbot sessions list

# Просмотр деталей сессии
clawdbot sessions get <session-key>

# Очистить зависшую сессию
clawdbot sessions clear <session-key>

Диагностика провайдеров

# Проверить статус провайдера
clawdbot providers status

# Тестировать подключение провайдера
clawdbot providers test whatsapp

# Переподключить провайдера
clawdbot providers reconnect telegram

Анализ логов

Включить отладочное логирование

clawdbot gateway start --log-level debug

Расположение логов

ЛогРасположение
Шлюз~/.clawdbot/logs/gateway.log
Провайдеры~/.clawdbot/logs/providers/
Агенты~/.clawdbot/logs/agents/

Уровни логов

УровеньОписание
errorТолько ошибки
warnПредупреждения и ошибки
infoОбщая информация
debugПодробная отладочная информация

Коды ошибок

Ошибки подключения

КодОписаниеРешение
ECONNREFUSEDПорт не открытПроверьте, запущен ли шлюз
ETIMEDOUTТайм-аут сетиПроверьте сеть
EAUTHОшибка аутентификацииПроверьте учётные данные

Ошибки провайдеров

КодОписаниеРешение
WA_DISCONNECTEDWhatsApp отключёнПересканируйте QR
TG_INVALID_TOKENНедействительный токен TelegramПроверьте токен
DC_MISSING_INTENTSОтсутствуют intents DiscordВключите intents

Проблемы производительности

Медленные ответы

Причины:

  • Высокий объём сообщений
  • Большой размер контекста
  • Задержка сети

Решения:

  1. Включить потоковую передачу
  2. Уменьшить размер контекста
  3. Проверить сеть

Использование памяти

Проверить память:

clawdbot gateway stats --memory

Уменьшить память:

{
  "gateway": {
    "messageBuffer": 500,
    "maxHistory": 50
  }
}

Процедуры восстановления

Сброс шлюза

# Остановить шлюз
clawdbot gateway stop

# Очистить состояние
clawdbot gateway reset --state

# Перезапустить
clawdbot gateway start

Сброс провайдера

# Отключить провайдера
clawdbot providers disconnect whatsapp

# Очистить данные провайдера
rm -rf ~/.clawdbot/providers/whatsapp

# Перенастроить
clawdbot providers setup whatsapp

Сброс агента

# Очистить сессии агента
clawdbot agents reset main --sessions

# Очистить рабочее пространство агента
clawdbot agents reset main --workspace

Получение помощи

Ресурсы поддержки

Отчёты об ошибках

Включите в отчёты об ошибках:

  • Версию Clawdbot
  • Операционную систему
  • Сообщения об ошибках
  • Шаги воспроизведения

Следующие шаги

Безопасность Clawdbot

Защитите развёртывание AI-ассистента Clawdbot. Узнайте об аутентификации, авторизации, шифровании и лучших практиках безопасности.

Руководство по установке Clawdbot

Полное руководство по установке ИИ-ассистента Clawdbot на macOS, Linux и Windows. Быстрая установка одной командой или варианты ручной настройки.

On this page

Обзор устранения неполадок Clawdbot
Распространённые проблемы
Шлюз не запускается
Сбой подключения WhatsApp
Сообщения не доставлены
Агент не отвечает
Диагностические команды
Статус шлюза
Диагностика сессий
Диагностика провайдеров
Анализ логов
Включить отладочное логирование
Расположение логов
Уровни логов
Коды ошибок
Ошибки подключения
Ошибки провайдеров
Проблемы производительности
Медленные ответы
Использование памяти
Процедуры восстановления
Сброс шлюза
Сброс провайдера
Сброс агента
Получение помощи
Ресурсы поддержки
Отчёты об ошибках
Следующие шаги