Benutzerhandbuch on Runabot Documentation

Erste Schritte

Mon, 01 Jan 0001 00:00:00 +0000

Erste Schritte mit Runabot#

Mit Runabot können Sie KI-Assistenten (Bots) in einer isolierten Umgebung bereitstellen und verwalten.

1. Anmelden#

Öffnen Sie die Runabot-Oberfläche, zum Beispiel https://runabot.de/ui/. Wenn Sie noch nicht angemeldet sind, werden Sie zur Anmeldeseite weitergeleitet. Verwenden Sie eine der Anmeldemethoden, die Ihre Runabot-Umgebung anbietet.

2. Einen Bot bereitstellen#

Klicken Sie im Dashboard auf Neuen Bot bereitstellen.
Geben Sie einen Namen ein, zum Beispiel mein-assistent.
Wählen Sie den Bot-Typ (Chart), zum Beispiel openclaw oder vscode.
Klicken Sie auf Bereitstellen.

Der Bot erscheint anschließend in Ihrer Liste. Die Bereitstellung kann mehrere Minuten dauern. Prüfen Sie Laufzeit- und Bereitstellungsstatus, bevor Sie das Terminal öffnen. Bei Fehlern können Sie die Ereignisse mit dem CLI prüfen.

UI-Referenz

Mon, 01 Jan 0001 00:00:00 +0000

Referenz der Benutzeroberfläche#

Dashboard#

Das Dashboard bietet einen Überblick über Ihre Ressourcen.

Meine Bots: Rasteransicht Ihrer laufenden Bot-Instanzen.
- Statusanzeige: Grün (Running), Orange (Pending), Rot (Failed).
- Löschen: Startet die Löschung des Bots. Sicherung und Bereinigung können den Abschluss verzögern.
- Terminal: Öffnet das Web-Terminal.
Neuen Bot bereitstellen: Öffnet den Bereitstellungsassistenten.

Jede Bot-Karte zeigt unter der letzten Sicherung die gesendeten (↑) und empfangenen (↓) Daten. Die Übersicht Meine Addons zeigt dieselben Werte für jedes Addon. N/A bedeutet, dass kein Messwert vorliegt, nicht dass kein Datenverkehr stattgefunden hat.

Budgets, Traffic-Guthaben und Zahlungsschätzung

Mon, 01 Jan 0001 00:00:00 +0000

Budgets, Traffic-Guthaben und Zahlungsschätzung#

Runabot möchte Ihre Kosten durch Ausgabengrenzen und transparente Zahlungsschätzungen planbar halten. Rechenleistung und Speicher werden anders abgerechnet als Netzwerkverkehr, wie im Folgenden erläutert.

Höchstgrenze für Rechenleistung und Speicher#

Der CPU-, RAM- und Festplattenbetrag auf der Nutzungsseite ist eine maximale wöchentliche Ausgabengrenze. Eine Erhöhung kauft noch nichts. Berechnet werden CPU und RAM laufender Bots und Addons sowie aufbewahrter Speicher. Ungenutzter Spielraum wird nicht berechnet.

Auffüllrate für Traffic-Guthaben#

Jedes Konto erhält ein kostenloses Traffic-Kontingent für gewöhnlichen Hintergrundverkehr wie Healthchecks.

MCP-Proxy-Addon

Mon, 01 Jan 0001 00:00:00 +0000

MCP-Proxy-Addon#

Das MCP-Proxy-Addon ist ein sicheres Gateway und eine Vermittlungsschicht für Model-Context-Protocol-Server (MCP) in Runabot. Es ermöglicht KI-Agenten, Entwickler-Arbeitsumgebungen und autonomen Bots (wie OpenClaw, Codex, Claude Code oder VS Code), auf externe Werkzeuge und APIs zuzugreifen, ohne vertrauliche Zugangsdaten Dritter direkt in der Workload-Umgebung zu speichern.

Warum ein MCP-Proxy?#

In einer KI-Agentenumgebung birgt der direkte Zugriff auf Rohschlüssel von APIs oder unbeschränkte Netzwerk-Endpunkte erhebliche Sicherheitsrisiken. Der MCP-Proxy löst dies durch ein Zero-Trust-Modell:

CLI-Befehlsreferenz

Mon, 01 Jan 0001 00:00:00 +0000

Runabot CLI#

Mit dem Kommandozeilenwerkzeug runabot verwalten Sie Workloads, Addons und Kontonutzung im Terminal oder per Skript. Nutzen Sie es interaktiv, automatisieren Sie Aufgaben in CI/CD-Pipelines oder lassen Sie Ihren KI-Agenten Runabot-Ressourcen in Ihrem Auftrag verwalten.

1. Download & Installation#

Vorkompilierte Binärdateien für Linux, macOS und Windows (jeweils für amd64 und arm64) stehen direkt auf der Downloads-Seite zur Verfügung.

Schnellinstallation#

# Benutzerinstallation (installiert nach ~/.local/bin/):
curl -fsSL __BASE_URL__/downloads/install.sh | sh

# Globale Systeminstallation (installiert nach /usr/local/bin/):
curl -fsSL __BASE_URL__/downloads/install.sh | sudo sh

Alternativ können Sie die Datei manuell von der Downloads-Seite herunterladen und ausführbar machen:

OpenClaw-Leitfaden

Mon, 01 Jan 0001 00:00:00 +0000

Leitfaden für OpenClaw-Bots#

OpenClaw ist ein leistungsstarker persönlicher Assistent, den Sie auf Runabot betreiben können. Dieser Leitfaden beschreibt häufige Aufgaben zur Verwaltung Ihrer OpenClaw-Instanz.

Erstmalige Einrichtung (Onboarding)#

Wenn Sie zum ersten Mal einen OpenClaw-Bot bereitstellen, müssen Sie zunächst das Onboarding durchlaufen, um Ihr Administratorkonto und die Grundeinstellungen einzurichten.

Öffnen Sie das Web-Terminal für Ihren Bot.
Führen Sie den Onboarding-Befehl aus:
```
openclaw onboard
```
Folgen Sie den interaktiven Anweisungen, um:
- Ihren Administrator-Benutzernamen und Ihr Passwort festzulegen.
- Grundlegende Systemeinstellungen zu konfigurieren.
- Die lokale Datenbank zu initialisieren.

Nach Abschluss des Onboardings können Sie sich mit den soeben erstellten Zugangsdaten an der OpenClaw-Weboberfläche anmelden.

Sicherheit

Mon, 01 Jan 0001 00:00:00 +0000

Sicherheitsfunktionen#

Runabots Sicherheitsmodell basiert auf Zero Trust für KI-Agenten und Entwicklungs-Workloads: keine echten Zugangsdaten in der abgeschirmten Ausführungsumgebung, standardmäßig kein externer Netzwerkzugriff und jede wichtige Tool-Grenze wird durch einen Proxy vermittelt.

Diese Seite beschreibt die für Benutzer sichtbaren Sicherheitskontrollen. Eine umfassendere Produktübersicht finden Sie unter Zero-Trust-Ausführungsumgebung für Agenten.

Überblick über die Sicherheitsgrenze#

Bei der Workload kann es sich um einen Coding-Agenten, einen VS-Code-Server, ein Web-Terminal oder ein anderes Entwicklerwerkzeug handeln, das in einem von Runabot verwalteten Container ausgeführt wird. Die Workload verbindet sich nicht direkt mit externen Systemen. Jede Verbindung durchläuft zunächst einen von Runabot verwalteten Proxy, ein Addon oder eine Richtliniengrenze. Dort werden Richtlinien geprüft und Zugangsdaten angewendet, bevor Daten die Umgebung verlassen dürfen.

Workload-Typen

Mon, 01 Jan 0001 00:00:00 +0000

Workload-Typen#

Runabot ist nicht auf eine einzige Bot-Implementierung beschränkt. Es stellt abgeschirmte Ausführungsumgebungen für Agenten, Entwicklungsarbeitsplätze und Automatisierungsjobs bereit, die den benötigten Zugriff ermöglichen, ohne echte Zugangsdaten direkt offenzulegen.

OpenClaw, IronClaw, Hermes#

OpenClaw, IronClaw und Hermes sind sofort einsatzbereite autonome Assistenten für Benutzer, die ohne zusätzliche Einrichtung eine vollständige Agentenumgebung nutzen möchten. Sie eignen sich besonders für Workloads, die hauptsächlich aus einem KI-Assistenten mit eigener Benutzeroberfläche und dauerhaft gespeichertem Zustand bestehen.

Zero-Trust-Ausführungsumgebung

Mon, 01 Jan 0001 00:00:00 +0000

Zero-Trust-Ausführungsumgebung für Agenten#

Runabot ist eine Zero-Trust-Ausführungsumgebung für KI-Agenten, Entwicklungsumgebungen, CI/CD-Jobs und Paket-Builds. Sie stellt benötigte Workloads bereit und verwaltet sie, ohne echte Zugangsdaten oder weitreichenden Netzwerkzugriff innerhalb der Ausführungsumgebung verfügbar zu machen.

Die Ausführungsumgebung richtet sich an KI-Agenten, Entwicklungsumgebungen, CI/CD-Jobs und Paket-Builds, die externe Abhängigkeiten benötigen, ohne dafür echte Tokens offenzulegen.

Entwurfsziel#

Runabot geht davon aus, dass Agenten bösartige Inhalte lesen, fehleranfällige Werkzeuge ausführen und mitunter durch Prompt-Injection-Angriffe oder kompromittierte Abhängigkeiten manipuliert werden.