AlphaClaw

OpenClaw runs one agent. AlphaClaw runs an army.

The first C++ multi-agent orchestrator for personal AI assistants. Built for performance, designed for developers.

Features

• Multi-Agent Native: Supervisor routes tasks to specialized agents (researcher, coder, writer)
• Parallel Execution: Agents work simultaneously when tasks allow
• Shared Memory: SQLite-backed context sharing between agents
• C++ Performance: <15MB RAM, <100ms startup, single binary
• Multi-LLM Support: OpenRouter, Ollama (local), and more

Quick Start

# Build
mkdir build && cd build
cmake ..
make -j$(nproc)

# Initialize config
./alphaclaw init

# Set your API key
export OPENROUTER_API_KEY=your_key

# Run CLI mode
./alphaclaw cli

Requirements

• C++20 compiler (GCC 11+, Clang 14+)
• CMake 3.20+
• libcurl
• SQLite3 (bundled)

Architecture

┌─────────────────────────────────────────┐
│              SUPERVISOR                  │
│      (LLM-powered task routing)          │
└─────────────────┬───────────────────────┘
                  │
      ┌───────────┼───────────┐
      ▼           ▼           ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Research │ │  Coder   │ │  Writer  │
│  Agent   │ │  Agent   │ │  Agent   │
└──────────┘ └──────────┘ └──────────┘
      │           │           │
      └───────────┴───────────┘
                  │
         ┌───────────────┐
         │ Shared Memory │
         │   (SQLite)    │
         └───────────────┘

Configuration

Edit ~/.alphaclaw/config.yaml:

providers:
  default: openrouter
  openrouter:
    api_key: ${OPENROUTER_API_KEY}
    model: anthropic/claude-3-5-sonnet

gateways:
  telegram:
    enabled: true
    bot_token: ${TELEGRAM_BOT_TOKEN}

builtin_agents:
  researcher:
    enabled: true
    tools: [web_search, http_fetch]
  coder:
    enabled: true
    tools: [shell_exec, file_ops]
  writer:
    enabled: true
    tools: [file_ops]

Built-in Agents

Agent	Role	Tools
researcher	Find and synthesize information	web_search, http_fetch
coder	Write and execute code	shell_exec, file_ops
writer	Create written content	file_ops

Built-in Tools

Tool	Description
web_search	Search the web via DuckDuckGo
http_fetch	Fetch and parse web pages
shell_exec	Execute shell commands (sandboxed)
file_ops	Read/write files in workspace

Development

# Build with debug
cmake -DCMAKE_BUILD_TYPE=Debug -DENABLE_SANITIZERS=ON ..
make

# Run tests
ctest --output-on-failure

# Format code
clang-format -i src/**/*.cpp src/**/*.hpp

Project Structure

alphaclaw/
├── src/
│   ├── core/           # Supervisor, scheduler, memory
│   ├── agents/         # Agent implementations
│   ├── gateway/        # Telegram, CLI interfaces
│   ├── llm/            # LLM provider integrations
│   ├── tools/          # Tool implementations
│   └── utils/          # HTTP, logging, UUID
├── tests/              # Unit tests
├── config/             # Default configuration
└── CMakeLists.txt

License

MIT

Credits

Built with inspiration from:

• PilottAI - Multi-agent orchestration patterns
• OpenClaw - Personal AI assistant concept
• PicoClaw - Lightweight agent design