hermes slack Befehl — Vollständige Referenz & Beispiele

Übersicht

hermes slack stellt Slack-Integrationshilfen für Hermes bereit. Es gibt genau einen Unterbefehl, manifest, der ein Slack-App-Manifest ausgibt oder schreibt, in dem jeder Gateway-Befehl als nativer Slash-Befehl (/btw, /stop, /model, …) registriert ist. Füge das Manifest in die Konfiguration deiner Slack-App ein, um deinen Workspace mit dem Hermes-Gateway zu verbinden.

hermes slack manifest

Unterbefehle

manifest

Erzeugt ein Slack-App-Manifest, das jeden Gateway-Befehl aus der Befehlsregistrierung als erstklassigen Slack-Slash-Befehl registriert. Füge die Ausgabe unter Slack-App-Konfiguration → Funktionen → App-Manifest → Bearbeiten ein und speichere sie. Installiere die App neu, wenn Slack dazu auffordert.

Option	Beschreibung
`--write [PATH]`	Schreibt das Manifest in eine Datei statt nach stdout. Ohne PATH wird nach `$HERMES_HOME/slack-manifest.json` geschrieben
`--name NAME`	Anzeigename des Bots (Standard: `Hermes`)
`--description DESCRIPTION`	Bot-Beschreibung im Slack-App-Verzeichnis
`--long-description TEXT`	Setzt die lange App-Beschreibung (175–4.000 Zeichen)
`--long-description-file PATH`	Liest die lange App-Beschreibung aus einer UTF-8-Textdatei (175–4.000 Zeichen)
`--slashes-only`	Gibt nur das `features.slash_commands`-Array aus (zum manuellen Zusammenführen in ein vorhandenes Manifest)
`--no-assistant`	Lässt den Slack-AI-Assistant-Modus weg; DMs erscheinen als flacher Chat, in dem nackte Slash-Befehle (`/help`, `/new`) direkt funktionieren
`--agent-view`	Gibt Slacks Agent-Messaging-Erlebnis statt des alten `assistant_view` aus; nach dem Anwenden des Manifests in Slack nicht umkehrbar

Häufige Szenarien

Ersteinrichtung

hermes slack manifest
# Gibt ein vollständiges manifest.json nach stdout aus

# 1. Öffne https://api.slack.com/apps
# 2. Neue App erstellen → Aus Manifest
# 3. Das erzeugte Manifest einfügen
# 4. Die App in deinen Workspace installieren

In eine Datei speichern

hermes slack manifest --write
# Schreibt nach $HERMES_HOME/slack-manifest.json

hermes slack manifest --write ./slack-manifest.json
# Oder in einen eigenen Pfad

Bot anpassen

hermes slack manifest --name "Hermes Bot" --description "KI-Assistent, über das Hermes-Gateway verbunden"

In ein vorhandenes Manifest einfügen

hermes slack manifest --slashes-only
# Gibt nur das slash_commands-Array für die manuelle Zusammenführung aus

Messaging-Erlebnis wählen

hermes slack manifest --agent-view
# Nutzt Slacks Agent-Messaging-Erlebnis (später in Slack nicht umkehrbar)

Tipps

manifest ist der einzige Unterbefehl von hermes slack
--write ohne PATH speichert nach $HERMES_HOME/slack-manifest.json
Nach dem Anwenden eines Manifests die App neu installieren, wenn Slack dazu auffordert
--agent-view ändert die Messaging-Oberfläche der App und ist nach dem Anwenden nicht umkehrbar
--slashes-only verwenden, wenn du ein vorhandenes Manifest manuell pflegst