Office Claws einrichten: Eine vollständige Schritt-für-Schritt-Anleitung

Office Claws einrichten: Eine vollständige Schritt-für-Schritt-Anleitung — Erfahren Sie, wie Sie Office Claws einrichten und in wenigen Minuten einen sicheren KI-Agenten auf Ihrem eigenen Contabo-VPS bereitstellen. CLI-Installation, Abo, Contabo- und Tailscale-Zugangsdaten, Bereitstellung, Codex-Anbindung und automatisierte Sicherheit inklusive.
15. Apr. 202613 Min. Lesezeit
Share with

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.

Setup flow: Download, Register, Configure, Provision, Chat

Schritt 1: Die CLI installieren

Installieren Sie die officeclaws-CLI mit einem einzigen Befehl:

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

Prü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 subscribe

register 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 Mona

Das Onboarding ist interaktiv. Es:

  1. Prüft, ob Ihr Abo aktiv ist. Falls nicht, verweist es Sie auf officeclaws subscribe.
  2. 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.
  3. Fragt Ihren Tailscale-Auth-Key ab, der ebenfalls im Schlüsselbund landet.
  4. Erzeugt einen SSH-Schlüssel, mit dem die CLI Ihre Agenten erreicht.
  5. 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:

  1. Den Agenten aus einem vorgefertigten Office Claws-Image installiert.
  2. Den VPS mit Ihrem Tailscale-Netzwerk verbindet.
  3. Den Server härtet und die Agenten-Laufzeitumgebung in Docker startet.
  4. 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-codex

Damit ö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 chat

Das ö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:

Agent states: Typing, Coffee, Resting, Offline

  • 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:

  1. 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.
  2. 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.
  3. 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.
  4. Direkte Verbindung. Chat und Logs laufen über Ihr Tailnet direkt zwischen Ihrem Rechner und Ihrem Agenten. Sobald Sie officeclaws connect-codex ausgefü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:

All 8 security layers automated by Office Claws

KomponenteZweck
ufwFirewall mit Tailscale-exklusiven Zugriffsregeln
fail2banBrute-Force-Intrusion-Prevention
unattended-upgradesAutomatische Sicherheitspatches
SSH-HärtungskonfigurationDeaktiviert Root-Login, Passwörter, Forwarding
TailscaleVerschlüsseltes Netzwerk und TLS-Zertifikate
DockerContainerisierte Agenten-Laufzeitumgebung mit Speicherlimits
2 GB SwapSchutz vor Speicherüberlauf
Nicht-Root-Benutzer mit eingeschränktem sudoPrinzip 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 onboard erneut aus.
  • Planen Sie wiederkehrende Aufgaben. officeclaws cron add richtet geplante Jobs ein, und mit officeclaws telegram set sprechen 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.

Autor

Office Claws Team

Wir gestalten die Zukunft des KI-Agenten-Managements bei Office Claws. Einblicke in Infrastruktur, Sicherheit und Entwicklererfahrung.

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