friendlyclaw

experimental phase 
# FriendlyClaw 🦀 — Autonomous Hive Operative

<p align="center">
  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License">
  <img src="https://img.shields.io/badge/Edition-Hive-orange.svg" alt="Hive Edition">
  <img src="https://img.shields.io/badge/Memory-Eternal--RAG-green.svg" alt="Memory">
  <img src="https://img.shields.io/badge/Platform-Telegram--CLI-blueviolet.svg" alt="Platforms">
</p>

<p align="center">
  <img src="assets/mascot.png" width="300" alt="FriendlyClaw Mascot">
</p>

<p align="center">
  <strong>Recursive Brain</strong> • <strong>Multi-Agent Swarm</strong> • <strong>Self-Healing Body</strong> • <strong>Eternal Memory</strong>
</p>

<p align="center">
  <strong>The Professional AI Strategic Partner for Elite Operators.</strong><br>
  A unified "Brain & Body" architecture for total system control via CLI or Telegram.
</p>

---

## 🚀 Why FriendlyClaw?

FriendlyClaw is not a "chatbot." It is a **Sovereign Digital Operative**. While standard AI assistants wait for you to type and forget what you said yesterday, FriendlyClaw Hive lives on your system, works while you sleep, and retrieves your entire history semantically.

### 📊 Comparison: Partner vs. Assistant

| Feature | Standard Assistants | **FriendlyClaw Hive** |
| :--- | :--- | :--- |
| **Agency** | Reactive (Waits for input) | **Proactive (Heartbeat + Missions)** |
| **Memory** | Linear (Forgets over time) | **Eternal (SQLite-Vec RAG)** |
| **Execution** | Text-only / Sandbox | **System-Wide (50+ Native Skills)** |
| **Concurrency** | Single-threaded | **Multi-threaded (Swarm Workers)** |
| **Reliability** | Crashes = Manual Restart | **Self-Healing (Watchdog Loop)** |
| **Privacy** | SaaS-owned logs | **100% Local SQLite Brain** |

---

## 💎 Core Hive Capabilities

### 🐝 1. Swarm Commander (Parallel Intelligence)
The Commander Brain (`brain/core/agent.py`) can spawn **Ghost Workers** to handle heavy lifting in the background.
- **Delegate & Continu