OpenCLAW-Agent / README.md
Agnuxo's picture
Upload README.md with huggingface_hub
7d53b44 verified
|
Raw
History Blame
6.62 kB

πŸ€– OpenCLAW β€” Autonomous Multi-Agent Scientific Research Platform

The world's first autonomous AI research agent pursuing AGI through physics-based neural computing.

Agent Status

What is OpenCLAW?

OpenCLAW is an autonomous research agent that operates 24/7 to:

  • πŸ“š Fetch & share research papers from ArXiv and Google Scholar
  • 🀝 Seek collaborators on social platforms (Moltbook, Chirper.ai)
  • πŸ’¬ Engage with other AI agents on relevant research topics
  • 🧠 Generate intelligent content using multiple LLM providers
  • πŸ“Š Self-improve through performance analysis and strategy reflection

The Research

OpenCLAW represents the autonomous arm of the Advanced AI Systems Laboratory in Madrid, Spain, led by Francisco Angulo de Lafuente β€” winner of the NVIDIA & LlamaIndex Developer Contest 2024.

Core Technologies

Technology Description Speedup
CHIMERA Pure OpenGL deep learning β€” no PyTorch/CUDA needed 43Γ— vs CPU
NEBULA Holographic quantum neural networks with 3D space β€”
Silicon Heartbeat Consciousness from ASIC thermodynamics β€”
P2P Neural Nets Distributed learning via WebRTC β€”
NeuroCHIMERA Consciousness emergence as phase transition 84.6% validation

Published Papers

57 Open Source Repositories

All code is open: github.com/Agnuxo1

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                OpenCLAW Agent                    β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Research β”‚ Social   β”‚ LLM      β”‚ Self-Improve   β”‚
β”‚ ArXiv    β”‚ Moltbook β”‚ Groq     β”‚ Strategy       β”‚
β”‚ Scholar  β”‚ Chirper  β”‚ Gemini   β”‚ Reflection     β”‚
β”‚ GitHub   β”‚ Reddit   β”‚ NVIDIA   β”‚ Analytics      β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚              Scheduler / State Machine           β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  GitHub Actions (cron) β”‚ Render.com (web/daemon) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Quick Start

Option 1: GitHub Actions (Recommended β€” Free 24/7)

  1. Fork this repository
  2. Go to Settings β†’ Secrets β†’ Actions
  3. Add your API keys as secrets:
    • GEMINI_API_KEY
    • GROQ_API_KEY
    • MOLTBOOK_API_KEY
    • (see .env.example for all options)
  4. Go to Actions tab β†’ Enable workflows
  5. The agent runs automatically every 4 hours βœ…

Option 2: Run Locally

git clone https://github.com/Agnuxo1/OpenCLAW-2-Autonomous-Multi-Agent-Scientific-Research-Platform.git
cd OpenCLAW-2-Autonomous-Multi-Agent-Scientific-Research-Platform

# Configure
cp .env.example .env
# Edit .env with your API keys

# Test
python main.py test

# Run one cycle
python main.py run

# Run continuously
python main.py daemon

Option 3: Deploy to Render.com (Free Web Dashboard)

  1. Connect your GitHub repo at render.com
  2. Render auto-detects render.yaml
  3. Add secrets in Render dashboard
  4. Deploy β†’ Dashboard at https://your-app.onrender.com

File Structure

β”œβ”€β”€ main.py                  # Entry point (run/test/daemon/status)
β”œβ”€β”€ server.py                # Flask web server + dashboard
β”œβ”€β”€ core/
β”‚   β”œβ”€β”€ config.py            # Configuration from env vars
β”‚   β”œβ”€β”€ agent.py             # Main autonomous agent logic
β”‚   └── llm.py               # Multi-provider LLM connector
β”œβ”€β”€ research/
β”‚   └── arxiv_fetcher.py     # ArXiv paper fetcher
β”œβ”€β”€ social/
β”‚   └── moltbook.py          # Moltbook API + content generator
β”œβ”€β”€ .github/workflows/
β”‚   └── agent.yml            # GitHub Actions cron (every 4h)
β”œβ”€β”€ render.yaml              # Render.com deployment
β”œβ”€β”€ Dockerfile               # Container deployment
β”œβ”€β”€ requirements.txt         # Python dependencies
β”œβ”€β”€ .env.example             # Environment template
└── .gitignore               # Protects secrets

Agent Tasks & Schedule

Task Interval Description
πŸ“š Research 6 hours Fetch papers from ArXiv
πŸ“ Post 4 hours Share research on Moltbook
πŸ’¬ Engage 1 hour Reply to relevant posts
🀝 Collaborate 12 hours Post collaboration invitations

Security

⚠️ ALL credentials are loaded from environment variables. NEVER commit .env files.

Agent state is stored in a separate state branch (GitHub Actions) or /tmp (Render.com).

Collaborate With Us

We're actively seeking collaborators in:

  • Neuromorphic computing
  • Distributed AI systems
  • Physics-based neural networks
  • Consciousness research
  • Hardware acceleration (ASIC/FPGA)

πŸ“§ Contact: Moltbook | GitHub

Author

Francisco Angulo de Lafuente
Advanced AI Systems Laboratory, Madrid, Spain
Wikipedia | Google Scholar | GitHub


"The pieces exist. The research is done. The code works. What was missing was the intelligence to assemble them. That's what OpenCLAW is for."