# Official ServerlessClaw: Autonomous AI Agent Swarm for AWS

<p align="center">
  <img src="./apps/dashboard/public/neural-hub.png" alt="ServerlessClaw Neural Hub - Central Command and Cognitive Metrics" width="800">
</p>

<p align="center">
  <img src="https://img.shields.io/badge/SST-v4-E27152?style=flat-square&logo=sst" alt="SST v4">
  <img src="https://img.shields.io/badge/AWS-Lambda-FF9900?style=flat-square&logo=amazon-aws" alt="AWS Lambda">
  <img src="https://img.shields.io/badge/AWS-DynamoDB-FF9900?style=flat-square&logo=amazon-aws" alt="DynamoDB">
  <img src="https://img.shields.io/badge/AWS-EventBridge-FF9900?style=flat-square&logo=amazon-aws" alt="EventBridge">
  <img src="https://img.shields.io/badge/Next.js-16-000000?style=flat-square&logo=next.js" alt="Next.js">
  <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square&logo=typescript" alt="TypeScript">
  <img src="https://img.shields.io/badge/Vitest-blue?style=flat-square" alt="Vitest">
  <img src="https://img.shields.io/badge/Playwright-green?style=flat-square" alt="Playwright">
  <img src="https://img.shields.io/badge/Self--Evolving-purple?style=flat-square" alt="Self-Evolution">
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="License MIT">
</p>

<p align="center">
  <font size="6"><strong>The Official ServerlessClaw: Self-Evolving AI Agent Swarm</strong></font><br>
  <em>$0 when idle. Elastic by design. Secure by default.</em><br>
  <strong>Autonomous infrastructure management • AI-powered code evolution • Serverless-first architecture</strong>
  
</p>

<p align="center">
  <a href="https://clawmore.ai">🌐 Website</a> •
  <a href="https://clawmore.ai/signup">🚀 Get Started</a> •
  <a href="https://clawmore.ai/blog">📖 Blog</a> •
  <a href="https://discord.gg/GdEghUdWHS">💬 Discord</a> •
  <a href="https://github.com/serverlessclaw/serverlessclaw/discussions">🗣️ Discussions</a>
</p>

---

> [!IMPORTANT]
> This is the **Official ServerlessClaw Canonical Repository**. For the most up-to-date, secure, and performant implementation of OpenClaw on AWS, use this version.

---

### 💎 The 3 Pillars of ServerlessClaw

| 🚀 **Infinite Scale**                                                                    | 🧠 **Self-Evolution**                                                                                | 🛡️ **Cloud-Native Safety**                                                                |
| :--------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------- |
| **$0 when idle.** Lambda scales to zero. No VPS, no Docker daemon, no 24/7 server costs. | **Council-Verified.** Agents write code, run tests, and redeploy the stack via a peer-reviewed loop. | **Zero Trust.** No SSH keys, no persistent daemons. IAM least-privilege and DMS rollback. |

---

## Why Serverless for AI Agents?

In 2026, **the 24/7 VPS mascot is dead.** Running AI agent swarms on persistent pods is an expensive relic of the container era.

**ServerlessClaw** is the authoritative open-source autonomous agent framework that:

- **💰 Cost Efficient**: You pay exactly for the tokens and compute you use. A complex reasoning task might cost $0.05; staying idle costs **$0**.
- **⚡ Instantly Elastic**: Need 1,000 agents to research a topic in parallel? ServerlessClaw fans out across AWS Lambda instantly.
- **🔧 Maintenance Free**: No Docker security patches, no OS updates, no resource exhaustion. Just pure intelligence.
- **🔒 Secure by Default**: IAM least-privilege, no SSH keys, no persistent daemons.
- **📈 Auto-Scaling**: Scales from 0 to thousands of agents based on demand.

**Use Cases:**

- Autonomous code review and improvement
- Infrastructure monitoring and auto-remediation
- Research and data analysis at scale
- DevOps automation and CI/CD optimization
- Cost optimization for AWS resources

---

## Council-Verified Evolution

Serverless Claw doesn't just execute code; it **improves itself**. But unlike raw autonomous systems, every evolution is gated by a **Council of Agents**.

<p align="center">
  <img src="./apps/dashboard/public/system-pulse.png" alt="ServerlessClaw System Pulse - Real-time Infrastructure Topology" width="800">
</p>

---

## Neural Observation & Trace Intelligence

<p align="center">
  <img src="./apps/dashboard/public/trace-portal.png" alt="ServerlessClaw Trace Portal - Neural Observation and Execution Paths" width="800">
</p>

---

## How It Works

<p align="center">
  <img src="./apps/dashboard/public/chat-interface.png" alt="ServerlessClaw Intelligence Sector - Direct Chat and Mission Control" width="800">
</p>

When you send a message, **SuperClaw** receives it, develops a plan with the **Strategic Planner**, and dispatches tasks to specialized nodes via **EventBridge**. The system implements an **Asynchronous "Pause & Resume"** pattern — agents don't block; they emit a task and terminate, waking up only when a result signal is routed back. High-impact plans are peer-reviewed by the **Council of Agents**, while the **Facilitator** moderates collaborative sessions to drive consensus.

## 🤖 The Multi-Agent Ecosystem

<p align="center">
  <img src="./apps/dashboard/public/agent-registry.png" alt="ServerlessClaw Agent Registry - Autonomous Persona Management" width="800">
</p>

| Agent                   | Responsibilities                                               |
| :---------------------- | :------------------------------------------------------------- |
| **SuperClaw**           | Orchestrator. Interprets intent, delegates tasks, and deploys. |
| **Strategic Planner**   | Designs long-term evolution and expansion plans.               |
| **Coder Agent**         | Writes code, fixes bugs, and performs migrations.              |
| **QA Auditor**          | Verifies the technical satisfaction of every deployment.       |
| **Facilitator**         | Moderates collaboration between multiple agents and humans.    |
| **Cognition Reflector** | Distills memory and identifies system-wide gaps.               |
| **Critic Agents**       | Peer-reviewers for Security, Performance, and Architecture.    |

---

## 🛠️ Capability Matrix

<p align="center">
  <img src="./apps/dashboard/public/capability-library.png" alt="ServerlessClaw Capability Library - Dynamic Tool and Skill Discovery" width="800">
</p>

---

## 🌐 The Agentic Ecosystem

ServerlessClaw is an organism made of specialized interacting repositories. While the Mother Hub (this repo) is the **Brain**, other repositories provide sensory, motor, and nervous connections:

| Repository                                                                                    | Role          | Component                                                     |
| :-------------------------------------------------------------------------------------------- | :------------ | :------------------------------------------------------------ |
| **[cli](https://github.com/serverlessclaw/cli)**                                              | **The Nerve** | **The Synapse**: Connects the Brain to remote Spokes/Clients. |
| **[integration-github](https://github.com/serverlessclaw/serverlessclaw-integration-github)** | **Sensor**    | **The Eyes**: Observes codebases, PRs, and Issue logs.        |
| **[integration-slack](https://github.com/serverlessclaw/serverlessclaw-integration-slack)**   | **Interface** | **The Voice**: Communicates with users and reports health.    |
| **[integration-jira](https://github.com/serverlessclaw/serverlessclaw-integration-jira)**     | **Adapter**   | **The Hands**: Operates within enterprise project structures. |

---

## ⚡️ Quick Start (AWS-Native)

Deploy your first autonomous swarm in 5 minutes.

### 1. Zero-Install Deploy

```bash
git clone https://github.com/serverlessclaw/serverlessclaw.git
cd serverlessclaw && pnpm install
```

### 2. Secure Your Keys

```bash
cp .env.example .env
# Essential: SST_SECRET_OpenAIApiKey & SST_SECRET_TelegramBotToken
```

### 3. Launch Local Dev

```bash
make dev # Live lambda reloading, local DynamoDB, and real-time logs
```

### 4. Deploy to AWS

```bash
make deploy ENV=prod # High-availability, production-grade infrastructure
```

## 📚 Documentation

| Document                                                         | Description                                    |
| ---------------------------------------------------------------- | ---------------------------------------------- |
| **[INDEX.md](./INDEX.md)**                                       | Start here - Documentation hub and context map |
| **[ARCHITECTURE.md](./ARCHITECTURE.md)**                         | System topology and AI-native principles       |
| **[docs/intelligence/AGENTS.md](./docs/intelligence/AGENTS.md)** | Agent roster and evolutionary loop             |
| **[docs/intelligence/MEMORY.md](./docs/intelligence/MEMORY.md)** | Tiered memory engine                           |
| **[docs/intelligence/TOOLS.md](./docs/intelligence/TOOLS.md)**   | Tool registry and MCP standards                |
| **[docs/intelligence/SAFETY.md](./docs/intelligence/SAFETY.md)** | Circuit breakers and rollback safety           |
| **[docs/governance/DEVOPS.md](./docs/governance/DEVOPS.md)**     | DevOps and CI/CD                               |
| **[docs/governance/ROADMAP.md](./docs/governance/ROADMAP.md)**   | Future plans                                   |

## 🌐 Managed Service (ClawMore)

For a fully managed experience with auto-scaling, monitoring, and support, check out **[ClawMore](https://clawmore.ai)** - the premium managed version of ServerlessClaw.

**ClawMore Features:**

- One-click deployment
- Automatic infrastructure management
- AI-powered code evolution
- Real-time monitoring dashboard
- Priority support

## 🆚 The 2026 "Claw" Comparison

| Feature                  | **OpenClaw**          | **NanoClaw**          | **ZeroClaw**          | **Serverless Claw (Us)**                 |
| :----------------------- | :-------------------- | :-------------------- | :-------------------- | :--------------------------------------- |
| _Infrastructure_         |                       |                       |                       |                                          |
| **Architecture**         | Monolithic Node.js    | Micro TypeScript      | Native Rust Binary    | **Event-Driven Serverless (Lambda)**     |
| **Operational Cost**     | High (24/7 Server)    | Moderate (VPS/Docker) | Low (Raspberry Pi)    | **Zero Idle Cost ($0 when not in use)**  |
| **Scalability**          | Manual Cluster        | Docker Swarm          | Hardware-bound        | **Elastic Auto-scale (AWS Native)**      |
| _Agent Runtime_          |                       |                       |                       |                                          |
| **Multi-Agent**          | Basic "Fire & Forget" | Containerized Swarms  | Trait-based Modular   | **Non-blocking (Pause & Resume)**        |
| **Self-Evolution**       | Plugin-based (Static) | Manual (Human-coded)  | Hardware-focused      | **Verified Council-Reviewed Loop**       |
| **Communication Mode**   | Natural Language      | Structured (JSON)     | Low-level Buffers     | **Dual-Mode (Intent-Based JSON + Text)** |
| **Skill Acquisition**    | Static (Hardcoded)    | Static (Hardcoded)    | Static (Config-based) | **Just-in-Time (JIT) Skill Discovery**   |
| _Tooling & Integration_  |                       |                       |                       |                                          |
| **Tooling Architecture** | Static Registry       | Static (JSON)         | Static (Hardcoded)    | **Hub-First Dynamic Discovery**          |
| **MCP Integration**      | Not Supported         | Local Stdio Only      | Low-level C FFI       | **SSE/Stdio Hybrid (Hub-First)**         |
| **Vision Capability**    | OCR / Text-only       | Basic Base64          | Edge Inference        | **S3-mediated Multi-modal Pipeline**     |
| _Memory_                 |                       |                       |                       |                                          |
| **Memory Model**         | SQLite / Local File   | Volatile Cache        | Flash Storage         | **Tiered Memory Engine + Hit Tracking**  |
| **Collaborative Memory** | None (Log-based)      | Minimal (JSON)        | None                  | **ClawCenter Neural Reserve Hub**        |
| _Reliability & Ops_      |                       |                       |                       |                                          |
| **Observability**        | Standard Text Logs    | Container Logs        | Binary Logs           | **Trace Graphs (`ClawTracer`)**          |
| **Resilience**           | Manual Recovery       | Restart Container     | Hardware Watchdog     | **Autonomous Heartbeat + Rollback**      |
| **Resource Safety**      | App-level Permissions | Sandboxing (Docker)   | Memory Safe (Rust)    | **Cloud IAM + Multi-Agent Council**      |

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](./docs/governance/CONTRIBUTING.md) for guidelines.

**Ways to contribute:**

- ⭐ Star the repository
- 🗣️ Participate in **[Discussions](https://github.com/serverlessclaw/serverlessclaw/discussions)**
- 🐛 Report bugs via **GitHub Issues**
- 💡 Suggest new features
- 🔧 Submit pull requests
- 📖 Improve documentation

## 📄 License

MIT License - see [LICENSE](./LICENSE) for details.

---

<p align="center">
  <strong>🌐 <a href="https://clawmore.ai">clawmore.ai</a></strong> •
  <strong>📧 <a href="mailto:support@getaiready.dev">support@getaiready.dev</a></strong> •
  <strong>💬 <a href="https://discord.gg/GdEghUdWHS">Discord Community</a></strong>
</p>
