Research Library

Quick Start

# Initialize database
reslib status

# Add a project
reslib add ~/projects/arduino/servo.py --project arduino --material-type reference

# Search
reslib search "servo tuning"

# Link knowledge
reslib link 5 12 --type applies_to

Features

CLI Commands

• reslib add — Import documents (auto-detect + extract)
• reslib search — Full-text search with filters
• reslib get — View document details
• reslib archive / reslib unarchive — Manage documents
• reslib export — Export as JSON/Markdown
• reslib link — Create document relationships
• reslib projects — Manage projects
• reslib tags — Manage tags
• reslib status — System overview
• reslib backup / reslib restore — Snapshots
• reslib smoke_test.sh — Quick validation

Technical

• Storage: SQLite 3.45+ with FTS5 virtual table
• Extraction: PDF (pdfplumber + OCR), images (EXIF + OCR), code (AST + regex)
• Confidence Scoring: 0.0-1.0 based on quality + source
• Material Weighting: Reference (1.0) vs Research (0.5)
• Project Isolation: Scoped searches, no contamination
• Async Workers: 2-4 configurable extraction workers
• Catalog Separation: real_world vs openclaw projects
• Backup: Daily snapshots, 30-day retention

Configuration

Copy reslib/config.json and customize:

{
  "db_path": "~/.openclaw/research/library.db",
  "num_workers": 2,
  "worker_timeout_sec": 300,
  "max_retries": 3,
  "backup_retention_days": 30,
  "backup_dir": "~/.openclaw/research/backups",
  "file_size_limit_mb": 200,
  "project_size_limit_gb": 2
}

Integration with War Room

Use RL1 protocol in war room DNA:

from reslib import ResearchDatabase, ResearchSearch

db = ResearchDatabase()
search = ResearchSearch(db)

# Before researching, check existing knowledge
prior = search.search("servo tuning", project="rc-quadcopter")
if prior:
    print(f"Found {len(prior)} prior items")