Schritt 6: Agenten erstellen
Machen Sie Ihren Contabo-VPS mit einem einzigen Befehl zu einem laufenden KI-Agenten.
Das ist der Hauptschritt. Ein einziger Befehl richtet Ihren VPS von Grund auf ein und startet Ihren Agenten.
Bevor Sie den Befehl ausführen
- Sie sind angemeldet und haben ein Abo (Schritt 3)
- Ihr Contabo-VPS ist ausgeliefert und läuft (Schritt 4)
- Tailscale ist auf Ihrem Computer verbunden (Schritt 5)
- Ihr Computer bleibt in den nächsten 5–40 Minuten wach. Schließen Sie das Terminal nicht und lassen Sie den Laptop nicht in den Ruhezustand gehen.
Schritt 1: Onboarding starten
officeclaws onboard --name MonaWählen Sie einen beliebigen Namen für den Agenten; Mona ist nur ein Beispiel. Wenn Sie --name weglassen, fragt die CLI nach einem Namen.
Schritt 2: Contabo-Zugangsdaten eingeben
Wenn Sie diesen Befehl zum ersten Mal ausführen, werden Sie nach den vier Werten aus Schritt 4 gefragt:
Contabo client ID: ...
Contabo client secret: ...
Contabo API user (email): [email protected]
Contabo API password: ...
Validating Contabo credentials…
Contabo credentials saved.
Schritt 3: Tailscale-Auth-Key eingeben
Tailscale auth key: tskey-auth-...
Schritt 4: VPS auswählen
Die CLI lädt die Server in Ihrem Contabo-Konto und listet sie auf:
Syncing your Contabo VPSes…
Your VPSes:
1) 6f1c… 203.0.113.10 active
2) 9a2d… 203.0.113.24 active [agent: Bob (online)]
Pick a VPS number: 1
Geben Sie die Nummer des gewünschten Servers ein und drücken Sie Enter. Ein mit [agent: …] markierter Server hat bereits einen Agenten. Die Einrichtung lässt sich darauf nicht einfach erneut ausführen, weil die erste Einrichtung öffentliches SSH auf diesem Server geschlossen hat. Um dort einen neuen Agenten einzurichten, installieren Sie zuerst Ubuntu 24.04 über das Contabo-Kundenpanel neu (siehe Agenten verwalten) und wählen den Server dann hier aus. Dabei wird der alte Agent gelöscht.
„No VPSes found on your account“ bedeutet, dass Contabo den Server noch nicht ausgeliefert hat oder die API-Zugangsdaten zu einem anderen Contabo-Konto gehören.
Schritt 5: Warten
Die CLI zeigt nun jede Phase an, während sie läuft:
Provisioning "Mona" on VPS 6f1c… — this can take several minutes…
▸ Ensuring local Tailscale is connected...
▸ Loading selected VPS...
▸ Installing OpenClaw's SSH key on your VPS...
▸ Waiting for VPS to finish rebooting and quiesce cloud-init...
▸ Bootstrapping VPS over SSH...
▸ Running onboard_agent.sh via Tailscale (100.x.y.z)...
▸ Waiting for gateway to come online...
▸ Approving operator device...
Zwischen diesen Phasen sehen Sie außerdem eingerückte Detailzeilen. Das ist normal.
In diesem Schritt erledigt die CLI Folgendes:
- Sie fügt dem VPS einen eigenen SSH-Schlüssel hinzu, der auf Ihrem Computer erzeugt wurde
- Sie sichert den Server ab: legt einen separaten Benutzer an, aktiviert Firewall und Brute-Force-Schutz, schaltet automatische Sicherheitsupdates ein und deaktiviert Passwort- und Root-Login
- Sie verbindet den Server mit Ihrem Tailnet und schließt öffentliches SSH
- Sie installiert Docker und startet den Agenten
So lange dauert es:
| Situation | Zeit |
|---|---|
| Normale Einrichtung | etwa 5–10 Minuten |
| Wenn Contabo den Server langsam neu startet | bis zu 30–40 Minuten |
Wenn es fertig ist:
✅ Agent "Mona" is ready. Next:
officeclaws connect-codex ← connect your ChatGPT/Codex subscription to power it
officeclaws chat
Wichtige Optionen
| Option | Wirkung |
|---|---|
--reinstall | Ist für unsere internen vorgefertigten Server-Images gedacht. Die Option löscht Ihren VPS nicht: Gibt es in Ihrem Contabo-Konto kein solches Image (der Normalfall), läuft die Einrichtung ganz normal weiter. Für einen sauberen Server installieren Sie Ubuntu 24.04 stattdessen über das Contabo-Kundenpanel neu. Siehe Agenten verwalten. |
--ssh-pubkey "ssh-ed25519 AAAA… you@laptop" | Fügt dem Server zusätzlich Ihren eigenen SSH-Schlüssel hinzu, damit Sie sich später selbst über Tailscale anmelden können |
--avatar 1…12 | Wählt den Avatar des Agenten in der Desktop-App |
--comm-style friendly|business|creative | Legt den Tonfall des Agenten fest. Standard ist friendly. |
--tailscale-hostname name | Legt den Namen des Servers in Ihrem Tailnet fest. Standardmäßig wird er vom Agentennamen abgeleitet. |
--vps <id> | Überspringt die Serverliste und verwendet direkt diesen VPS |
Wenn etwas schiefgeht
- Wenn die Einrichtung abgebrochen ist, bevor sie fertig war, führen Sie denselben Befehl erneut aus.
- Wenn das nicht hilft oder die Einrichtung auf diesem Server schon einmal abgeschlossen wurde, beginnen Sie mit einem sauberen Server: Installieren Sie Ubuntu 24.04 über das Contabo-Kundenpanel auf dem VPS neu und führen Sie dann
officeclaws onboarderneut aus. - Einrichtungslogs werden auf Ihrem Computer unter
~/.openclaw/logsgespeichert. - Häufige Fehler finden Sie unter Fehlerbehebung.