Zum Verständnis des Systems OpenHands/Agent Canvas
OpenHands: Projekt, das den größeren Rahmen bildet
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. Die Kernbausteine des Projekts:
- Agent-Loop und SDK. Die eigentliche Programm-Logik, um einen Agenten zu betreiben; Hauptkomponenten: Datenaustausch mit dem Modell (LLM), Schleifen für das sogen. Reasoning, Auswahl von benötigten Tool, sogen. Memory des Agenten (Notizen, um sich länger erinnern zu können; Gegenmittel für das Problem des begrenzten Kontextfensters). Als Python-Bibliothek (SDK) auch nutzbar, um eigene Agenten zu bauen.
- Agent-Server. Server als Schnittstelle und Schaltzentrale im Hintergrund („API-Backend“). Verwaltet Konversationen, Persistenz (Sessions überleben Neustarts), Profilspeicher (API keys für Zugriff auf LLM-Dienste, Modelleinstellungen) und stellt die Schnittstelle (REST-API) bereit, über die Benutzeroberfläche (UI) und Automatisierungen reden.
- Runtimes/Sandboxes: Die Ausführungsumgebung pro Konversation — dort laufen die Tool-Aufrufe des Agenten, also die Werkzeuge, um mit der „digitalen Umwelt“ zu interagieren (Dateien, Browser, Kommandozeilen-Tools). Hier gibt es unterschiedliche Varianten: a) Bei der klassischen Installation läuft eine eigene Sandbox (Docker-Container) pro Chat-Session. b) Im lokalen Betrieb mit Agent Canvas jeweils ein isolierter Prozess-/Containerkontext im Benutzerkonto.
- LLM-Anbindung über LiteLLM. Standardisierte Schnittstelle um mit verschiedene LLMs einzubinden, lokal oder von einem Dienstleister über’s Internet. Mistral-Modelle (Mistral Medium/Large, Mistral GLM-5.3) sind direkt nutzbar man benötigt dazu nur einen API-Key und ggf. die richtige URL (siehe auch Anleitung Mistral-Account und API-Key). Funktioniert aber auch mit vielen anderen Anbietern oder einem “Zwischenhändler” wie z.B. OpenRouter.
- Ökosystem.
- Skills: wiederverwendbare Fähigkeits-Pakete
- System für Automatisierungen.
- MCP-Server: Externe Tools anbinden, z.B. GoogleDrive.
- Plugins.
Agent Canvas: TODOS die lokale Distributionsform
Agent Canvas ist extra Produkt, sondern das Paket oder auch die „Installationsform“ von OpenHands, die man betreiben kann. Es kommt als sogenanntes npm-Paket mit dem Namen @openhands/agent-canvas. Dieses liefert den kompletten „Stack“ (engl. für Stapel) mit, also alle benötigten Module:
- Benutzerschnittstelle Canvas (UI). Die Web-Oberfläche, über die man den Agenten nutzt, also die Oberfläche für Chats, die Liste der laufenden und vergangenen Chats, einen Dateien-Explorer, Ansicht des Webbrowsers und Terminals des Agenten.
- Schnittstelle (Ingress). Drehscheibe, die Datenverbindungen zwischen 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: Anleitung Mistral-Account und API-Key
- Windows mit Docker Desktop: Anleitung OpenHands auf Windows-Laptop