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

BegriffWas es istEbene
OpenHandsÜberbegriff: Projekt, Framework, Marke („Regenschirm”)Projekt/Ökosystem
Agent CanvasLokale Distribution als npm-Paket: UI + Ingress + Agent-Server + AutomationsdienstDistribution/Hosting
Agent-ServerAPI-Backend: Konversationen, Persistenz, ProfileKomponente
Runtime/SandboxAusführungsumgebung pro Konversation (Shell, Dateien, Tools)Komponente
SDKPython-Bibliothek, um eigene Agenten auf der Engine zu bauenBibliothek
OpenHands CloudGehostete 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