> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw Manager Deployment-Anleitung

> Ein visuelles Tool zur Ein-Klick-Bereitstellung und Verwaltung von OpenClaw-KI-Bot-Gateways, das die Plattformen Telegram, Feishu und Discord unterstützt und durch die KI-Modelle GPT-5, Claude, Gemini und mehr über die APIMart-API betrieben wird.

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

1. **APIMart-API-Key erhalten**
   Melden Sie sich in der [APIMart-Konsole](https://apimart.ai/keys) an, um Ihren API-Key zu erhalten (beginnt mit `sk-`)

2. **Bot für Messaging-Plattform erstellt**
   Bereiten Sie die Bot-Zugangsdaten je nach gewünschter Plattform vor (siehe unten den Abschnitt zur Kanalkonfiguration)

<Note>
  **Tipp:** Wenn Sie noch kein APIMart-Konto haben, registrieren Sie sich zuerst bei [APIMart](https://apimart.ai) und holen Sie sich Ihren API-Key.
</Note>

## Schritt 1: Download

Laden Sie die ausführbare Datei für Ihre Plattform von [GitHub Releases](https://github.com/zhihong-apimart/OpenClaw-Manager-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

<Tabs>
  <Tab title="Windows">
    ### 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

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

  <Tab title="Linux">
    ### Bereitstellung unter Linux

    #### Voraussetzungen

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

    #### Starten

    1. Herunterladen und Ausführungsrechte vergeben:

    ```bash theme={null}
    chmod +x ./openclaw-manager-linux-x64
    ```

    2. **Vordergrundmodus** (zum Testen):

    ```bash theme={null}
    ./openclaw-manager-linux-x64
    ```

    3. **Hintergrundmodus** (empfohlen für die Produktion):

    ```bash theme={null}
    ./openclaw-manager-linux-x64 --daemon
    ```

    #### Daemon-Verwaltung

    ```bash theme={null}
    # 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:

    ```bash theme={null}
    # Manager Web-UI
    ufw allow 51942/tcp

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

    <Note>
      **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`.
    </Note>
  </Tab>

  <Tab title="macOS">
    ### Bereitstellung unter macOS

    #### Voraussetzungen

    * macOS 12+ (Apple Silicon oder Intel)

    #### Starten

    1. Entpacken Sie die heruntergeladene ZIP-Datei, um `OpenClaw Manager.app` zu erhalten

    2. Doppelklicken Sie, um `OpenClaw Manager.app` auszuführen

    3. Beim ersten Start können Sicherheitseinstellungen erforderlich sein:

    ```
    Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen
    ```

    <Note>
      **Tipp:** Unter macOS bindet sich Manager an `127.0.0.1` (nur lokaler Zugriff). Die Daemon-Befehle sind dieselben wie unter Linux.
    </Note>
  </Tab>
</Tabs>

## 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
```

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

## 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                   |

<Tip>
  **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`
</Tip>

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:

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" href="/de/integrations/platform/openclaw-manager-telegram">
    Erstellen Sie einen Telegram-Bot über BotFather
  </Card>

  <Card title="Feishu" icon="message" href="/de/integrations/platform/openclaw-manager-feishu">
    Erstellen Sie einen Feishu-Unternehmens-Bot
  </Card>

  <Card title="Discord" icon="discord" href="/de/integrations/platform/openclaw-manager-discord">
    Erstellen Sie einen Discord-Server-Bot
  </Card>
</CardGroup>

## Schritt 5: Pairing-Code-Bindung

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

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

<Note>
  **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.
</Note>

## 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:**

1. Stellen Sie sicher, dass im Event-Abonnement `im.message.receive_v1` hinzugefügt wurde
2. Stellen Sie sicher, dass die Abonnementmethode "**Long Connection**" ist
3. 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](https://apimart.ai/overview) an, um Folgendes einzusehen:

* 📊 API-Aufrufstatistiken
* 💰 Kostendetails
* 📈 Diagramme zu Nutzungstrends

## Support & Hilfe

Bei Problemen:

* 📚 [APIMart-Dokumentation](https://docs.apimart.ai)
* 📚 [OpenClaw Manager GitHub](https://github.com/zhihong-apimart/OpenClaw-Manager)
* 💬 [Discord-Community](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Technischer Support: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Starten Sie mit APIMart" icon="rocket" href="https://apimart.ai">
  Registrieren Sie sich jetzt bei APIMart, holen Sie sich Ihren API-Key und stellen Sie Ihren KI-Bot bereit!
</Card>