Fully autonomous research pipeline that turns a topic idea into a complete academic paper with real citations, experiments, and conference-ready LaTeX.
Fully autonomous research pipeline that turns a topic idea into a complete academic paper with real citations, experiments, and conference-ready LaTeX.
triggers
["research this topic automatically","generate a paper from an idea","run autonomous research","use AutoResearchClaw to write a paper","chat an idea get a paper","run the research pipeline","autonomous paper generation","set up AutoResearchClaw"]
AutoResearchClaw is a fully autonomous 23-stage research pipeline that takes a natural language topic and produces a complete academic paper: real arXiv/Semantic Scholar citations, sandboxed experiments, statistical analysis, multi-agent peer review, and conference-ready LaTeX (NeurIPS/ICML/ICLR). No hallucinated references. No human babysitting.
Installation
# Clone and install
git clone https://github.com/aiming-lab/AutoResearchClaw.git
cd AutoResearchClaw
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
# Verify CLI is available
researchclaw --help
The agent CLI (e.g. claude) handles its own authentication.
OpenClaw bridge (optional advanced capabilities)
openclaw_bridge:use_cron:true# Scheduled research runsuse_message:true# Progress notificationsuse_memory:true# Cross-session knowledge persistenceuse_sessions_spawn:true# Parallel sub-sessionsuse_web_fetch:true# Live web search in literature reviewuse_browser:false# Browser-based paper collection
Key CLI Commands
# Basic run — fully autonomous, no prompts
researchclaw run --topic "Your research idea" --auto-approve
# Run with explicit config file
researchclaw run --config config.arc.yaml --topic "Mixture-of-experts routing efficiency" --auto-approve
# Run with topic defined in config (omit --topic flag)
researchclaw run --config config.arc.yaml --auto-approve
# Interactive mode — pauses at gate stages for approval
researchclaw run --config config.arc.yaml --topic "Your topic"# Check pipeline status / resume a run
researchclaw status --run-id rc-20260315-120000-abc123
# List past runs
researchclaw list
Gate stages (5, 9, 20) pause for human approval in interactive mode. Pass --auto-approve to skip all gates.
Python API
from researchclaw.pipeline import Runner
from researchclaw.config import load_config
# Load config and run
config = load_config("config.arc.yaml")
config.research.topic = "Efficient attention mechanisms for long-context LLMs"
config.auto_approve = True
runner = Runner(config)
result = runner.run()
# Access outputsprint(result.artifact_dir) # artifacts/rc-YYYYMMDD-HHMMSS-<hash>/print(result.deliverables_dir) # .../deliverables/print(result.paper_draft_path) # .../deliverables/paper_draft.mdprint(result.latex_path) # .../deliverables/paper.texprint(result.bibtex_path) # .../deliverables/references.bibprint(result.verification_report) # .../deliverables/verification_report.json
# Run specific stages onlyfrom researchclaw.pipeline import Runner, StageRange
runner = Runner(config)
result = runner.run(stages=StageRange(start="LITERATURE_COLLECT", end="KNOWLEDGE_EXTRACT"))
# Access knowledge base after a runfrom researchclaw.knowledge import KnowledgeBase
kb = KnowledgeBase.load(result.artifact_dir)
findings = kb.get("findings")
literature = kb.get("literature")
decisions = kb.get("decisions")
Output Structure
After a run, all outputs land in artifacts/rc-YYYYMMDD-HHMMSS-<hash>/:
export OPENAI_API_KEY="$OPENAI_API_KEY"
researchclaw run \
--topic "Self-supervised learning for protein structure prediction" \
--auto-approve
Pattern: Reproducible run with full config
# config.arc.yamlproject:name:"protein-ssl-research"research:topic:"Self-supervised learning for protein structure prediction"llm:provider:"openai"api_key_env:"OPENAI_API_KEY"primary_model:"gpt-4o"fallback_models: ["gpt-4o-mini"]
experiment:mode:"sandbox"sandbox:python_path:".venv/bin/python"max_iterations:3timeout_seconds:300
researchclaw run --config config.arc.yaml --auto-approve
Pattern: Use Claude via OpenRouter for best reasoning
# Force CPU mode in configexperiment:sandbox:device:"cpu"max_memory_gb:4
Key Concepts
PIVOT/REFINE Loop: Stage 15 autonomously decides PROCEED, REFINE (tweak params), or PIVOT (new hypothesis direction). All artifacts are versioned.
Multi-Agent Debate: Stages 8, 14, 18 use structured multi-perspective debate — not a single LLM pass.
Self-Learning: Each run extracts lessons with 30-day time decay. Future runs on similar topics benefit from past mistakes.
Sentinel Watchdog: Background monitor detects NaN/Inf in results, checks paper-evidence consistency, scores citation relevance, and guards against fabrication throughout the run.
4-Layer Citation Verification: arXiv lookup → CrossRef lookup → DataCite lookup → LLM relevance scoring. A citation must pass all layers to survive.