KI-Agenten zu verwalten bedeutet meist, mit Terminalfenstern, SSH-Sitzungen und verstreuten Konfigurationsdateien zu kämpfen. Office Claws ersetzt all das durch eine einzige CLI — dazu kommt eine Desktop-App mit einem Pixel-Art-Büro, in dem jeder Agent an seinem eigenen Schreibtisch sitzt. Jeder Agent läuft auf einem VPS in Ihrem eigenen Contabo-Konto und spricht über Ihr eigenes Tailscale-Netzwerk mit Ihrem Rechner. Diese Anleitung führt Sie durch jeden Schritt — von der Installation der CLI bis zum ersten Chat mit Ihrem Agenten.
Was Sie vor dem Start benötigen
Legen Sie Folgendes bereit, bevor Sie beginnen. So dauert die Einrichtung nur wenige Minuten.
Konten und Zugangsdaten
- Ein Office Claws-Abo. Es gibt einen Tarif, Self-Hosted, für 4,99 $/Monat. Ein aktives Abo ist Voraussetzung für die Bereitstellung eines Agenten — Sie schließen es in Schritt 2 direkt über die CLI ab.
- Ein Contabo-Konto mit einem VPS. Ihr Agent läuft auf einem VPS in Ihrem eigenen Contabo-Konto, den Sie direkt bei Contabo bezahlen — ein kleiner VPS kostet ein paar Euro im Monat. Bestellen Sie den VPS bei Contabo, bevor Sie das Onboarding starten. Office Claws betreibt einen Agenten pro VPS.
- Contabo-API-Zugangsdaten. Öffnen Sie my.contabo.com/api/details und notieren Sie Client ID und Client secret (unter „API Data"), Ihren API user (Ihre Contabo-Login-E-Mail) und Ihr API password. Das API-Passwort ist nicht Ihr Website-Login-Passwort — falls Sie noch keines gesetzt haben, klicken Sie auf dieser Seite auf „Set password".
- Ein Tailscale-Konto und ein Auth-Key. Tailscale baut das verschlüsselte Netzwerk zwischen Ihrem Rechner und dem VPS Ihres Agenten auf. Erstellen Sie ein kostenloses Konto auf tailscale.com und generieren Sie in der Admin-Konsole unter Settings > Keys > Generate auth key einen Auth-Key.
- Ein ChatGPT-Abo mit Codex. Ihr Agent läuft auf Ihrem eigenen OpenAI-Codex-Abo (ChatGPT), das Sie in Schritt 5 per Browser-Anmeldung verbinden. Ein API-Schlüssel ist nicht nötig.
- Ein Rechner mit macOS oder Linux, auf dem Tailscale installiert und verbunden ist. Die CLI erreicht Ihre Agenten über Ihr Tailnet.
Starte deinen ersten Agenten in etwa 3 Minuten
Installiere die Office Claws CLI, verbinde dein Contabo-Konto und dein Codex-Abo – dein Agent bekommt einen eigenen VPS und einen Schreibtisch im Büro.
curl -fsSL https://officeclaws.com/downloads/install.sh | sh$4.99/Monat + dein eigener Contabo-VPS · Schlüssel bleiben in deinem Schlüsselbund
So funktioniert die Preisgestaltung
Office Claws hat einen einzigen Tarif: Self-Hosted, 4,99 $/Monat. Er umfasst die CLI, die Desktop-App mit dem Pixel-Art-Büro, Echtzeit-Chat mit Agenten, Logs, geplante Jobs und Kanäle wie Telegram. Die Infrastruktur bleibt Ihre: Der VPS liegt in Ihrem Contabo-Konto und wird von Contabo abgerechnet, und das Modell läuft auf Ihrem eigenen Codex-Abo.
Es gibt keine kostenlose Testphase — vor der Bereitstellung ist ein aktives Abo erforderlich. Erstattungen regelt unsere Rückerstattungsrichtlinie.
Schritt 1: Die CLI installieren
Installieren Sie die officeclaws-CLI mit einem einzigen Befehl:
curl -fsSL https://officeclaws.com/downloads/install.sh | shPrüfen Sie mit officeclaws version, ob sie in Ihrem PATH liegt. Lieber eine grafische Oberfläche? Die Desktop-App mit dem Pixel-Art-Büro gibt es auf der Startseite; sie arbeitet mit demselben Konto und denselben Agenten.
Schritt 2: Konto erstellen und abonnieren
officeclaws register # oder: officeclaws login
officeclaws subscriberegister legt Ihr Office Claws-Konto mit E-Mail und Passwort an; mit login melden Sie sich an, wenn Sie bereits eines haben. subscribe öffnet den Checkout in Ihrem Browser (kann kein Browser geöffnet werden, gibt der Befehl den Link zum Kopieren aus). Sobald die Zahlung durch ist, kann Ihr Konto Agenten bereitstellen.
Schritt 3: Den ersten Agenten onboarden
officeclaws onboard --name MonaDas Onboarding ist interaktiv. Es:
- Prüft, ob Ihr Abo aktiv ist. Falls nicht, verweist es Sie auf
officeclaws subscribe. - Fragt Ihre vier Contabo-API-Zugangsdaten ab und validiert sie. Sie werden im Schlüsselbund Ihres Betriebssystems gespeichert, Sie geben sie also nur einmal ein.
- Fragt Ihren Tailscale-Auth-Key ab, der ebenfalls im Schlüsselbund landet.
- Erzeugt einen SSH-Schlüssel, mit dem die CLI Ihre Agenten erreicht.
- Synchronisiert die VPS in Ihrem Contabo-Konto und lässt Sie den auswählen, der zum Agenten werden soll.
Ohne --name fragt das Onboarding nach dem Namen. Zwei optionale Flags personalisieren den Agenten: --comm-style friendly|business|creative legt den Tonfall fest, --avatar wählt einen der 12 Pixel-Art-Avatare für das Desktop-Büro. Zu jeder Abfrage gibt es auch ein Flag (--contabo-client-id, --tailscale-authkey, --vps usw.), sodass das Onboarding komplett nicht-interaktiv laufen kann — officeclaws help listet alle auf.
Schritt 4: Die Bereitstellung verfolgen
Nachdem Sie einen VPS gewählt haben, stellt Office Claws ihn bereit und streamt den Fortschritt direkt in Ihr Terminal, während es:
- Den Agenten aus einem vorgefertigten Office Claws-Image installiert.
- Den VPS mit Ihrem Tailscale-Netzwerk verbindet.
- Den Server härtet und die Agenten-Laufzeitumgebung in Docker startet.
- Das Agenten-Gateway einrichtet, das nur über Ihr Tailnet erreichbar ist.
Der gesamte Vorgang dauert etwa 2 bis 3 Minuten. Das Image enthält bereits alles, was der Agent braucht, sodass der Server keine Pakete von Grund auf installieren muss — genau das hält die Bereitstellung schnell. Am Ende gibt die CLI Ihre nächsten zwei Befehle aus.
Liegen auf dem VPS bereits Daten, die Sie ersetzen möchten, löscht --reinstall ihn und installiert ihn aus dem Office Claws-Image neu. Nutzen Sie das nur auf einem Server, den Sie bedenkenlos löschen können.
Schritt 5: Ihr Codex-Abo verbinden
officeclaws connect-codexDamit öffnet sich die Anmeldeseite von OpenAI in Ihrem Browser (oder der Link wird ausgegeben). Melden Sie sich mit dem ChatGPT-Konto an, das Codex hat; die CLI wartet, bis Sie fertig sind (bis zu fünf Minuten), und bestätigt, sobald Ihr Agent auf Ihrem Abo läuft. Codex ist der unterstützte Modellweg für Office Claws-Agenten — Claude Code und andere Anthropic-Abos werden nicht unterstützt.
Schritt 6: Mit Ihrem Agenten chatten
officeclaws chatDas öffnet einen interaktiven Chat mit Ihrem primären Agenten (Strg-D zum Beenden). Mit officeclaws chat -m "..." senden Sie eine einzelne Nachricht, mit --agent <id> sprechen Sie einen bestimmten Agenten an, officeclaws agents listet Ihre Agenten und officeclaws logs --follow streamt die Logs eines Agenten.
Probieren Sie diese ersten Nachrichten, um Ihre Einrichtung zu testen:
- „Wobei kannst du mir helfen?"
- „Fasse dieses Dokument für mich zusammen: [Text einfügen]"
- „Prüfe diesen Code auf Fehler: [Code einfügen]"
In der Desktop-App erscheint derselbe Agent an einem Schreibtisch im Pixel-Art-Büro — klicken Sie auf seine Figur, um das Chat-Panel zu öffnen. Es behält den gesamten Verlauf, sodass Sie dort weitermachen können, wo Sie aufgehört haben.
Das Pixel-Art-Büro verstehen
Wenn Sie die Desktop-App nutzen, ist das Büro mehr als eine optische Spielerei. Es gibt Ihnen einen Statusüberblick über alle Ihre Agenten auf einen Blick:
- Am Schreibtisch tippend — Der Agent verarbeitet aktiv Anfragen oder ist verfügbar.
- Kaffee holend — Der Agent befindet sich in einem kurzen Leerlaufzyklus.
- Auf dem Sofa ruhend — Der Agent befindet sich in einem längeren Ruhezustand.
- Im Offline-Bereich sitzend — Der VPS des Agenten ist nicht erreichbar.
Wenn Sie weitere Agenten hinzufügen, bekommt jeder einen Schreibtisch im Büro zugewiesen. Das Layout unterstützt bis zu sechs Schreibtische im Hauptraum, einen Schreibtisch im Nebenbüro und Sitzgelegenheiten in den Pausenbereichen.
So bleiben Ihre Zugangsdaten sicher
Sicherheit ist ein häufiges Anliegen, wenn ein Tool auf Ihre Cloud- und KI-Konten zugreift. So handhabt Office Claws das Thema:
- Speicherung im lokalen Schlüsselbund. Ihre Contabo-API-Zugangsdaten, Ihr Tailscale-Auth-Key und Ihre CLI-Sitzung liegen im Schlüsselbund Ihres Betriebssystems, nicht auf Office Claws-Servern. Geheime Werte werden nie ausgegeben — Auflistungen zeigen nur maskierte Vorschauen.
- Ihr eigenes Netzwerk. CLI und Desktop-App erreichen Ihren Agenten per SSH über Ihr Tailscale-Netzwerk. Die SSH-, HTTPS- und Gateway-Ports des Agenten sind nur in Ihrem Tailnet offen.
- Ihr eigenes Abo. Die Codex-Anbindung nutzt den Anmeldeablauf von OpenAI: Sie melden sich auf der Seite von OpenAI an, und kein API-Schlüssel wird herumkopiert. Die daraus entstehende Anmeldung liegt auf dem VPS Ihres Agenten.
- Direkte Verbindung. Chat und Logs laufen über Ihr Tailnet direkt zwischen Ihrem Rechner und Ihrem Agenten. Sobald Sie
officeclaws connect-codexausgeführt haben, gehen Modellanfragen vom VPS Ihres Agenten direkt zu OpenAI; davor läuft ein kleines Startkontingent über das Office Claws LLM-Gateway. Office Claws speichert eine Kopie Ihres Chatverlaufs in Ihrem Konto; die Sicherheitsseite listet genau auf, was gespeichert wird.
Was Office Claws automatisiert: Die manuelle Einrichtung, die Sie überspringen
Um den Wert der Bereitstellung per einzigem Befehl zu verstehen, hilft es zu sehen, wie die manuelle Einrichtung eines sicheren KI-Agenten-VPS aussieht. Nachfolgend sind alle Schritte aufgeführt, die Office Claws automatisch im Hintergrund erledigt. Wenn Sie dies selbst durchführen würden, planen Sie 45 Minuten bis eine Stunde Terminal-Arbeit pro Server ein — vorausgesetzt, jeder Befehl funktioniert beim ersten Versuch.
Server erstellen und darauf zugreifen
Manuell würden Sie sich bei Ihrem Cloud-Anbieter (Contabo, Hetzner, DigitalOcean oder einem anderen) anmelden, einen Ubuntu-24.04-Server erstellen, auf den Start warten und sich als Root per SSH verbinden. Außerdem müssen Sie ein SSH-Schlüsselpaar generieren, den öffentlichen Schlüssel hochladen und die Verbindung bestätigen.
Einen Nicht-Root-Benutzer erstellen
Dienste als Root auszuführen ist ein Sicherheitsrisiko. Sie müssten einen dedizierten Benutzer erstellen, ihn zur sudo-Gruppe hinzufügen, Ihren öffentlichen SSH-Schlüssel in dessen authorized_keys-Datei kopieren und die korrekten Dateiberechtigungen setzen (700 für das .ssh-Verzeichnis, 600 für die Schlüsseldatei). Dann konfigurieren Sie passwortlosen sudo-Zugriff für bestimmte Befehle — Firewall, Tailscale und Docker — damit der Agenten-Prozess diese Dienste ohne volle Root-Privilegien verwalten kann.
SSH härten
Standardmäßig erlaubt SSH auf einem frischen Ubuntu-Server Root-Login und Passwort-Authentifizierung — beides sind häufige Angriffsvektoren. Sie müssen eine Härtungskonfiguration erstellen, die all dies deaktiviert:
- Root-Login (
PermitRootLogin no) - Passwort-Authentifizierung (
PasswordAuthentication no) - Challenge-Response-Authentifizierung
- X11 Forwarding
- Agent Forwarding
Anschließend validieren Sie die Konfigurationssyntax mit sshd -t und starten den SSH-Dienst neu. Ein einziger Tippfehler in dieser Datei, und Sie sperren sich vom Server aus.
Firewall installieren und konfigurieren
Als Nächstes installieren Sie ufw (Uncomplicated Firewall) und setzen eine Standardrichtlinie, die allen eingehenden Verkehr blockiert. Sie erlauben temporär SSH auf allen Interfaces, um Ihre Verbindung nicht zu verlieren, und beschränken dann — nachdem Tailscale läuft — SSH, HTTPS und den Agent-Gateway-Port (18789) auf das Tailscale-Interface und löschen die öffentliche SSH-Regel. Der finale Firewall-Zustand:
- Gesamter eingehender Verkehr standardmäßig blockiert
- Port 22 (SSH): nur über Tailscale erlaubt
- Port 443 (HTTPS): nur über Tailscale erlaubt
- Port 18789 (Agent-Gateway): nur über Tailscale erlaubt
- Gesamter ausgehender Verkehr erlaubt
Wenn Sie die Reihenfolge der Operationen falsch ausführen — SSH einschränken, bevor Tailscale läuft — verlieren Sie den Zugang zum Server vollständig.
Intrusion Prevention einrichten
Installieren und aktivieren Sie fail2ban, das Authentifizierungsprotokolle überwacht und IP-Adressen vorübergehend sperrt, die Brute-Force-Anmeldemuster aufweisen. Dies fügt eine zusätzliche Verteidigungsebene hinzu, selbst wenn SSH durch eine Fehlkonfiguration öffentlich zugänglich wird.
Automatische Sicherheitsupdates aktivieren
Installieren Sie unattended-upgrades und apt-listchanges und konfigurieren Sie diese mit dpkg-reconfigure. Dies stellt sicher, dass der Server Sicherheitspatches automatisch ohne manuelles Eingreifen anwendet. Wenn Sie diesen Schritt überspringen, fällt Ihr Server innerhalb weniger Wochen bei den Patches zurück.
Swap-Speicher zuweisen
Erstellen Sie eine 2 GB große Swapfile unter /swapfile, setzen Sie die Berechtigungen auf 600, formatieren Sie sie mit mkswap, aktivieren Sie sie mit swapon und fügen Sie sie zur /etc/fstab hinzu, damit sie Neustarts übersteht. Ohne Swap kann ein Speicherspitzenbedarf im Agenten-Prozess den Container beenden oder den Server zum Absturz bringen.
Tailscale installieren und konfigurieren
Installieren Sie Tailscale über das offizielle Installationsskript, starten Sie es mit Ihrem Auth-Key und einem Hostnamen, warten Sie auf die IP-Zuweisung (bis zu 60 Sekunden), setzen Sie den Operator auf Ihren Nicht-Root-Benutzer, fordern Sie ein TLS-Zertifikat an und aktivieren Sie HTTPS-Serving auf dem Agent-Gateway-Port. Dies erstellt den verschlüsselten Tunnel, der die öffentliche Internet-Exposition für die gesamte Agenten-Kommunikation ersetzt.
Docker installieren und das Agenten-Image laden
Installieren Sie Docker über das offizielle Installationsskript, fügen Sie Ihren Nicht-Root-Benutzer zur Docker-Gruppe hinzu, authentifizieren Sie sich bei der Container-Registry falls nötig und laden Sie das Agenten-Laufzeit-Image vorab herunter. Starten Sie dann den Container mit den korrekten Umgebungsvariablen, Speicherlimits (1800 MB mit 2 GB Swap), Host-Networking, einem persistenten Volume und einer Restart-Richtlinie, damit er Neustarts übersteht.
Den Modellanbieter anbinden
Konfigurieren Sie den Modellzugang des Agenten — einen API-Schlüssel, der als Umgebungsvariable an den Container übergeben wird, oder eine Abo-Anmeldung wie bei Codex — und richten Sie das Gateway mit WebSocket-Konnektivität, TLS und Operator-Berechtigungen ein. Warten Sie dann, bis das Gateway initialisiert ist, und extrahieren Sie das Authentifizierungs-Token aus den Container-Logs.
Alles überprüfen
Bestätigen Sie, dass die Firewall-Regeln korrekt sind, Tailscale verbunden ist, der Docker-Container läuft, der Agent über das Gateway antwortet und Ihr lokaler Rechner ihn über das Tailscale-Netzwerk erreichen kann. Aktualisieren Sie Ihre lokale SSH-Konfiguration und known_hosts für bequemen Zugriff in der Zukunft.
Was das alles zusammen ergibt
Hier ist die vollständige Liste der Pakete und Dienste, die auf jedem Office Claws-Agenten-VPS konfiguriert werden:
| Komponente | Zweck |
|---|---|
ufw | Firewall mit Tailscale-exklusiven Zugriffsregeln |
fail2ban | Brute-Force-Intrusion-Prevention |
unattended-upgrades | Automatische Sicherheitspatches |
| SSH-Härtungskonfiguration | Deaktiviert Root-Login, Passwörter, Forwarding |
| Tailscale | Verschlüsseltes Netzwerk und TLS-Zertifikate |
| Docker | Containerisierte Agenten-Laufzeitumgebung mit Speicherlimits |
| 2 GB Swap | Schutz vor Speicherüberlauf |
| Nicht-Root-Benutzer mit eingeschränktem sudo | Prinzip der minimalen Rechtevergabe |
Das sind acht Sicherheitsebenen, konfiguriert über rund 20 manuelle Schritte, jeder mit eigenen Fehlerquellen. Verfehlen Sie die Firewall-Reihenfolge, und Sie sperren sich aus. Vergessen Sie Swap, und der Agent stürzt unter Last ab. Überspringen Sie unattended-upgrades, und Ihr Server sammelt Schwachstellen an. Konfigurieren Sie die SSH-Härtung falsch, und Sie lassen die Tür offen — oder schließen sie vor sich selbst.
Mit Office Claws führen Sie officeclaws onboard aus, verfolgen zwei bis drei Minuten lang den Fortschritt und erhalten alles — gehärtet, getestet und verbunden. Die Image-basierte Bereitstellung bedeutet, dass jeder Server von einem vorgefertigten, verifizierten Image startet, sodass es keine Abweichung zwischen dem gibt, was Sie erwarten, und dem, was Sie bekommen.
Häufige Probleme bei der Einrichtung beheben
„No active subscription"
Das Onboarding bricht ab, wenn Ihr Konto kein aktives Abo hat. Führen Sie officeclaws subscribe aus, schließen Sie den Checkout ab und starten Sie officeclaws onboard erneut.
Contabo-Zugangsdaten werden abgelehnt
Prüfen Sie alle vier Werte auf my.contabo.com/api/details. Der häufigste Fehler ist, das Website-Login-Passwort statt des API-Passworts einzugeben. Haben Sie noch nie ein API-Passwort gesetzt, holen Sie das auf dieser Seite zuerst nach.
„No VPSes found on your account"
Das Onboarding macht aus einem VPS, der bereits in Ihrem Contabo-Konto existiert, einen Agenten. Bestellen Sie einen VPS bei Contabo, warten Sie, bis er läuft, und starten Sie officeclaws onboard erneut.
Die Bereitstellung dauert länger als erwartet
Die Bereitstellung dauert normalerweise 2 bis 3 Minuten. Geht es deutlich langsamer, richtet Contabo den Server womöglich noch ein — prüfen Sie seinen Status im Contabo-Control-Panel. Ein Lauf mit --reinstall dauert länger, weil Contabo den Server zuerst neu aufsetzen muss. Schlägt die Bereitstellung fehl, gibt die CLI den Fehler aus, officeclaws agents zeigt den Status des Agenten, und die vollständigen Logs liegen in ~/.openclaw/logs.
Tailscale-Auth-Key wird abgelehnt
Stellen Sie sicher, dass der Schlüssel nicht abgelaufen ist und — falls er nur einmal verwendbar ist — noch nicht benutzt wurde. Generieren Sie in der Tailscale-Admin-Konsole einen neuen und übergeben Sie ihn mit officeclaws onboard --tailscale-authkey <key>.
Agent erscheint offline oder der Chat verbindet nicht
Überprüfen Sie, ob Tailscale auf Ihrem Rechner läuft. chat und logs erreichen den Agenten über Ihr Tailnet, daher müssen beide Seiten verbunden sein. Öffnen Sie die Tailscale-App und bestätigen Sie, dass Ihr Gerät als „Connected" angezeigt wird.
Wie es weitergeht
Sobald Ihr erster Agent läuft:
- Fügen Sie weitere Agenten hinzu. Jeder Agent bekommt seinen eigenen VPS und Schreibtisch im Büro. Bestellen Sie einen weiteren VPS bei Contabo und führen Sie
officeclaws onboarderneut aus. - Planen Sie wiederkehrende Aufgaben.
officeclaws cron addrichtet geplante Jobs ein, und mitofficeclaws telegram setsprechen Sie Ihren Agenten über Telegram an. - Erkunden Sie Agenten-Personas. Verschiedene
--comm-style-Einstellungen erzeugen merklich unterschiedliche Interaktionsmuster.
Die Einrichtung von Office Claws dauert nur wenige Minuten, aber das Ergebnis ist ein dauerhafter KI-Arbeitsplatz, der weiterläuft, ob Ihr Terminal oder die App geöffnet ist oder nicht. Ihre Agenten arbeiten weiter auf ihrem VPS, und Sie verbinden sich, wann immer Sie sie brauchen.