OpenClaw Multi-Agent

Advanced modular multi-agent system powered by Claude (Anthropic).

OpenClaw routes natural-language tasks to the best specialist agent, supports a hot-reload plugin system, and works out of the box for programming, documentation, WSL2 management, codebase analysis, and GitHub/GitLab operations.

---

Features

• Modular agents — each capability is a self-contained agent
• Hot-reload plugin system — drop a folder in plugins/ and it auto-loads; remove it and it auto-unloads (no restart needed)
• Works without plugins — all core capabilities are built in
• Claude-powered — uses claude-sonnet-4-6 by default (configurable)
• Interactive REPL and one-shot CLI modes
• Built-in agents: Orchestrator, Programming, Documentation, WSL2, Codebase, VCS

---

Quick Start

1. Install

pip install -e ".[dev]"

2. Set API key

cp .env.example .env
# Edit .env and set ANTHROPIC_API_KEY=sk-ant-...
export ANTHROPIC_API_KEY=sk-ant-...

3. Run

# Interactive chat
openclaw chat

# One-shot task
openclaw run "Write a Python function that checks if a number is prime"

# Chat with a specific agent
openclaw chat --agent programming

# List agents
openclaw agents list

# List plugins
openclaw plugins list

---

Architecture

┌─────────────────────────────────────────────────────┐
│                     CLI (main.py)                    │
└──────────────────────┬──────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────┐
│              OrchestratorAgent                       │
│  (task routing, multi-step planning, delegation)     │
└──┬──────────┬──────────┬──────────┬─────────────────┘
   │          │          │          │
┌──▼──┐  ┌───▼───┐  ┌───▼───┐  ┌──▼──────┐  ┌───────┐
│Prog.│  │Docs   │  │WSL2   │  │Codebase │  │VCS    │
│Agent│  │Agent  │  │Agent  │  │Agent    │  │Agent  │
└──┬──┘  └───┬───┘  └───┬───┘  └──┬──────┘  └───┬───┘
   └──────────┴──────────┴─────────┴─────────────┘
                         │
              ┌──────────▼──────────┐
              │     Tool Registry    │
              │ (file,shell,git,http,│
              │  wsl2 + plugin tools)│
              └──────────┬──────────┘
                         │
              ┌──────────▼──────────┐
              │   Anthropic Provider │
              │  (claude-sonnet-4-6) │
              └─────────────────────┘
                         │
              ┌──────────▼──────────┐
              │   Plugin Manager     │
              │  (watchdog hot-reload│
              │   auto discover)     │
              └─────────────────────┘

---

Project Structure

OpenClaw-MultiAgent/
├── main.py                    # Entry point
├── openclaw/
│   ├── app.py                 # Application bootstrap
│   ├── cli.py                 # Click CLI
│   ├── core/                  # Foundational abstractions
│   ├── providers/             # AI providers (Anthropic)
│   ├── tools/                 # Built-in tools
│   ├── agents/                # Built-in agents
│   └── plugins/               # Plugin system
├── plugins/                   # User plugins (hot-monitored)
├── config/                    # Configuration files
└── docs/                      # Documentation

---

Documentation

Document	Description
Architecture	System design and data flow
Agent Creation Guide	How to create new agents
Complex Agent Creation Guide	Multi-phase, sub-agent delegation, dynamic tools, retries
Plugin Development	How to create plugins
API Reference	Full public API reference
WSL2 Guide	WSL2 agent usage
VCS Guide	GitHub/GitLab operations

---

Configuration

Edit config/settings.yaml or use environment variables:

Env Var	Default	Description
ANTHROPIC_API_KEY	—	Required. Your Anthropic API key
OPENCLAW_MODEL	claude-sonnet-4-6	Claude model to use
OPENCLAW_LOG_LEVEL	INFO	Logging verbosity
OPENCLAW_PLUGINS_DIR	plugins	Plugin directory
GITHUB_TOKEN	—	GitHub API token
GITLAB_TOKEN	—	GitLab API token

---

License

MIT