# Plattformuebersicht

## Was ist Neotask?

Das **Gateway** ist die Kern-Engine, die Neotask antreibt. Es ist ein einzelner dauerhaft laufender Dienst, der alles verwaltet: Agent-Sessions, Messaging-Integrationen, Tool-Ausfuehrung, geplante Automatisierungen und Geraeteverbindungen.

Stellen Sie es sich als das Gehirn vor, mit dem sich Ihre Neotask Desktop-App, Mobile-Apps und das Web-Dashboard verbinden. Waehrend Sie ueber diese Oberflaechen interagieren, erledigt das Gateway die schwere Arbeit im Hintergrund.

## Architektur

Neotask verwendet ein Hub-and-Spoke-Modell:

- **Das Gateway** ist der zentrale Hub -- ein WebSocket-Server, der auf Ihrem Rechner (oder in der Cloud) laeuft. Es verwaltet alle Agent-Sessions, leitet Nachrichten zwischen Kanaelen weiter, orchestriert die Tool-Ausfuehrung und speichert den Status persistent.
- **Clients** (die Desktop-App, Mobile-Apps, das Web-Dashboard oder das Terminal) verbinden sich mit dem Gateway und senden/empfangen Nachrichten darueber.
- **Nodes** (Begleit-Apps auf iOS, Android, macOS) stellen Geratefaehigkeiten bereit -- Kamera, Canvas, Bildschirmaufnahme, Standort und Sprache -- fuer Agenten, die auf dem Gateway laufen.
- **Channels** (WhatsApp, Telegram, Discord, Slack usw.) sind Messaging-Transporte, mit denen sich das Gateway zum Senden und Empfangen von Nachrichten verbindet.

Alle KI-Operationen gehen durch die Gateway-zu-LLM-Anbieter-Pipeline. Die Desktop-App ruft nie direkt ein LLM auf.

## Hauptfaehigkeiten

### Multi-Channel-Messaging
Verbinden Sie sich gleichzeitig mit ueber 20 Messaging-Plattformen. Ihre Agenten koennen Nachrichten auf WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Google Chat, Microsoft Teams, Matrix, IRC und mehr senden und empfangen -- alles von einer einzigen Gateway-Instanz. Siehe [Channels](channels.md).

### Multi-Agent-System
Betreiben Sie mehrere isolierte Agenten, jeder mit eigenem Workspace, Persoenlichkeit, Modellkonfiguration und Channel-Bindungen. Leiten Sie eingehende Nachrichten von bestimmten Kanaelen, Servern oder Kontakten automatisch an den richtigen Agenten weiter. Siehe [Agents](agents.md).

### Geratefaehigkeiten ueber Nodes
Verbinden Sie iOS-, Android- und macOS-Begleit-Apps als "Nodes", die Geraetehardware fuer Ihre Agenten bereitstellen. Agenten koennen Fotos machen, Video aufnehmen, den Bildschirm aufzeichnen, den GPS-Standort ermitteln, interaktive Canvas-Inhalte rendern und Systembefehle ausfuehren -- alles in natuerlicher Sprache. Siehe [Begleit-Apps](companion-apps.md).

### Browser-Automatisierung
Agenten koennen einen vollstaendigen Chromium-Browser steuern -- Seiten oeffnen, Elemente anklicken, Formulare ausfuellen, Screenshots machen, Inhalte extrahieren, Dateien hochladen und JavaScript ausfuehren. Mehrere Browserprofile werden fuer Konto-Isolation unterstuetzt. Siehe [Tools & Faehigkeiten](tools-capabilities.md).

### Canvas & A2UI
Das Agent-to-UI (A2UI)-System ermoeglicht es Agenten, interaktive visuelle Inhalte auf verbundenen Geraeten zu rendern. Agenten koennen Webseiten praesentieren, strukturierte UI-Updates senden, JavaScript im Canvas-Kontext ausfuehren und Schnappschuesse des Angezeigten machen. Siehe [Tools & Faehigkeiten](tools-capabilities.md).

### Flexible Modellunterstuetzung
Verwenden Sie jeden grossen LLM-Anbieter -- Anthropic (Claude), OpenAI (GPT), Google (Gemini), Together AI, Moonshot, OpenRouter und mehr. Konfigurieren Sie Modell-Fallback-Ketten, Aliase und Pro-Agent-Modelluebersteuerungen. Fuehren Sie lokale Modelle ueber Ollama oder vLLM aus. Siehe [Modelle & Anbieter](models-providers.md).

### Plugin- & Skill-Oekosystem
Erweitern Sie Neotask mit Plugins, die neue Kanaele, Tools, RPC-Methoden und Faehigkeiten hinzufuegen. Durchsuchen Sie die verfuegbaren Skills im [Skills-Katalog](/skills). Erstellen Sie eigene Skills, um Agenten neue Workflows beizubringen. Siehe [Plugins & Skills](plugins-skills.md).

### Planung & Automatisierung
Planen Sie Agenten-Weckrufe mit Cron-Ausdruecken, einmaligen Erinnerungen oder intervallbasierten Triggern. Agenten koennen automatisierte Aufgaben ausfuehren, Ergebnisse an Kanaele liefern oder an Webhooks senden. Siehe [Automatisierung](automation.md).

### Sprachinteraktion
Verwenden Sie Aktivierungswoerter, um Ihren Agenten per Sprache zu aktivieren. Der Talk-Modus ermoeglicht kontinuierliche Sprachkonversationen mit Echtzeit-Speech-to-Text und Text-to-Speech (ElevenLabs, OpenAI). Der Swabble-Daemon auf macOS bietet jederzeit aktive, geraetelokale Spracherkennung. Siehe [Sprache](voice.md).

### Session-Intelligenz
Sessions setzen sich taeglich automatisch zurueck, komprimieren sich bei Annaeherung an Kontextlimits und ueberdauern Neustarts. Die Speichersuche ermoeglicht es Agenten, Informationen aus frueheren Gespraechen mittels Vektoraehnlichkeit abzurufen. Siehe [Sessions & Speicher](sessions-memory.md).

### Selbstgehostet & Privat
Alles laeuft auf Ihrer Infrastruktur. Ihre Nachrichten, API-Schluessel und Agentendaten verlassen nie Ihre Rechner, es sei denn, Sie konfigurieren explizit einen externen Dienst. Das Gateway bindet standardmaessig an localhost -- null externe Netzwerkexposition.

### Sandbox-Ausfuehrung
Fuehren Sie Agentenbefehle in isolierten Docker-Containern mit konfigurierbaren Ressourcenlimits, Netzwerk-Policies und Dateisystembeschraenkung aus. Pro-Agent-Sandbox-Profile ermoeglicht Ihnen die praezise Kontrolle, worauf jeder Agent Zugriff hat. Siehe [Sicherheit](security.md).

## Wie alles zusammenhaengt

1. **Sie** interagieren mit Ihren Agenten ueber die Neotask Desktop-App, eine mobile Begleit-App oder direkt ueber Messaging-Plattformen wie WhatsApp oder Telegram.
2. **Das Gateway** empfaengt Ihre Nachricht, leitet sie an den richtigen Agenten weiter und startet einen KI-Durchlauf.
3. **Der Agent** verarbeitet Ihre Anfrage mit dem konfigurierten LLM (Claude, GPT usw.), ruft alle benoetigten Tools auf (Browser, Canvas, Dateioperationen, Shell-Befehle) und generiert eine Antwort.
4. **Die Antwort** wird ueber denselben Kanal an Sie zurueckgeliefert, oder auf einem anderen Kanal angekuendigt, falls konfiguriert.
5. **Der Status** (Session-Transkripte, Agent-Konfiguration, geplante Jobs) wird lokal persistent gespeichert, sodass alles Neustarts uebersteht.