Напишите OpenClaw: «Исследуй X» → готово.

🇺🇸 English · 🇨🇳 中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇫🇷 Français · 🇩🇪 Deutsch · 🇪🇸 Español · 🇧🇷 Português · 🇷🇺 Русский · 🇸🇦 العربية

📖 Руководство по интеграции

pip install -e . && researchclaw run --topic "Your research idea here" --auto-approve

У вас есть идея. Вы хотите статью. Вот и всё.

AutoResearchClaw берёт исследовательскую тему и автономно создаёт полноценную академическую статью — с реальной литературой из arXiv и Semantic Scholar (мультиисточниковый поиск, приоритет arXiv для избежания ограничений по частоте запросов), аппаратно-адаптивными песочными экспериментами (автоопределение GPU/MPS/CPU), статистическим анализом, рецензированием и готовым для конференции LaTeX (ориентир — 5 000–6 500 слов для NeurIPS/ICML/ICLR). Без ручного контроля. Без копирования между инструментами.

Конвейер работает полностью автономно без вмешательства человека (если только вы не настроите этапы контроля для ручной проверки). Когда эксперименты завершаются ошибкой — система восстанавливается автоматически. Когда гипотезы не подтверждаются — она меняет направление.

researchclaw run --topic "Agent-based Reinforcement Learning for Automated Scientific Discovery" --auto-approve

Конвейер работает не просто линейно. Этап 15 (RESEARCH_DECISION) оценивает результаты экспериментов относительно гипотез и принимает автономное решение:

• PROCEED — результаты подтверждают гипотезы, продолжаем написание статьи
• REFINE — результаты многообещающие, но требуют доработки; возврат к улучшению кода/параметров
• PIVOT — обнаружена фундаментальная проблема; перезапуск с этапа генерации гипотез в новом направлении

Каждый цикл PIVOT/REFINE версионирует предыдущие артефакты (stage-08_v1/, stage-08_v2/, ...), поэтому ничего не теряется, а эволюция решений полностью отслеживаема.

На критических этапах используется структурированный протокол дискуссии с участием нескольких «точек зрения» LLM:

• Генерация гипотез — различные агенты предлагают и оспаривают идеи
• Анализ результатов — оптимист, скептик и прагматик анализируют итоги
• Рецензирование — проверка согласованности методологии и доказательств (заявляет ли статья о 50 испытаниях, когда код выполнил 5?)

Каждый запуск конвейера извлекает детализированные уроки — не просто «ошибка», а почему она произошла:

• Обоснование решений PIVOT/REFINE
• Предупреждения времени выполнения из stderr экспериментов (например, RuntimeWarning: division by zero)
• Аномалии метрик (NaN, Inf, одинаковые скорости сходимости)

Эти уроки сохраняются в хранилище JSONL с временным затуханием (период полураспада 30 дней) и внедряются как промпт-оверлеи в будущие запуски. Конвейер буквально учится на своих ошибках.

Каждый запуск формирует структурированную базу знаний (хранится в docs/kb/) с 6 категориями:

• decisions/ — проектирование экспериментов, контрольные этапы, исследовательские решения, планирование ресурсов, стратегии поиска, архивы знаний
• experiments/ — логи генерации кода, запуски экспериментов, итеративные улучшения
• findings/ — верификация цитирования, анализ результатов, аналитические отчёты
• literature/ — извлечение знаний, сбор литературы, результаты скрининга
• questions/ — генерация гипотез, декомпозиция проблемы, инициализация темы
• reviews/ — отчёты об экспорте/публикации, черновики статей, планы, ревизии, рецензии

Фоновый монитор качества, выявляющий проблемы, которые основной конвейер может пропустить:

• Обнаружение ошибок времени выполнения — NaN/Inf в метриках, предупреждения stderr передаются LLM для целенаправленного исправления
• Согласованность статьи и доказательств — реальный код экспериментов, результаты запусков и логи доработок включаются в рецензирование
• Оценка релевантности цитирования — помимо проверки существования, LLM оценивает тематическую релевантность каждой ссылки
• Контроль сходимости — обнаруживает эксперименты с фиксированным числом итераций и требует корректной ранней остановки
• Валидация абляций — выявляет дублирующиеся/идентичные условия абляции и помечает некорректные сравнения
• Защита от фабрикации — полностью блокирует написание статьи, когда эксперименты не дают метрик

Если вы уже используете OpenClaw в качестве AI-ассистента:

1️⃣  Поделитесь URL репозитория GitHub с OpenClaw
2️⃣  OpenClaw автоматически читает RESEARCHCLAW_AGENTS.md → понимает конвейер
3️⃣  Скажите: "Research [ваша тема]"
4️⃣  Готово — OpenClaw клонирует, устанавливает, настраивает, запускает и возвращает результаты

Вот и всё. OpenClaw автоматически выполняет git clone, pip install, настройку конфигурации и запуск конвейера. Вы просто общаетесь в чате.

Для более глубокой интеграции AutoResearchClaw включает систему мостовых адаптеров с 6 опциональными возможностями:

# config.arc.yaml
openclaw_bridge:
  use_cron: true              # ⏰ Запуск исследований по расписанию
  use_message: true           # 💬 Уведомления о прогрессе (Discord/Slack/Telegram)
  use_memory: true            # 🧠 Межсессионное сохранение знаний
  use_sessions_spawn: true    # 🔀 Параллельные подсессии для одновременных этапов
  use_web_fetch: true         # 🌐 Веб-поиск в реальном времени при обзоре литературы
  use_browser: false          # 🖥️ Сбор статей через браузер

Каждый флаг активирует типизированный протокол адаптера. Когда OpenClaw предоставляет эти возможности, адаптеры используют их без изменений в коде. Подробности см. в integration-guide.md.

Фаза A: Определение области          Фаза E: Выполнение экспериментов
  1. TOPIC_INIT                         12. EXPERIMENT_RUN
  2. PROBLEM_DECOMPOSE                  13. ITERATIVE_REFINE  ← самовосстановление

Фаза B: Поиск литературы             Фаза F: Анализ и решение
  3. SEARCH_STRATEGY                    14. RESULT_ANALYSIS    ← мультиагентный
  4. LITERATURE_COLLECT  ← реальный API 15. RESEARCH_DECISION  ← PIVOT/REFINE
  5. LITERATURE_SCREEN   [контроль]
  6. KNOWLEDGE_EXTRACT                  Фаза G: Написание статьи
                                        16. PAPER_OUTLINE
Фаза C: Синтез знаний                  17. PAPER_DRAFT
  7. SYNTHESIS                          18. PEER_REVIEW        ← проверка доказательств
  8. HYPOTHESIS_GEN    ← дискуссия      19. PAPER_REVISION

Фаза D: Проектирование экспериментов Фаза H: Финализация
  9. EXPERIMENT_DESIGN   [контроль]     20. QUALITY_GATE      [контроль]
 10. CODE_GENERATION                    21. KNOWLEDGE_ARCHIVE
 11. RESOURCE_PLANNING                  22. EXPORT_PUBLISH     ← LaTeX
                                        23. CITATION_VERIFY    ← проверка релевантности

Контрольные этапы (5, 9, 20) приостанавливают работу для подтверждения человеком или пропускаются с --auto-approve. При отклонении конвейер откатывается назад.

Циклы принятия решений: Этап 15 может запустить REFINE (→ Этап 13) или PIVOT (→ Этап 8) с автоматическим версионированием артефактов.

• 🐍 Python 3.11+
• 🔑 Конечная точка API LLM, совместимая с OpenAI (GPT-4o, GPT-5.x или любой совместимый провайдер)

git clone https://github.com/aiming-lab/AutoResearchClaw.git
cd AutoResearchClaw
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

cp config.researchclaw.example.yaml config.arc.yaml

project:
  name: "my-research"

research:
  topic: "Your research topic here"

llm:
  base_url: "https://api.openai.com/v1"     # Любая конечная точка, совместимая с OpenAI
  api_key_env: "OPENAI_API_KEY"              # Имя переменной окружения с вашим ключом
  primary_model: "gpt-4o"                    # Любая модель, поддерживаемая вашей конечной точкой
  fallback_models: ["gpt-4o-mini"]
  s2_api_key: ""                             # Опционально: API-ключ Semantic Scholar для повышенных лимитов

experiment:
  mode: "sandbox"
  sandbox:
    python_path: ".venv/bin/python"

# Установите ваш API-ключ
export OPENAI_API_KEY="sk-..."

# 🚀 Запуск полного конвейера
researchclaw run --config config.arc.yaml --auto-approve

# 🎯 Указание темы в командной строке
researchclaw run --config config.arc.yaml --topic "Transformer attention for time series" --auto-approve

# ✅ Проверка конфигурации
researchclaw validate --config config.arc.yaml

# ⏩ Возобновление с определённого этапа
researchclaw run --config config.arc.yaml --from-stage PAPER_OUTLINE --auto-approve

Результаты → artifacts/rc-YYYYMMDD-HHMMSS-<hash>/ с подкаталогом для каждого этапа.

Все пользовательские материалы автоматически собираются в единую папку deliverables/:

artifacts/rc-YYYYMMDD-HHMMSS-<hash>/deliverables/
├── paper_final.md             # Финальная статья (Markdown)
├── paper.tex                  # Готовый для конференции LaTeX
├── references.bib             # Верифицированная библиография BibTeX (с автоочисткой)
├── neurips_2025.sty           # Файл стиля конференции (автоматический выбор)
├── code/                      # Код экспериментов + requirements.txt
├── verification_report.json   # Отчёт о целостности цитирования
├── charts/                    # Визуализация результатов (сравнение условий, полосы ошибок)
└── manifest.json              # Индекс материалов с метаданными

Папка deliverables/ готова к компиляции — она включает конференционные файлы .sty и .bst, так что вы можете скомпилировать paper.tex напрямую с помощью pdflatex + bibtex или загрузить в Overleaf без дополнительных скачиваний.

Этап 4 обращается к реальным академическим API — а не к галлюцинациям LLM. Использует стратегию приоритета arXiv для избежания ограничений Semantic Scholar.

• arXiv API (основной) — препринты с реальными идентификаторами arXiv и метаданными, без ограничений по частоте запросов
• Semantic Scholar API (вспомогательный) — реальные статьи с названиями, аннотациями, площадками, числом цитирований, DOI
• Расширение запросов — автоматическая генерация более широких запросов (обзоры, бенчмарки, сравнительные варианты) для полного покрытия (30–60 ссылок)
• Автоматическая дедупликация — DOI → arXiv ID → нечёткое сопоставление названий
• Генерация BibTeX — корректные записи @article{cite_key, ...} с реальными метаданными
• Трёхсостояный автоматический выключатель — CLOSED → OPEN → HALF_OPEN с экспоненциальным затуханием (никогда не отключается навсегда)
• Постепенная деградация — сбой S2 не блокирует результаты arXiv; при отказе всех API используются результаты, дополненные LLM

from researchclaw.literature import search_papers

papers = search_papers("transformer attention mechanisms", limit=20)
for p in papers:
    print(f"{p.title} ({p.year}) — cited {p.citation_count}x")
    print(p.to_bibtex())

После написания статьи Этап 23 проверяет каждую ссылку на целостность и релевантность:

Каждая ссылка → VERIFIED ✅ · SUSPICIOUS ⚠️ · HALLUCINATED ❌ · SKIPPED ⏭️ · LOW_RELEVANCE 📉

Автоочистка: Галлюцинированные цитаты молча удаляются из текста статьи (без тегов [HALLUCINATED]). Библиографические записи без цитирования удаляются. Итоговый references.bib содержит только верифицированные и процитированные ссылки.

Этап 1 автоматически определяет возможности локального GPU и адаптирует весь конвейер:

Аппаратный профиль сохраняется в stage-01/hardware_profile.json и влияет на генерацию кода, импорты песочницы и ограничения промптов.

• Валидация кода — разбор AST, белый список импортов, запрет файлового ввода-вывода за пределами песочницы
• Контроль вычислительного бюджета — временной бюджет (настраиваемый, по умолчанию 600 с) внедряется в промпт генерации кода; LLM обязана проектировать эксперименты, укладывающиеся в таймаут песочницы
• Обвязка эксперимента — неизменяемый experiment_harness.py внедряется в песочницу с временным ограничителем should_stop(), отклонением NaN/Inf в report_metric() и записью результатов finalize() (вдохновлено паттерном неизменяемой оценки karpathy/autoresearch)
• Структурированный вывод — эксперименты создают results.json с типизированными метриками (не просто разбор stdout)
• Умный разбор метрик — фильтрация логовых строк из метрик с помощью определения ключевых слов (is_metric_name())
• Быстрый отказ при NaN/расхождении — NaN/Inf фильтруются из метрик; расходящаяся функция потерь (>100) обнаруживается и помечается
• Контроль сходимости — сгенерированный код должен включать критерии ранней остановки, а не фиксированное число итераций
• Обнаружение ошибок времени выполнения — NaN/Inf в метриках и предупреждения stderr (деление на ноль, переполнение) обнаруживаются автоматически
• Самовосстанавливающееся исправление — ошибки времени выполнения передаются LLM с целенаправленной диагностикой для устранения первопричин (а не маскировки через try/except)
• Итеративное улучшение — Этап 13 анализирует результаты и перезапускает с улучшенным кодом/параметрами (до 10 итераций с учётом таймаутов в промптах)
• Захват частичных результатов — эксперименты с истёкшим таймаутом, но захваченными метриками получают статус "partial" вместо "failed", сохраняя полезные данные
• Согласованность темы и эксперимента — LLM-проверка после генерации обеспечивает, что код эксперимента действительно тестирует заявленную исследовательскую тему

Конвейер написания ориентирован на стандарты NeurIPS/ICML/ICLR (9+ страниц, 5 000–6 500 слов):

• Обеспечение целостности данных — написание статьи полностью блокируется, когда эксперименты не дают метрик (предотвращение фабрикации результатов LLM); инструкции против фабрикации внедряются в промпты черновика и ревизии
• Промпты конференционного уровня — системные промпты включают ключевые принципы из анализа принятых статей: новизна, нарратив, сильные базовые модели, абляции, честность, воспроизводимость; частые причины отклонения помечены
• Рекомендации по названию и подаче — сигнализация новизны, тест на запоминаемость, 5-предложенная структура аннотации, обнаружение шаблонных названий с перегенерацией
• Посекционное написание — 3 последовательных вызова LLM (Введение+Обзор → Метод+Эксперименты → Результаты+Заключение) для предотвращения обрезки вывода
• Целевые объёмы по секциям — Аннотация (150–250), Введение (800–1000), Обзор литературы (600–800), Метод (1000–1500), Эксперименты (800–1200), Результаты (600–800), Дискуссия (400–600)
• Контроль объёма ревизии — если ревизированная статья короче черновика, автоматический повтор с усиленным контролем; откат к черновику с аннотациями при необходимости
• Подавление оговорок — ограничение «due to computational constraints» максимум 1 вхождением; промпты ревизии активно удаляют повторяющиеся оговорки
• Статистическая строгость — доверительные интервалы, p-значения и размеры эффекта обязательны в таблицах результатов; некорректные абляции помечаются и исключаются из утверждений
• Рецензирование по конференционной рубрике — рецензенты оценивают по шкале 1–10 согласно рубрике NeurIPS/ICML (новизна, базовые модели, абляции, утверждения vs доказательства, ограничения)

export:
  target_conference: "neurips_2025"   # или "iclr_2026" или "icml_2026"

Конвертер Markdown → LaTeX обрабатывает: заголовки секций (с дедупликацией автонумерации), встроенную/выносную математику, жирный/курсивный текст, списки, таблицы (с \caption/\label), рисунки (\includegraphics), блоки кода (поддержка Unicode), перекрёстные ссылки и ссылки \cite{}.

Используйте --auto-approve для пропуска всех контрольных этапов или настройте конкретные этапы в security.hitl_required_stages.

# === Проект ===
project:
  name: "my-research"              # Идентификатор проекта
  mode: "docs-first"               # docs-first | semi-auto | full-auto

# === Исследование ===
research:
  topic: "..."                     # Тема исследования (обязательно)
  domains: ["ml", "nlp"]           # Предметные области для поиска литературы
  daily_paper_count: 8             # Целевое число статей на поисковый запрос
  quality_threshold: 4.0           # Минимальный балл качества статей

# === Среда выполнения ===
runtime:
  timezone: "America/New_York"     # Для временных меток
  max_parallel_tasks: 3            # Лимит параллельных экспериментов
  approval_timeout_hours: 12       # Таймаут контрольного этапа
  retry_limit: 2                   # Число повторных попыток при сбое этапа

# === LLM ===
llm:
  provider: "openai-compatible"    # Тип провайдера
  base_url: "https://..."          # Конечная точка API (обязательно)
  api_key_env: "OPENAI_API_KEY"    # Переменная окружения для API-ключа (обязательно)
  api_key: ""                      # Или укажите ключ здесь напрямую
  primary_model: "gpt-4o"          # Основная модель
  fallback_models: ["gpt-4o-mini"] # Резервная цепочка
  s2_api_key: ""                   # API-ключ Semantic Scholar (опционально, повышенные лимиты)

# === Эксперименты ===
experiment:
  mode: "sandbox"                  # simulated | sandbox | docker | ssh_remote
  time_budget_sec: 600             # Макс. время выполнения за запуск (по умолчанию: 600 с)
  max_iterations: 10               # Макс. число итераций оптимизации
  metric_key: "val_loss"           # Имя основной метрики
  metric_direction: "minimize"     # minimize | maximize
  sandbox:
    python_path: ".venv/bin/python"
    gpu_required: false
    allowed_imports: [math, random, json, csv, numpy, torch, sklearn]
    max_memory_mb: 4096
  docker:
    image: "researchclaw/experiment:latest"
    network_policy: "setup_only"   # none | setup_only | pip_only | full
    gpu_enabled: true
    memory_limit_mb: 8192
    auto_install_deps: true        # Автоопределение импортов → requirements.txt
  ssh_remote:
    host: ""                       # Имя хоста GPU-сервера
    gpu_ids: []                    # Доступные идентификаторы GPU
    remote_workdir: "/tmp/researchclaw_experiments"

# === Экспорт ===
export:
  target_conference: "neurips_2025"  # neurips_2025 | iclr_2026 | icml_2026
  authors: "Anonymous"
  bib_file: "references"

# === Промпты ===
prompts:
  custom_file: ""                  # Путь к пользовательскому YAML промптов (пусто = по умолчанию)

# === Безопасность ===
security:
  hitl_required_stages: [5, 9, 20] # Этапы, требующие подтверждения человека
  allow_publish_without_approval: false
  redact_sensitive_logs: true

# === База знаний ===
knowledge_base:
  backend: "markdown"              # markdown | obsidian
  root: "docs/kb"

# === Уведомления ===
notifications:
  channel: "console"               # console | discord | slack
  target: ""

# === Мост OpenClaw ===
openclaw_bridge:
  use_cron: false                  # Запуск исследований по расписанию
  use_message: false               # Уведомления о прогрессе
  use_memory: false                # Межсессионное сохранение знаний
  use_sessions_spawn: false        # Параллельные подсессии
  use_web_fetch: false             # Веб-поиск в реальном времени
  use_browser: false               # Сбор статей через браузер

Вдохновлено проектами:

• 🔬 AI Scientist (Sakana AI) — Пионер автоматизированных исследований
• 🧠 AutoResearch (Andrej Karpathy) — Сквозная автоматизация исследований
• 🌐 FARS (Analemma) — Полностью автоматизированная исследовательская система

MIT — подробности в LICENSE.

_{Создано с 🦞 командой AutoResearchClaw}