agent-doctor
Самодиагностика и автолечение OpenClaw. Проверка gateway, WAL, памяти, кронов, токенов. Автоматическое исправление типичных проблем.
Install
npx skills add https://github.com/AlekseiUL/openclaw-superagent/tree/main/skills/agent-doctor
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alekseiul-openclaw-superagent@llmmart
git clone https://github.com/AlekseiUL/openclaw-superagent.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alekseiul/openclaw-superagent collection as a plugin from our marketplace. Git is the plain clone.
README
🏥 Agent Doctor - OpenClaw Self-Diagnostic Skill
Комплексная самодиагностика для OpenClaw агента. Проверяет все критичные системы и предлагает конкретные решения.
🎯 Что это?
Agent Doctor - скилл для OpenClaw, который:
- ✅ Проверяет 7 категорий систем (память, кроны, конфиг, файлы, gateway, система, безопасность)
- 🔍 Выявляет 28+ типовых проблем
- 💡 Предлагает конкретные решения с оценкой рисков
- 🛡️ Работает безопасно - только чтение, фиксы после подтверждения
- 🌍 Поддерживает все платформы (macOS, Linux, Windows)
🚀 Быстрый старт
# 1. Установить скилл
cd ~/your-workspace/skills
git clone <repo-url>/agent-doctor.git
# 2. Перезапустить gateway (опционально)
openclaw gateway restart
# 3. Сказать агенту:
"продиагностируй себя"
Готово! Агент проверит все системы и выдаст отчет.
📊 Что проверяется?
🧠 Память
- SQLite база данных и WAL mode
- memorySearch настройки
- Embedding провайдер
- Файлы памяти (MEMORY.md, daily notes)
- Структура папок
⏰ Кроны
- Статус всех кронов
- Последние запуски
- Ошибки и failureCount
⚙️ Конфиг
- Валидность openclaw.json
- Модели и провайдеры
- Плагины (особенно memory-core!)
- Auth profiles
📁 Файлы агента
- SOUL.md, IDENTITY.md
- AGENTS.md, HEARTBEAT.md, USER.md
- Skills и их доступность
🔧 Gateway
- Статус и аптайм
- Ошибки в логах
- Порты
💾 Система
- Node.js >= 20
- Python >= 3.11
- Свободное место на диске
- Версия OpenClaw
🛡️ Безопасность
- Gateway bind (не 0.0.0.0!)
- Auth mode
- Утечки API ключей
💡 Примеры использования
Базовая диагностика
Вы: продиагностируй себя
Агент: 🏥 ДИАГНОСТИКА АГЕНТА — 2026-03-06 14:30
🧠 Память: ✅ OK
⏰ Кроны: ✅ OK
⚙️ Конфиг: ⚠️ 1 проблема
📁 Файлы: ✅ OK
🔧 Gateway: ✅ OK
💾 Система: ✅ OK
🛡️ Безопасность: ✅ OK
━━━━━━━━━━━━━━━━━━━
📋 ДЕТАЛИ ПРОБЛЕМ:
1. ⚠️ memory-core отключен
📝 Что не так: Плагин отключился после обновления
💡 Решение: jq '.plugins[...] | .enabled = true' ...
⚡ Риск: средний
━━━━━━━━━━━━━━━━━━━
Исправить? (да/нет)
Автоматическая проверка
# Создать крон для ежедневной диагностики
openclaw cron add daily-health \
--schedule "0 8 * * *" \
--model "anthropic/claude-sonnet-4-6" \
--payload '{"kind":"agentTurn","message":"Запусти agent-doctor..."}'
Bash-скрипт (без агента)
bash auto-diagnostic.sh
# Быстрая проверка из терминала или CI/CD
📚 Документация
| Файл | Описание |
|---|---|
| SKILL.md | Рабочая версия (для личного агента) |
| EXAMPLES.md | 10 сценариев использования |
| PROBLEMS_DATABASE.md | 28 проблем и решений |
| INSTALL.md | Инструкция по установке |
🔥 Когда использовать?
- ✅ После обновления OpenClaw (обязательно!)
- ✅ При странном поведении агента
- ✅ Раз в неделю для профилактики
- ✅ Перед важной работой (стрим, презентация)
- ✅ Если агент "забывает" разговоры
⚠️ Частые проблемы
Проблема #1: WAL mode отключен
Симптом: Агент не видит новые записи
Решение:
sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode=WAL;"
Проблема #2: memory-core отключен
Симптом: Память не работает после обновления
Решение: Агент исправит автоматически (после подтверждения)
Проблема #3: 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
🛡️ Безопасность
- ✅ Скилл ТОЛЬКО читает данные
- ✅ Все фиксы требуют подтверждения
- ✅ Оценка рисков для каждого изменения
- ✅ Никаких автоматических изменений конфига
- ✅ Открытый исходный код (MIT License)
🤝 Контрибьюция
Нашли баг? Есть идея? Открывайте issue или PR!
Что приветствуется:
- Новые проверки
- Решения проблем
- Улучшения документации
- Примеры использования
📊 Статистика
- 28 типовых проблем в базе
- 7 категорий проверок
- 10 примеров использования
- 3000+ строк документации
- 0 внешних зависимостей
🙏 Благодарности
Created based on real OpenClaw user issues collected from GitHub, Reddit, and community feedback.
Спасибо:
- OpenClaw community за баг-репорты
- Подписчикам AI ОПЕРАЦИОНКИ за фидбек
- Алексею Ульянову (@Sprut_AI) за идею и спецификацию
📄 Лицензия
MIT License - свободно используйте, модифицируйте, распространяйте.
См. LICENSE для деталей.
🔗 Ссылки
Версия: 1.0.0
Дата: 2026-03-06
Author: Aleksei Ulianov
🏥 Здоровый агент - продуктивный агент!
Skill manifest
🏥 Agent Doctor - Самодиагностика OpenClaw
Версия: 1.0.0 (Public Release) Создано: 2026-03-06 Лицензия: MIT
Описание
Комплексная диагностика всех систем OpenClaw агента. Проверяет память, кроны, конфиг, файлы, gateway, систему и безопасность. Выявляет проблемы и предлагает конкретные решения.
ВАЖНО: Скилл ТОЛЬКО диагностирует. Изменения применяются ТОЛЬКО после вашего явного подтверждения.
Установка
- Скопируйте этот файл в
skills/agent-doctor/SKILL.md - Агент автоматически подхватит скилл при следующем запуске
Триггеры
Когда говорить агенту для запуска:
- "продиагностируй себя"
- "самодиагностика"
- "проверь систему"
- "что с тобой не так"
- "диагностика агента"
- "self-check"
- "health check"
Как работает
Алгоритм
- Агент запускает проверку всех систем
- Собирает результаты по 7 категориям
- Формирует отчет с найденными проблемами
- Предлагает конкретные решения
- Применяет фиксы ТОЛЬКО после вашего "ок"
Что проверяется
🧠 Память
SQLite база данных
- Существует ли ~/.openclaw/memory/*.sqlite?
- Размер базы адекватный?
WAL mode (критично!)
- Проверка:
sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode;" - Должно быть:
wal(НЕdelete!) - Почему важно: без WAL агент видит устаревшие данные
- Проверка:
Количество записей
- Сколько чанков в базе?
- Есть ли записи из файлов (memory) и сессий (sessions)?
Конфиг memorySearch
- enabled = true?
- embeddingProvider настроен?
- similarityThreshold указан?
Embedding провайдер
- OpenAI / Gemini / Anthropic
- API ключ настроен?
Тестовый поиск
- memory_search возвращает результаты?
- Нет ошибок при запросе?
Файлы памяти
- MEMORY.md существует и не пустой?
- Структура папок: core/, decisions/, projects/
- Последний daily note (memory/YYYY-MM-DD.md) свежий?
⏰ Кроны
Список всех кронов
- Команда:
openclaw cron list
- Команда:
Статус кронов
- Есть ли отключенные (enabled: false)?
- Когда последний запуск?
Ошибки
- Падают ли кроны при запуске?
- Количество провалов (failureCount)
⚙️ Конфиг
Валидность openclaw.json
- Проверка:
jq empty ~/.openclaw/openclaw.json - JSON корректный?
- Проверка:
Модель
- defaultModel настроена?
- Провайдер доступен?
Каналы
- Telegram или Discord подключены?
Секция memorySearch
- Все нужные поля присутствуют?
Плагины
- memory-core включен?
- Критично: после обновления OpenClaw этот плагин может отключиться!
Auth profiles
- Какие провайдеры настроены?
- API ключи на месте?
📁 Файлы агента
Основные файлы
- SOUL.md / IDENTITY.md - существуют?
- AGENTS.md - есть?
- HEARTBEAT.md - есть?
- USER.md - есть?
Skills
- Сколько скиллов установлено?
- Все ли SKILL.md читаются?
🔧 Gateway
Статус
- Команда:
openclaw status - Gateway запущен?
- Команда:
Аптайм
- Как давно работает без перезагрузки?
Ошибки в логах
- Последние 5 ошибок из ~/.openclaw/logs/gateway.log
Порт
- Порт свободен или занят другим процессом?
- По умолчанию: 3000
💾 Система
ОС
- macOS / Linux / Windows?
- Архитектура: x86_64 / arm64?
Node.js
- Версия >= 20.0.0?
- Команда:
node --version
Python
- Версия >= 3.11?
- Команда:
python3 --version
Свободное место
- Минимум 1GB рекомендуется
- Команда:
df -h ~
Версия OpenClaw
- Актуальная ли?
- Команда:
openclaw --version
🛡️ Безопасность
Gateway bind
- Значение: localhost / 127.0.0.1 (хорошо)
- Значение: 0.0.0.0 (опасно! доступ из интернета)
Auth mode
- token или stronger?
- Защита настроена?
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, 3"
- Агент объяснит что будет делать
- Предупредит о рисках
- Применит фикс ТОЛЬКО после вашего подтверждения
- Проверит результат
- Отчитается
Типовые проблемы и решения
❌ 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 не пустой
Что проверить:
- Модель для крона настроена? (должна быть full path, например
anthropic/claude-sonnet-4-6) - API ключ провайдера на месте?
- Нет ли ошибок в логах крона?
Решение:
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:
- WAL mode отключен - агент не видит новые записи
- memory-core отключен - память не работает вообще
- 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
🏥 Здоровый агент - продуктивный агент!
Files (openclaw-superagent)
-
auto-diagnostic.sh 4.4 KB
Loading… -
EXAMPLES.md 9.1 KB
Loading… -
INSTALL.md 7.3 KB
Loading… -
LICENSE 1.1 KB · in bundle
-
PROBLEMS_DATABASE.md 19.2 KB
Loading… -
README.md 7.2 KB
# 🏥 Agent Doctor - OpenClaw Self-Diagnostic Skill > Комплексная самодиагностика для OpenClaw агента. Проверяет все критичные системы и предлагает конкретные решения. [](https://opensource.org/licenses/MIT) [](https://github.com/openclaw/openclaw) --- ## 🎯 Что это? **Agent Doctor** - скилл для OpenClaw, который: - ✅ Проверяет 7 категорий систем (память, кроны, конфиг, файлы, gateway, система, безопасность) - 🔍 Выявляет 28+ типовых проблем - 💡 Предлагает конкретные решения с оценкой рисков - 🛡️ Работает безопасно - только чтение, фиксы после подтверждения - 🌍 Поддерживает все платформы (macOS, Linux, Windows) ## 🚀 Быстрый старт ```bash # 1. Установить скилл cd ~/your-workspace/skills git clone <repo-url>/agent-doctor.git # 2. Перезапустить gateway (опционально) openclaw gateway restart # 3. Сказать агенту: "продиагностируй себя" ``` Готово! Агент проверит все системы и выдаст отчет. ## 📊 Что проверяется? ### 🧠 Память - SQLite база данных и WAL mode - memorySearch настройки - Embedding провайдер - Файлы памяти (MEMORY.md, daily notes) - Структура папок ### ⏰ Кроны - Статус всех кронов - Последние запуски - Ошибки и failureCount ### ⚙️ Конфиг - Валидность openclaw.json - Модели и провайдеры - Плагины (особенно memory-core!) - Auth profiles ### 📁 Файлы агента - SOUL.md, IDENTITY.md - AGENTS.md, HEARTBEAT.md, USER.md - Skills и их доступность ### 🔧 Gateway - Статус и аптайм - Ошибки в логах - Порты ### 💾 Система - Node.js >= 20 - Python >= 3.11 - Свободное место на диске - Версия OpenClaw ### 🛡️ Безопасность - Gateway bind (не 0.0.0.0!) - Auth mode - Утечки API ключей ## 💡 Примеры использования ### Базовая диагностика ``` Вы: продиагностируй себя Агент: 🏥 ДИАГНОСТИКА АГЕНТА — 2026-03-06 14:30 🧠 Память: ✅ OK ⏰ Кроны: ✅ OK ⚙️ Конфиг: ⚠️ 1 проблема 📁 Файлы: ✅ OK 🔧 Gateway: ✅ OK 💾 Система: ✅ OK 🛡️ Безопасность: ✅ OK ━━━━━━━━━━━━━━━━━━━ 📋 ДЕТАЛИ ПРОБЛЕМ: 1. ⚠️ memory-core отключен 📝 Что не так: Плагин отключился после обновления 💡 Решение: jq '.plugins[...] | .enabled = true' ... ⚡ Риск: средний ━━━━━━━━━━━━━━━━━━━ Исправить? (да/нет) ``` ### Автоматическая проверка ```bash # Создать крон для ежедневной диагностики openclaw cron add daily-health \ --schedule "0 8 * * *" \ --model "anthropic/claude-sonnet-4-6" \ --payload '{"kind":"agentTurn","message":"Запусти agent-doctor..."}' ``` ### Bash-скрипт (без агента) ```bash bash auto-diagnostic.sh # Быстрая проверка из терминала или CI/CD ``` ## 📚 Документация | Файл | Описание | |------|----------| | [SKILL.md](SKILL.md) | Рабочая версия (для личного агента) | | [EXAMPLES.md](EXAMPLES.md) | 10 сценариев использования | | [PROBLEMS_DATABASE.md](PROBLEMS_DATABASE.md) | 28 проблем и решений | | [INSTALL.md](INSTALL.md) | Инструкция по установке | ## 🔥 Когда использовать? - ✅ **После обновления OpenClaw** (обязательно!) - ✅ При странном поведении агента - ✅ Раз в неделю для профилактики - ✅ Перед важной работой (стрим, презентация) - ✅ Если агент "забывает" разговоры ## ⚠️ Частые проблемы ### Проблема #1: WAL mode отключен **Симптом:** Агент не видит новые записи **Решение:** ```bash sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode=WAL;" ``` ### Проблема #2: memory-core отключен **Симптом:** Память не работает после обновления **Решение:** Агент исправит автоматически (после подтверждения) ### Проблема #3: Gateway bind = 0.0.0.0 **Симптом:** Опасность! Доступ из интернета **Решение:** ```bash jq '.gateway.bind = "127.0.0.1"' ~/.openclaw/openclaw.json > /tmp/config.json && mv /tmp/config.json ~/.openclaw/openclaw.json ``` ## 🛡️ Безопасность - ✅ Скилл ТОЛЬКО читает данные - ✅ Все фиксы требуют подтверждения - ✅ Оценка рисков для каждого изменения - ✅ Никаких автоматических изменений конфига - ✅ Открытый исходный код (MIT License) ## 🤝 Контрибьюция Нашли баг? Есть идея? Открывайте issue или PR! **Что приветствуется:** - Новые проверки - Решения проблем - Улучшения документации - Примеры использования ## 📊 Статистика - **28** типовых проблем в базе - **7** категорий проверок - **10** примеров использования - **3000+** строк документации - **0** внешних зависимостей ## 🙏 Благодарности Created based on real OpenClaw user issues collected from GitHub, Reddit, and community feedback. Спасибо: - OpenClaw community за баг-репорты - Подписчикам AI ОПЕРАЦИОНКИ за фидбек - Алексею Ульянову ([@Sprut_AI](https://t.me/Sprut_AI)) за идею и спецификацию ## 📄 Лицензия MIT License - свободно используйте, модифицируйте, распространяйте. См. [LICENSE](LICENSE) для деталей. ## 🔗 Ссылки - [OpenClaw](https://github.com/openclaw/openclaw) — [OpenClaw Discord](https://discord.com/invite/clawd) - [Документация OpenClaw](https://docs.openclaw.io) --- **Версия:** 1.0.0 **Дата:** 2026-03-06 **Author:** [Aleksei Ulianov](https://github.com/AlekseiUL) 🏥 **Здоровый агент - продуктивный агент!** -
SKILL.md 16.2 KB
--- name: agent-doctor description: "Самодиагностика и автолечение OpenClaw. Проверка gateway, WAL, памяти, кронов, токенов. Автоматическое исправление типичных проблем." --- # 🏥 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 не находит свежие записи **Решение:** ```bash sqlite3 ~/.openclaw/memory/main.sqlite "PRAGMA journal_mode=WAL;" ``` **Риск:** Низкий. Это безопасная операция. **После:** Перезапустить gateway --- ### ⚠️ memorySearch отключен **Симптомы:** - memory_search не работает - Агент не использует долгосрочную память **Решение:** ```bash jq '.memorySearch.enabled = true' ~/.openclaw/openclaw.json > /tmp/config.json && mv /tmp/config.json ~/.openclaw/openclaw.json ``` **Риск:** Средний. Проверьте конфиг после изменения. **После:** Перезапустить gateway --- ### ❌ Нет embedding провайдера **Симптомы:** - memorySearch включен, но не работает - Ошибки "no embedding provider" **Решение:** OpenAI (рекомендуется): ```bash openclaw auth add openai ``` Gemini: ```bash openclaw auth add gemini ``` **Риск:** Низкий. --- ### ❌ memory-core плагин отключен **Почему возникает:** После обновления OpenClaw плагин может отключиться автоматически. **Симптомы:** - Память перестала работать после обновления **Решение:** ```bash 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): ```bash brew upgrade node ``` Linux (nvm): ```bash nvm install 20 nvm use 20 ``` Windows (nvm-windows): ``` nvm install 20 nvm use 20 ``` **Риск:** Средний. Может потребовать переустановку OpenClaw. --- ### ⚠️ Диск заполнен **Симптомы:** - Ошибки записи - Кроны не работают - База данных не растет **Решение:** Очистить старые логи: ```bash rm -rf ~/.openclaw/logs/*.log.old ``` Очистить кеш: ```bash rm -rf ~/.openclaw/cache/* ``` **Риск:** Низкий. Логи и кеш можно удалять безопасно. --- ### ❌ Gateway доступен из интернета **Почему опасно:** Если bind = 0.0.0.0, ваш агент доступен из интернета. Любой может подключиться. **Решение:** ```bash 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. Нет ли ошибок в логах крона? **Решение:** ```bash openclaw cron list openclaw cron logs <cron-name> ``` Изучить ошибки и исправить причину. --- ## Когда запускать диагностику Рекомендуется: - ✅ После обновления OpenClaw (обязательно!) - ✅ При странном поведении агента - ✅ Раз в неделю для профилактики - ✅ После изменения конфига - ✅ Если агент "забывает" недавние разговоры - ✅ Перед важной работой (чтобы убедиться что все в порядке) ## Важные команды ### Перезапуск Gateway **НЕ делайте так из сессии агента:** ```bash openclaw gateway restart # Убьет вашу сессию! ``` **Правильно:** macOS (launchd): ```bash launchctl kickstart -k gui/$(id -u)/com.openclaw.gateway ``` Linux (systemd): ```bash systemctl --user restart openclaw-gateway ``` Или вручную: ```bash openclaw gateway stop openclaw gateway start ``` ### Проверка конфига ```bash # Валидность 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 ``` ### Проверка базы данных ```bash # Размер 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: Да! Создайте крон который запускается раз в день: ```bash 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 🏥 Здоровый агент - продуктивный агент!
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.