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

# Hermes

> Schreib Hermes in WhatsApp und lass es antworten, ohne Zeitlimit.

## Was funktioniert

Hermes hört über ein kleines zapbip-Plugin weiter auf dein WhatsApp. Du schreibst zuerst oder beantwortest eine Frage später, und die Nachricht erreicht die Hermes-Sitzung.

WhatsApp: Hermes

### Nachrichten, die du weiterleitest

Eine Nachricht, die du von jemand anderem weitergeleitet hast, erreicht Hermes mit einer Markierung, die sagt, dass du sie nicht geschrieben hast, sodass Hermes sie nicht als deine Anweisung behandelt.

## So hört sie zu

Sprosse: Lokal. Solange eine Frage offen ist, wartet Hermes jeweils bis zu 50 Sekunden. Hast du nicht geantwortet, endet das Warten als ausstehend und Hermes ruft erneut auf, so oft es nötig ist, ohne Zeitlimit.

Das Plugin hält eine Verbindung zu zapbip offen, ohne Zeitlimit. Bricht das Netzwerk ab, verbindet es sich von selbst neu und wartet nach jedem Fehlversuch etwas länger (zuerst 1 Sekunde, höchstens 30 Sekunden). Nachrichten, die du in der Zwischenzeit sendest, warten in deinem zapbip-Posteingang, und das Plugin holt jede unbeantwortete ab, sobald es wieder da ist.

### Wenn sich das Plugin nicht installieren lässt

Hermes kann stattdessen abfragen. Füge den MCP-Server aus der Einrichtung hinzu und lege einen Job an, der jede 1 Minute `check_inbox` aufruft. Deine Nachrichten warten bis zu einer Minute, und die Antwort kommt genauso.

## Von Grund auf einrichten

### Was du brauchst

* Hermes mit laufendem Gateway.
* Deinen Verbindungslink, denselben Link `https://.../c/<secret>/mcp`, den deine KI nutzt, um mit zapbip zu sprechen. Behandle ihn wie ein Passwort.

### Das Plugin installieren

Installiere das Paket in die Python-Umgebung, in der Hermes läuft:

```bash theme={null}
d=$(mktemp -d) && curl -fsSL https://mcp.zapbip.com/pkg/zapbip_platform-0.1.0-requirements.txt -o "$d/zapbip-requirements.txt" && python3 -c 'import hashlib,sys; sys.exit(hashlib.sha256(open(sys.argv[1],"rb").read()).hexdigest() != sys.argv[2])' "$d/zapbip-requirements.txt" fc258f304227f3eb44169c5416f581424296a876995c6499daaa42c7cf04cc31 && python3 -m pip install --only-binary=:all: --require-hashes -r "$d/zapbip-requirements.txt"
```

Aktiviere es dann in `~/.hermes/config.yaml`:

```yaml theme={null}
plugins:
  enabled:
    - zapbip-platform
```

Setze den Link und wer mit Hermes sprechen darf in der Umgebung, in der das Gateway läuft, nie in einer Datei, die du teilst:

```bash theme={null}
export ZAPBIP_CONNECTION_LINK='https://<host>/c/<secret>/mcp'
export ZAPBIP_ALLOWED_USERS=owner
```

Die Datei, die deinen Verbindungslink enthält, funktioniert wie ein Passwort. Gib ihr die Berechtigung `600`, damit nur dein Benutzer sie lesen kann, und teile sie nie und committe sie nie:

```bash theme={null}
chmod 600 <file>
```

Starte das Gateway neu.

Führe pro Agent nur einen Listener aus: das Plugin oder `npx zapbip@0.1.0 listen`, niemals beide. Ein zweiter Listener ersetzt den ersten.

### Wie Hermes antwortet

Hermes sendet seine Antworten auf deine Nachrichten über das Plugin selbst zurück, ohne zusätzliche Einrichtung.

Füge zapbip als MCP-Server hinzu, damit Hermes auch eine Unterhaltung mit dir beginnen, dir eine Frage mit Buttons stellen und auf die Antwort warten kann und die Abfrage-Alternative unten nutzen kann:

```yaml theme={null}
mcp_servers: { zapbip: { url: 'https://<host>/c/<secret>/mcp' } }
```

Bitte dann Hermes in WhatsApp, `✅ installiert` zu senden. Kommt diese Nachricht an, funktioniert es. Die Befehle und die Antworten von zapbip sind auf Deutsch; dieselben Befehle versteht es auch auf Englisch.

WhatsApp: zapbip

## Prüfen, ob es funktioniert

| Du siehst | Was es bedeutet |
| - | - |
| Keine Antwort auf deine Nachricht | Das Gateway läuft nicht, oder das Plugin steht nicht in `plugins.enabled`. |
| Das Plugin hält von selbst an | Ein anderes Plugin oder ein Connector wurde für dieselbe Verbindung gestartet und hat es ersetzt. |
| Hermes kann keine Unterhaltung beginnen oder dich fragen | Der MCP-Server `zapbip` fehlt in `config.yaml`. |
| Das Plugin hält mit einem Fehler an | Der Link ist unbekannt oder die Verbindung wurde widerrufen. Bitte um einen neuen. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.