Konzeptioneller Aufbau: OpenHands und Agent Canvas
Ziel: Die Begriffe einordnen, die in allen Setup-Anleitungen dieses Ordners vorkommen. Was ist OpenHands, was ist Agent Canvas, und wie hängen die Teile zusammen — bevor es ans Installieren geht. Lektüre vor 30 OpenHands auf Windows - Setup und Konfiguration, 40 OpenHands auf Ubuntu 26.04 - Lokal am Laptop und 45 OpenHands auf Linux - Ubuntu 26.04 headless.
OpenHands: das Framework-Projekt
OpenHands (früher OpenDevin, getragen von der Firma All Hands AI) ist ein quelloffenes Projekt mit dem Ziel, einen autonomen Software-Engineering-Agenten und eine offene Agent-Plattform bereitzustellen — vergleichbar mit dem, was OpenAI für LLMs oder Hugging Face für Modelle sein will, aber für Coding-Agenten. Die Kernbausteine:
- Agent-Loop und SDK: Die eigentliche Agent-Logik (Python) — Model-Aufruf, Reasoning, Tool-Auswahl, Memory. Als Python-Bibliothek (SDK) nutzbar, um eigene Agenten zu bauen.
- Agent-Server: Das API-Backend. Verwaltet Konversationen, Persistenz (Sessions überleben Neustarts), Profilspeicher (LLM-Keys, Modelleinstellungen) und stellt die REST-API bereit, gegen die UI und Automatisierungen reden.
- Runtimes/Sandboxes: Die Ausführungsumgebung pro Konversation — dort laufen die Tool-Aufrufe des Agenten (Shell, Dateien, Browser). Im klassischen Deployment ein eigener Docker-Container pro Session, im lokalen Agent-Canvas-Betrieb ein isolierter Prozess-/Containerkontext im Benutzerkonto.
- LLM-Anbindung über LiteLLM: Model-agnostisch — Mistral-Modelle (Devstral, Codestral, Mistral Medium/Large) sind direkt nutzbar (API-Key siehe 00 Mistral-Account und API-Key anlegen).
- Ökosystem: Skills (wiederverwendbare Fähigkeits-Pakete), MCP-Server (Tool-Anbindungen), Plugins, CLI, Automatisierungen.
Agent Canvas: die lokale Distributionsform
Agent Canvas ist kein anderes Produkt, sondern die selbst gehostete, lokale Installationsform von OpenHands — ein npm-Paket (@openhands/agent-canvas), das den kompletten Stack als Einheit ausliefert:
- Canvas-UI: die Web-Oberfläche (Chat, Dateien, Terminal, Browser, Konversationsliste)
- Ingress: einzelner Einstiegspunkt, der
/api/*ans Backend und alles andere an die UI routet - Agent-Server: das oben beschriebene API-Backend (wird vom Launcher mitgeliefert, Versionen pro Release konsistent gebündelt)
- Automations-Dienst: cron- und webhook-getriebene Agent-Läufe ohne offenes UI-Fenster
Die zwei anderen Bezugsformen: OpenHands Cloud ist die gehostete SaaS-Variante (gleiche Engine, jemand anderes betreibt sie), und das SDK ist der Baustein, um Agenten in eigene Anwendungen einzubauen. Agent Canvas steht daneben als die „lokal auf dem eigenen Rechner”-Variante.
Die Begriffe im Überblick
| Begriff | Was es ist | Ebene |
|---|---|---|
| OpenHands | Überbegriff: Projekt, Framework, Marke („Regenschirm”) | Projekt/Ökosystem |
| Agent Canvas | Lokale Distribution als npm-Paket: UI + Ingress + Agent-Server + Automationsdienst | Distribution/Hosting |
| Agent-Server | API-Backend: Konversationen, Persistenz, Profile | Komponente |
| Runtime/Sandbox | Ausführungsumgebung pro Konversation (Shell, Dateien, Tools) | Komponente |
| SDK | Python-Bibliothek, um eigene Agenten auf der Engine zu bauen | Bibliothek |
| OpenHands Cloud | Gehostete Variante (SaaS) | Distribution/Hosting |
Kurzform: OpenHands ist das Projekt, Agent Canvas ist seine lokale Betreiberform. Wer „OpenHands installiert”, meint konkret: Agent Canvas installieren — die Konzepte, die Engine und die Dokumentation darunter bleiben durchgängig OpenHands.
Was das für die Setup-Anleitungen bedeutet
- Alle drei Anleitungen installieren Agent Canvas; die OpenHands-Architektur dahinter ist überall dieselbe, nur der Betriebsumweg unterscheidet sich (Docker Desktop + WSL2, lokaler Desktop, headless Server).
- UI, Konversationen und Profile verhalten sich identisch — unterscheidbar sind nur Erreichbarkeit (Loopback, SSH-Tunnel, Netz) und Absicherung.
- Wer tiefer einsteigen will: Skills und MCP-Server erweitern den Agenten, Automatisierungen lassen ihn nach Zeitplan laufen — alles gegen denselben Agent-Server.
Weiter
- Grundlage: 00 Mistral-Account und API-Key anlegen
- Windows mit Docker Desktop: 30 OpenHands auf Windows - Setup und Konfiguration
- Ubuntu-Laptop mit Desktop: 40 OpenHands auf Ubuntu 26.04 - Lokal am Laptop
- Headless Linux-Server: 45 OpenHands auf Linux - Ubuntu 26.04 headless