🏥 Agent Doctor - OpenClaw Self-Diagnostic Skill

Comprehensive self-diagnostics for OpenClaw agents. Checks all critical systems and provides concrete solutions.

---

Public links / Полезные ссылки

• YouTube: https://youtube.com/@alekseiulianov
• Telegram channel - Sprut AI: https://t.me/Sprut_AI
• Telegram chat - Sprut AI: https://t.me/+eH-qNIDmud8zNDZi
• AI Операционка: https://t.me/tribute/app?startapp=sJyg

Canonical source

This project is maintained by Aleksei Ulianov / Sprut_AI. Original repository: https://github.com/AlekseiUL/openclaw-agent-doctor

If you found this project mirrored, repackaged, or redistributed elsewhere, check this repository as the source of truth.

Attribution

Where permitted by the applicable license, if you reuse, fork, modify, package, or publish this work, keep the original copyright and license notice and link back to the canonical repository.

🎯 What is this?

Agent Doctor - an OpenClaw skill that:

• ✅ Checks 7 system categories (memory, crons, config, files, gateway, system, security)
• 🔍 Detects 28+ common problems
• 💡 Suggests concrete solutions with risk assessment
• 🛡️ Works safely - read-only, fixes only after confirmation
• 🌍 Supports all platforms (macOS, Linux, Windows)

Who is this for?

Agent Doctor is for OpenClaw users and maintainers who need a safe first-pass diagnosis before changing configs or restarting services:

• personal agent operators after an OpenClaw update;
• skill builders debugging memory, crons, gateway, or file layout;
• consultants checking a client agent without dumping private data;
• anyone who wants read-only diagnostics before approving fixes.

Diagnostic flow

flowchart LR
    A[User asks for diagnosis] --> B[Read-only system checks]
    B --> C[Classify issues by category]
    C --> D[Explain risk and suggested fix]
    D --> E{User approves?}
    E -->|yes| F[Apply selected fix]
    E -->|no| G[Leave system unchanged]

Loading

🚀 Quick Start

# 1. Install skill
cd ~/your-workspace/skills
git clone <repo-url>/agent-doctor.git

# 2. Restart gateway (optional)
openclaw gateway restart

# 3. Tell your agent:
"diagnose yourself"

Done! Your agent will check all systems and generate a report.

📊 What Gets Checked?

🧠 Memory

• SQLite database and WAL mode
• memorySearch settings
• Embedding provider
• Memory files (MEMORY.md, daily notes)
• Folder structure

⏰ Crons

• Status of all crons
• Last runs
• Errors and failureCount

⚙️ Config

• openclaw.json validity
• Models and providers
• Plugins (especially memory-core!)
• Auth profiles

📁 Agent Files

• SOUL.md, IDENTITY.md
• AGENTS.md, HEARTBEAT.md, USER.md
• Skills and availability

🔧 Gateway

• Status and uptime
• Log errors
• Ports

💾 System

• Node.js >= 20
• Python >= 3.11
• Free disk space
• OpenClaw version

🛡️ Security

• Gateway bind (not 0.0.0.0!)
• Auth mode
• API key leaks

💡 Usage Examples

Basic Diagnostics

You: diagnose yourself

Agent: 🏥 AGENT DIAGNOSTICS — 2026-03-06 14:30

🧠 Memory: ✅ OK
⏰ Crons: ✅ OK
⚙️ Config: ⚠️ 1 issue
📁 Files: ✅ OK
🔧 Gateway: ✅ OK
💾 System: ✅ OK
🛡️ Security: ✅ OK

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

📋 ISSUE DETAILS:

1. ⚠️ memory-core disabled
   📝 Problem: Plugin was disabled after update
   💡 Solution: jq '.plugins[...] | .enabled = true' ...
   ⚡ Risk: medium

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

Fix this? (yes/no)

Automatic Check

# Create cron for daily diagnostics
openclaw cron add daily-health \
  --schedule "0 8 * * *" \
  --model "anthropic/claude-sonnet-4-6" \
  --payload '{"kind":"agentTurn","message":"Run agent-doctor..."}'

Bash Script (without agent)

bash auto-diagnostic.sh
# Quick check from terminal or CI/CD

📚 Documentation

File	Description
SKILL.md	Working version (for personal agent)
EXAMPLES.md	10 usage scenarios
PROBLEMS_DATABASE.md	28 problems and solutions
INSTALL.md	Installation guide

🔥 When to Use?

• ✅ After OpenClaw update (mandatory!)
• ✅ When agent behaves strangely
• ✅ Once a week for prevention
• ✅ Before important work (stream, presentation)
• ✅ If agent "forgets" conversations

⚠️ Common Problems

Problem #1: WAL mode disabled

Symptom: Agent doesn't see new entries

Solution:

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

Problem #2: memory-core disabled

Symptom: Memory doesn't work after update

Solution: Agent will fix automatically (after confirmation)

Problem #3: Gateway bind = 0.0.0.0

Symptom: Danger! Internet access

Solution:

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

🛡️ Security

• ✅ Skill ONLY reads data
• ✅ All fixes require confirmation
• ✅ Risk assessment for each change
• ✅ No automatic config changes
• ✅ Open source (MIT License)

🤝 Contributing

Found a bug? Have an idea? Open an issue or PR!

What's welcome:

• New checks
• Problem solutions
• Documentation improvements
• Usage examples

📊 Stats

• 28 common problems in database
• 7 check categories
• 10 usage examples
• 3000+ lines of documentation
• 0 external dependencies

🙏 Acknowledgments

Created based on real OpenClaw user issues collected from GitHub, Reddit, and community feedback.

Thanks to:

• OpenClaw community for bug reports
• AI ОПЕРАЦИОНКА subscribers for feedback
• Aleksei Ulianov for idea and specification

📄 License

MIT License - freely use, modify, distribute.

See LICENSE for details.

🔗 Links

• OpenClaw
• OpenClaw Discord
• OpenClaw Documentation

---

Version: 1.0.0
Date: 2026-03-06
Author: Aleksei Ulianov

🏥 Healthy agent = productive agent!

---

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

Комплексная самодиагностика для 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 ОПЕРАЦИОНКИ за фидбек
• Алексею Ульянову за идею и спецификацию

📄 Лицензия

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

См. LICENSE для деталей.

🔗 Ссылки

• OpenClaw
• OpenClaw Discord
• Документация OpenClaw

---

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

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

---

Resources | Ресурсы

• 📺 YouTube: youtube.com/@alekseiulianov
• 📱 Telegram: t.me/Sprut_AI
• 🔥 AI ОПЕРАЦИОНКА (Premium): Подписка — продвинутые материалы, скиллы, агенты, поддержка
• 💻 GitHub: github.com/AlekseiUL

License

MIT

---

Keeping AI agents healthy since 2026 | Делаю AI-агентов здоровыми с 2026