OpenClaw Manager Deployment-Anleitung

Einführung

OpenClaw Manager ist ein plattformübergreifendes visuelles Verwaltungswerkzeug, mit dem Sie OpenClaw-KI-Bot-Gateways schnell bereitstellen und verwalten können.

Bereitstellung ohne Konfiguration — Einzelne ausführbare Datei, installiert alle Abhängigkeiten automatisch
Web-Management-Oberfläche — Erstellen, Starten/Stoppen, Löschen von Instanzen und Modellwechsel über den Browser
Multi-Kanal-Unterstützung — Telegram / Feishu / Discord
Multi-Modell-Unterstützung — GPT-5-Serie, Claude 4.5/4.6-Serie, Gemini-Serie mit automatischem Failover
Hintergrundmodus — Unterstützt --daemon-Modus, von SSH-Trennung unbeeinflusst
Mehrsprachige Oberfläche — Chinesisch / Englisch / Japanisch

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass:

APIMart-API-Key erhalten Melden Sie sich in der APIMart-Konsole an, um Ihren API-Key zu erhalten (beginnt mit sk-)
Bot für Messaging-Plattform erstellt Bereiten Sie die Bot-Zugangsdaten je nach gewünschter Plattform vor (siehe unten den Abschnitt zur Kanalkonfiguration)

Tipp: Wenn Sie noch kein APIMart-Konto haben, registrieren Sie sich zuerst bei APIMart und holen Sie sich Ihren API-Key.

Schritt 1: Download

Laden Sie die ausführbare Datei für Ihre Plattform von GitHub Releases herunter:

Plattform	Dateiname
Windows x64	`openclaw-manager-win-x64.exe`
macOS ARM (Apple Silicon)	`openclaw-manager-macos-arm64.zip`
macOS Intel	`openclaw-manager-macos-x64.zip`
Linux x64	`openclaw-manager-linux-x64`
Linux ARM64	`openclaw-manager-linux-arm64`

Schritt 2: Ausführen

Windows
Linux
macOS

Bereitstellung unter Windows

Voraussetzungen

Windows 10/11 (64-bit)
Administratorrechte (erforderlich für das Erstellen geplanter Windows-Aufgaben zur Verwaltung des Gateways)

Starten

Rechtsklick auf openclaw-manager-win-x64.exe → Als Administrator ausführen

Beim ersten Start wird Folgendes automatisch durchgeführt:

Prüfung und Installation von Node.js v22 (lädt MSI für Silent-Installation automatisch herunter, wenn nicht gefunden)
Installation der OpenClaw-CLI (über npm install -g openclaw)
Browser wird automatisch zur Management-Oberfläche geöffnet

Muss als Administrator ausgeführt werden, andernfalls können keine geplanten Windows-Aufgaben zur Verwaltung der Gateway-Prozesse erstellt werden.

Bereitstellung unter Linux

Voraussetzungen

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ (x64 oder ARM64)
root-Rechte (empfohlen)

Starten

Herunterladen und Ausführungsrechte vergeben:

chmod +x ./openclaw-manager-linux-x64

Vordergrundmodus (zum Testen):

./openclaw-manager-linux-x64

Hintergrundmodus (empfohlen für die Produktion):

./openclaw-manager-linux-x64 --daemon

Daemon-Verwaltung

# Im Hintergrund starten
./openclaw-manager-linux-x64 --daemon
# Oder Kurzform
./openclaw-manager-linux-x64 -d

# Status prüfen
./openclaw-manager-linux-x64 --status

# Stoppen
./openclaw-manager-linux-x64 --stop
# Oder Kurzform
./openclaw-manager-linux-x64 -s

Firewall-Konfiguration

Wenn Remote-Zugriff erforderlich ist, öffnen Sie die folgenden Ports:

# Manager Web-UI
ufw allow 51942/tcp

# Gateway-Ports (einer pro Instanz, beginnend bei 18789)
ufw allow 18789/tcp

Tipp: Unter Linux bindet sich Manager automatisch an 0.0.0.0, was Remote-Zugriff ermöglicht. Die Log-Datei befindet sich unter ~/openclaw-manager.log.

Bereitstellung unter macOS

Voraussetzungen

macOS 12+ (Apple Silicon oder Intel)

Starten

Entpacken Sie die heruntergeladene ZIP-Datei, um OpenClaw Manager.app zu erhalten
Doppelklicken Sie, um OpenClaw Manager.app auszuführen
Beim ersten Start können Sicherheitseinstellungen erforderlich sein:

Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen

Tipp: Unter macOS bindet sich Manager an 127.0.0.1 (nur lokaler Zugriff). Die Daemon-Befehle sind dieselben wie unter Linux.

Schritt 3: Zugriff auf die Management-Oberfläche

Nachdem das Programm gestartet wurde, greifen Sie auf die Web-Management-Oberfläche zu:

http://127.0.0.1:51942

Linux-Remote-Zugriff: Ersetzen Sie 127.0.0.1 durch die IP Ihres Servers, z. B. http://your-server-ip:51942

Schritt 4: Instanz erstellen

Klicken Sie in der Web-Management-Oberfläche auf + New Instance, um zu beginnen:

4.1 Instanznamen festlegen

Geben Sie einen Instanznamen ein (nur Buchstaben, Zahlen, Unterstriche, Bindestriche, 1–64 Zeichen).

4.2 KI-Modell auswählen

Wählen Sie das zu verwendende KI-Modell und geben Sie Ihren APIMart-API-Key ein (beginnt mit sk-). Unterstützte Modelle:

Modell-ID	Name	Eigenschaften
`gpt-5`	GPT-5	Neuestes und leistungsfähigstes
`gpt-5.1`	GPT-5.1	Erweiterte Version
`gpt-5.2-codex`	GPT-5.2 Codex	Spezialisiert auf Code
`gpt-5.2-pro`	GPT-5.2 Pro	Professionelle Version
`claude-opus-4-6-20260320`	Claude Opus 4.6	Stärkstes Reasoning
`claude-sonnet-4-6-20260320`	Claude Sonnet 4.6	Ausgewogene Wahl
`claude-opus-4-5-20251101`	Claude Opus 4.5	Fortgeschrittenes Reasoning
`claude-sonnet-4-5-20250929`	Claude Sonnet 4.5	Hervorragend für Code
`claude-haiku-4-5-20251001`	Claude Haiku 4.5	Schnelle Antwort
`gemini-2.5-flash`	Gemini 2.5 Flash	Schnell, multimodal
`gemini-3-pro-preview`	Gemini 3 Pro Preview	Hohe Leistung

Modell-Empfehlungen:

💰 Kosteneffizient: claude-haiku-4-5-20251001, gemini-2.5-flash
🚀 Hohe Leistung: gpt-5, claude-opus-4-6-20260320, gemini-3-pro-preview
⚡ Schnelle Antwort: gemini-2.5-flash, claude-haiku-4-5-20251001

Sie können auch den Failover-Modus auswählen, um mehrere Backup-Modelle hinzuzufügen. Wenn das Primärmodell nicht verfügbar ist, wechselt das System automatisch zu den Backup-Modellen.

4.3 Messaging-Kanal konfigurieren

Wählen Sie Ihre Messaging-Plattform und folgen Sie der entsprechenden Anleitung:

Erstellen Sie einen Telegram-Bot über BotFather

Feishu

Erstellen Sie einen Feishu-Unternehmens-Bot

Discord

Erstellen Sie einen Discord-Server-Bot

Schritt 5: Pairing-Code-Bindung

Nachdem die Instanz erstellt und gestartet wurde, schließen Sie die Nutzerbindung über den Pairing-Code ab:

Der Nutzer sendet eine beliebige Nachricht an den Bot auf der Messaging-Plattform
Der Bot antwortet mit einem 8-stelligen Pairing-Code (z. B. DFE62DTD)
Der Administrator klickt in der Web-UI für die jeweilige Instanz auf die Schaltfläche “Pairing Code”
Geben Sie den Pairing-Code ein und klicken Sie auf “Approve”
Der Nutzer kann den Bot nun normal verwenden

Tipp: Pairing-Codes werden im Gateway-Speicher abgelegt und verfallen nach einem Neustart. Wenn ein Code abläuft, lassen Sie den Nutzer einfach eine neue Nachricht senden, um einen frischen Code zu erhalten.

Instanzen verwalten

In der Management-Oberfläche können Sie die folgenden Aktionen durchführen:

Aktion	Beschreibung
Start	Startet den Gateway-Prozess, der Bot beginnt mit dem Empfang von Nachrichten
Stop	Stoppt den Gateway-Prozess
Switch Model	Wechselt das KI-Modell in Echtzeit, ohne das Gateway neu zu starten
Pairing Code	Bestätigt Pairing-Codes neuer Nutzer zur Bot-Autorisierung
Delete	Stoppt und löscht die Instanz mit allen Daten (nicht umkehrbar)

Ports & Daten

Ports

Verwendung	Port	Bind-Adresse
Manager Web-UI	`51942`	Windows/macOS: `127.0.0.1`, Linux: `0.0.0.0`
Gateway-Instanz	Beginnend bei `18789`	Jede Instanz erhält einen eindeutigen Port

Datenverzeichnisse

Inhalt	Pfad
Instanzkonfiguration	`~/.openclaw-<instance-name>/openclaw.json`
Gateway-Logs	`~/.openclaw-<instance-name>/logs/gateway.log`
Manager-Logs	`~/openclaw-manager.log` (Daemon-Modus)
Manager-PID	`~/.openclaw-manager.pid`

FAQ

Q1: Manager startet nicht?

Lösungen:

Plattform	Prüfung
Windows	Stellen Sie sicher, dass die Ausführung als Administrator erfolgt
Linux	Stellen Sie sicher, dass Port 51942 nicht belegt ist (`lsof -i :51942`)
macOS	Stellen Sie sicher, dass die Sicherheitseinstellungen Erlaubnis erteilen oder die Quarantäne entfernt wurde
Alle	Logs unter `~/openclaw-manager.log` prüfen

Q2: openclaw-Befehl nicht gefunden?

Lösungen:

Das Programm erkennt und installiert die openclaw-CLI beim Start automatisch
Wenn die Version zu alt ist (< 0.1.0), wird sie automatisch aktualisiert
Manuelle Installation: npm install -g openclaw@latest

Q3: Instanz zeigt nach dem Start “stopped” an?

Lösungen:

Das Gateway benötigt einige Sekunden, um den Port zu binden; der Status kann kurzzeitig inkonsistent erscheinen
Aktualisieren Sie die Seite, um den aktuellen Status zu prüfen
Gateway-Logs prüfen: ~/.openclaw-<instance-name>/logs/gateway.log

Q4: Feishu-Bot reagiert nicht?

Lösungen:

Stellen Sie sicher, dass im Event-Abonnement im.message.receive_v1 hinzugefügt wurde
Stellen Sie sicher, dass die Abonnementmethode “Long Connection” ist
Stellen Sie sicher, dass eine neue Version erstellt und veröffentlicht wurde (nach jeder Berechtigungs-/Event-Änderung erforderlich)

Q5: Pairing-Code-Bestätigung fehlgeschlagen?

Lösungen:

Stellen Sie sicher, dass das Gateway läuft
Pairing-Codes werden im Gateway-Speicher abgelegt und verfallen nach einem Neustart
Lassen Sie den Nutzer eine neue Nachricht senden, um einen frischen Pairing-Code zu erhalten

Q6: Wie kann ich API-Nutzung und -Kosten einsehen?

Melden Sie sich in der APIMart-Konsole an, um Folgendes einzusehen:

📊 API-Aufrufstatistiken
💰 Kostendetails
📈 Diagramme zu Nutzungstrends

Support & Hilfe

Bei Problemen:

📚 APIMart-Dokumentation
📚 OpenClaw Manager GitHub
💬 Discord-Community
🐦 Twitter @APIMart_
📧 Technischer Support: zhihong@apimart.ai

Starten Sie mit APIMart

Registrieren Sie sich jetzt bei APIMart, holen Sie sich Ihren API-Key und stellen Sie Ihren KI-Bot bereit!

​Einführung

​Voraussetzungen

​Schritt 1: Download

​Schritt 2: Ausführen

​Bereitstellung unter Windows

​Voraussetzungen

​Starten

​Bereitstellung unter Linux

​Voraussetzungen

​Starten

​Daemon-Verwaltung

​Firewall-Konfiguration

​Bereitstellung unter macOS

​Voraussetzungen

​Starten

​Schritt 3: Zugriff auf die Management-Oberfläche

​Schritt 4: Instanz erstellen

​4.1 Instanznamen festlegen

​4.2 KI-Modell auswählen

​4.3 Messaging-Kanal konfigurieren

Telegram

Feishu

Discord

​Schritt 5: Pairing-Code-Bindung

​Instanzen verwalten

​Ports & Daten

​Ports

​Datenverzeichnisse

​FAQ

​Q1: Manager startet nicht?

​Q2: openclaw-Befehl nicht gefunden?

​Q3: Instanz zeigt nach dem Start “stopped” an?

​Q4: Feishu-Bot reagiert nicht?

​Q5: Pairing-Code-Bestätigung fehlgeschlagen?

​Q6: Wie kann ich API-Nutzung und -Kosten einsehen?

​Support & Hilfe

Starten Sie mit APIMart

Einführung

Voraussetzungen

Schritt 1: Download

Schritt 2: Ausführen

Bereitstellung unter Windows

Voraussetzungen

Starten

Bereitstellung unter Linux

Voraussetzungen

Starten

Daemon-Verwaltung

Firewall-Konfiguration

Bereitstellung unter macOS

Voraussetzungen

Starten

Schritt 3: Zugriff auf die Management-Oberfläche

Schritt 4: Instanz erstellen

4.1 Instanznamen festlegen

4.2 KI-Modell auswählen

4.3 Messaging-Kanal konfigurieren

Schritt 5: Pairing-Code-Bindung

Instanzen verwalten

Ports & Daten

Ports

Datenverzeichnisse

FAQ

Q1: Manager startet nicht?

Q2: openclaw-Befehl nicht gefunden?

Q3: Instanz zeigt nach dem Start “stopped” an?

Q4: Feishu-Bot reagiert nicht?

Q5: Pairing-Code-Bestätigung fehlgeschlagen?

Q6: Wie kann ich API-Nutzung und -Kosten einsehen?

Support & Hilfe