agentsclimarketplace

Agent doctor

Skill AlekseiUL/openclaw-superagent/skills/agent-doctor

Complete AI Agent System for OpenClaw — memory, self-healing, self-improvement, voice, automation

Install
npx -y skills add AlekseiUL/openclaw-superagent --skill agent-doctor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Самодиагностика и автолечение OpenClaw. Проверка gateway, WAL, памяти, кронов, токенов. Автоматическое исправление типичных проблем.

SKILL.md

16.2 KB, as published. Nobody here has run it

🏥 Agent Doctor - Самодиагностика OpenClaw

Версия: 1.0.0 (Public Release) Создано: 2026-03-06 Лицензия: MIT

Описание

Комплексная диагностика всех систем OpenClaw агента. Проверяет память, кроны, конфиг, файлы, gateway, систему и безопасность. Выявляет проблемы и предлагает конкретные решения.

ВАЖНО: Скилл ТОЛЬКО диагностирует. Изменения применяются ТОЛЬКО после вашего явного подтверждения.

Установка

  1. Скопируйте этот файл в skills/agent-doctor/SKILL.md
  2. Агент автоматически подхватит скилл при следующем запуске

Триггеры

Когда говорить агенту для запуска:

  • "продиагностируй себя"
  • "самодиагностика"
  • "проверь систему"
  • "что с тобой не так"
  • "диагностика агента"
  • "self-check"
  • "health check"

Как работает

Алгоритм

  1. Агент запускает проверку всех систем
  2. Собирает результаты по 7 категориям
  3. Формирует отчет с найденными проблемами
  4. Предлагает конкретные решения
  5. Применяет фиксы ТОЛЬКО после вашего "ок"

Что проверяется

🧠 Память

  1. SQLite база данных

    • Существует ли ~/.openclaw/memory/*.sqlite?
    • Размер базы адекватный?

  2. WAL mode (критично!)

    • Проверка: sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode;"
    • Должно быть: wal (НЕ delete!)
    • Почему важно: без WAL агент видит устаревшие данные

  3. Количество записей

    • Сколько чанков в базе?
    • Есть ли записи из файлов (memory) и сессий (sessions)?

  4. Конфиг memorySearch

    • enabled = true?
    • embeddingProvider настроен?
    • similarityThreshold указан?

  5. Embedding провайдер

    • OpenAI / Gemini / Anthropic
    • API ключ настроен?

  6. Тестовый поиск

    • memory_search возвращает результаты?
    • Нет ошибок при запросе?

  7. Файлы памяти

    • MEMORY.md существует и не пустой?
    • Структура папок: core/, decisions/, projects/
    • Последний daily note (memory/YYYY-MM-DD.md) свежий?

⏰ Кроны

  1. Список всех кронов

    • Команда: openclaw cron list

  2. Статус кронов

    • Есть ли отключенные (enabled: false)?
    • Когда последний запуск?

  3. Ошибки

    • Падают ли кроны при запуске?
    • Количество провалов (failureCount)

⚙️ Конфиг

  1. Валидность openclaw.json

    • Проверка: jq empty ~/.openclaw/openclaw.json
    • JSON корректный?

  2. Модель

    • defaultModel настроена?
    • Провайдер доступен?

  3. Каналы

    • Telegram или Discord подключены?

  4. Секция memorySearch

    • Все нужные поля присутствуют?

  5. Плагины

    • memory-core включен?
    • Критично: после обновления OpenClaw этот плагин может отключиться!

  6. Auth profiles

    • Какие провайдеры настроены?
    • API ключи на месте?

📁 Файлы агента

  1. Основные файлы

    • SOUL.md / IDENTITY.md - существуют?
    • AGENTS.md - есть?
    • HEARTBEAT.md - есть?
    • USER.md - есть?

  2. Skills

    • Сколько скиллов установлено?
    • Все ли SKILL.md читаются?

🔧 Gateway

  1. Статус

    • Команда: openclaw status
    • Gateway запущен?

  2. Аптайм

    • Как давно работает без перезагрузки?

  3. Ошибки в логах

    • Последние 5 ошибок из ~/.openclaw/logs/gateway.log

  4. Порт

    • Порт свободен или занят другим процессом?
    • По умолчанию: 3000

💾 Система

  1. ОС

    • macOS / Linux / Windows?
    • Архитектура: x86_64 / arm64?

  2. Node.js

    • Версия >= 20.0.0?
    • Команда: node --version

  3. Python

    • Версия >= 3.11?
    • Команда: python3 --version

  4. Свободное место

    • Минимум 1GB рекомендуется
    • Команда: df -h ~

  5. Версия OpenClaw

    • Актуальная ли?
    • Команда: openclaw --version

🛡️ Безопасность

  1. Gateway bind

    • Значение: localhost / 127.0.0.1 (хорошо)
    • Значение: 0.0.0.0 (опасно! доступ из интернета)

  2. Auth mode

    • token или stronger?
    • Защита настроена?

  3. API ключи

    • Не лежат ли в открытом виде в файлах памяти?
    • Проверка: grep -r "sk-" memory/

Формат отчета

После проверки вы получите отчет в формате:

🏥 ДИАГНОСТИКА АГЕНТА - 2026-03-06 14:30

🧠 Память: ✅ OK / ⚠️ 2 проблемы / ❌ Не работает
⏰ Кроны: ✅ OK / ⚠️ 1 отключен
⚙️ Конфиг: ✅ OK / ⚠️ Неполный
📁 Файлы: ✅ OK / ❌ Нет SOUL.md
🔧 Gateway: ✅ OK / ⚠️ Ошибки в логах
💾 Система: ✅ OK / ⚠️ Мало места
🛡️ Безопасность: ✅ OK / ❌ Публичный доступ

━━━━━━━━━━━━━━━━━━━

📋 ДЕТАЛИ ПРОБЛЕМ:

1. ❌ WAL mode отключен
   📝 Что не так: SQLite использует journal_mode=delete
   💡 Решение: sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode=WAL;"
   ⚡ Риск: низкий

2. ⚠️ Embedding провайдер не настроен
   📝 Что не так: нет API ключа для embeddings
   💡 Решение: openclaw auth add openai
   ⚡ Риск: низкий

━━━━━━━━━━━━━━━━━━━

Исправить проблемы? (да/нет)

Применение фиксов

Если агент нашел проблемы:

  1. Он спросит: "Исправить? (да/нет)"
  2. Вы можете сказать "да" (все фиксы) или указать номера: "1, 3"
  3. Агент объяснит что будет делать
  4. Предупредит о рисках
  5. Применит фикс ТОЛЬКО после вашего подтверждения
  6. Проверит результат
  7. Отчитается

Типовые проблемы и решения

❌ WAL mode отключен

Почему важно: SQLite в режиме delete показывает устаревшие данные. Агент не видит новые записи в памяти.

Симптомы:

  • "Не помню что мы обсуждали 5 минут назад"
  • memory_search не находит свежие записи

Решение:

sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode=WAL;"

Риск: Низкий. Это безопасная операция.

После: Перезапустить gateway

⚠️ memorySearch отключен

Симптомы:

  • memory_search не работает
  • Агент не использует долгосрочную память

Решение:

jq '.memorySearch.enabled = true' ~/.openclaw/openclaw.json > /tmp/config.json && mv /tmp/config.json ~/.openclaw/openclaw.json

Риск: Средний. Проверьте конфиг после изменения.

После: Перезапустить gateway

❌ Нет embedding провайдера

Симптомы:

  • memorySearch включен, но не работает
  • Ошибки "no embedding provider"

Решение:

OpenAI (рекомендуется):

openclaw auth add openai

Gemini:

openclaw auth add gemini

Риск: Низкий.

❌ memory-core плагин отключен

Почему возникает: После обновления OpenClaw плагин может отключиться автоматически.

Симптомы:

  • Память перестала работать после обновления

Решение:

jq '.plugins = [.plugins[] | if .name == "memory-core" then .enabled = true else . end]' ~/.openclaw/openclaw.json > /tmp/config.json && mv /tmp/config.json ~/.openclaw/openclaw.json

Риск: Средний. Проверьте конфиг.

После: Перезапустить gateway

⚠️ Старая версия Node.js

Требование: Node.js >= 20.0.0

Симптомы:

  • Gateway не запускается
  • Ошибки зависимостей

Решение:

macOS (Homebrew):

brew upgrade node

Linux (nvm):

nvm install 20
nvm use 20

Windows (nvm-windows):

nvm install 20
nvm use 20

Риск: Средний. Может потребовать переустановку OpenClaw.

⚠️ Диск заполнен

Симптомы:

  • Ошибки записи
  • Кроны не работают
  • База данных не растет

Решение:

Очистить старые логи:

rm -rf ~/.openclaw/logs/*.log.old

Очистить кеш:

rm -rf ~/.openclaw/cache/*

Риск: Низкий. Логи и кеш можно удалять безопасно.

❌ Gateway доступен из интернета

Почему опасно: Если bind = 0.0.0.0, ваш агент доступен из интернета. Любой может подключиться.

Решение:

jq '.gateway.bind = "127.0.0.1"' ~/.openclaw/openclaw.json > /tmp/config.json && mv /tmp/config.json ~/.openclaw/openclaw.json

Риск: Низкий. После изменения gateway будет доступен только с вашего компьютера.

После: Перезапустить gateway

⚠️ Кроны падают

Симптомы:

  • failureCount > 0
  • lastError не пустой

Что проверить:

  1. Модель для крона настроена? (должна быть full path, например anthropic/claude-sonnet-4-6)
  2. API ключ провайдера на месте?
  3. Нет ли ошибок в логах крона?

Решение:

openclaw cron list
openclaw cron logs <cron-name>

Изучить ошибки и исправить причину.

Когда запускать диагностику

Рекомендуется:

  • ✅ После обновления OpenClaw (обязательно!)
  • ✅ При странном поведении агента
  • ✅ Раз в неделю для профилактики
  • ✅ После изменения конфига
  • ✅ Если агент "забывает" недавние разговоры
  • ✅ Перед важной работой (чтобы убедиться что все в порядке)

Важные команды

Перезапуск Gateway

НЕ делайте так из сессии агента:

openclaw gateway restart  # Убьет вашу сессию!

Правильно:

macOS (launchd):

launchctl kickstart -k gui/$(id -u)/com.openclaw.gateway

Linux (systemd):

systemctl --user restart openclaw-gateway

Или вручную:

openclaw gateway stop
openclaw gateway start

Проверка конфига

# Валидность JSON
jq empty ~/.openclaw/openclaw.json

# Посмотреть секцию
jq '.memorySearch' ~/.openclaw/openclaw.json

# Изменить значение
jq '.memorySearch.enabled = true' ~/.openclaw/openclaw.json > /tmp/config.json && mv /tmp/config.json ~/.openclaw/openclaw.json

Проверка базы данных

# Размер
ls -lh ~/.openclaw/memory/*.sqlite

# WAL mode
sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode;"

# Количество записей
sqlite3 ~/.openclaw/memory/main.sqlite "SELECT COUNT(*) FROM memory_chunks;"

# По источникам
sqlite3 ~/.openclaw/memory/main.sqlite "SELECT source, COUNT(*) FROM memory_chunks GROUP BY source;"

Финальный чеклист

После диагностики убедитесь:

  • WAL mode = wal (НЕ delete!)
  • memorySearch.enabled = true
  • Embedding provider настроен (OpenAI/Gemini)
  • API ключ провайдера на месте
  • memory-core plugin включен
  • Основные файлы существуют (SOUL.md, IDENTITY.md и т.д.)
  • Gateway работает (openclaw status)
  • Кроны не падают (failureCount = 0)
  • Gateway bind НЕ 0.0.0.0
  • Node.js >= 20
  • Свободное место > 1GB

FAQ

Q: Можно ли запускать диагностику автоматически?

A: Да! Создайте крон который запускается раз в день:

openclaw cron add daily-health-check \
  --schedule "0 8 * * *" \
  --model "anthropic/claude-sonnet-4-6" \
  --payload '{"kind":"agentTurn","message":"Запусти диагностику agent-doctor и отправь краткий отчет"}'

Q: Какие проблемы самые критичные?

A:

  1. WAL mode отключен - агент не видит новые записи
  2. memory-core отключен - память не работает вообще
  3. Gateway bind = 0.0.0.0 - опасность из интернета

Q: Агент может сломать систему при автофиксе?

A: Нет. Скилл применяет ТОЛЬКО безопасные операции и только после вашего подтверждения. Никаких rm -rf, никаких изменений без проверки.

Q: Как часто бывают проблемы после обновления?

A: Часто! Особенно с memory-core плагином (отключается) и WAL mode (сбрасывается). ВСЕГДА запускайте диагностику после обновления.

Q: Можно ли добавить свои проверки?

A: Да! Просто допишите в SKILL.md свои блоки проверок. Агент умный, поймет структуру.

Благодарности

Этот скилл создан на основе реальных проблем пользователей OpenClaw из:

  • GitHub Issues
  • Reddit /r/OpenClaw
  • Discord сообщества

Лицензия

MIT License - свободно используйте, модифицируйте, распространяйте.

Поддержка

Если скилл помог - поделитесь в сообществе! Если нашли баг или есть идея - откройте issue на GitHub.

Версия: 1.0.0 Дата: 2026-03-06

🏥 Здоровый агент - продуктивный агент!

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.