Skip to main content
Das Gateway verarbeitet Befehle, die als eigenständige Nachrichten gesendet werden und mit / beginnen. Bash-Befehle nur für den Host verwenden ! <cmd> (mit /bash <cmd> als Alias). Wenn eine Unterhaltung an eine ACP-Sitzung gebunden ist, wird normaler Text an das ACP- Harness weitergeleitet. Gateway-Verwaltungsbefehle bleiben lokal: /acp ... erreicht immer den OpenClaw-Befehlshandler, und /status sowie /unfocus bleiben lokal, sobald die Befehlsverarbeitung für die Oberfläche aktiviert ist.

Drei Befehlstypen

Befehle

Eigenständige /...-Nachrichten, die vom Gateway verarbeitet werden. Sie müssen als einziger Inhalt der Nachricht gesendet werden.

Direktiven

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — werden aus der Nachricht entfernt, bevor das Modell sie sieht. Wenn sie allein gesendet werden, bleiben die Sitzungseinstellungen erhalten; zusammen mit anderem Text dienen sie als Inline-Hinweise.

Inline-Kurzbefehle

/help, /commands, /status, /whoami — werden sofort ausgeführt und entfernt, bevor das Modell den verbleibenden Text sieht. Nur für autorisierte Absender.
  • Direktiven werden aus der Nachricht entfernt, bevor das Modell sie sieht.
  • In Nachrichten, die nur Direktiven enthalten, bleiben sie für die Sitzung erhalten und antworten mit einer Bestätigung.
  • In Nachrichten eines normalen Chats mit anderem Text dienen sie als Inline-Hinweise und bleiben als Sitzungseinstellungen nicht erhalten.
  • Direktiven gelten nur für autorisierte Absender. Wenn commands.allowFrom festgelegt ist, wird ausschließlich diese Zulassungsliste verwendet; andernfalls ergibt sich die Autorisierung aus Kanal-Zulassungslisten, Kopplung und der stets aktiven Durchsetzung von Zugriffsgruppen. Bei nicht autorisierten Absendern werden Direktiven als Klartext behandelt.

Konfiguration

boolean
Standard:"true"
Aktiviert die Analyse von /... in Chatnachrichten. Auf Oberflächen ohne native Befehle (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) funktionieren Textbefehle auch, wenn die Einstellung false lautet.
boolean | "auto"
Standard:"\"auto\""
Registriert native Befehle. Automatisch: für Discord/Telegram aktiviert, für Slack deaktiviert; für Provider ohne native Unterstützung ignoriert. Kann pro Kanal mit channels.<provider>.commands.native überschrieben werden. Bei Discord überspringt false die Registrierung von Slash-Befehlen; zuvor registrierte Befehle bleiben möglicherweise sichtbar, bis sie entfernt werden.
boolean | "auto"
Standard:"\"auto\""
Registriert Skill-Befehle nativ, sofern unterstützt. Automatisch: für Discord/Telegram aktiviert, für Slack deaktiviert. Kann mit channels.<provider>.commands.nativeSkills überschrieben werden.
boolean
Standard:"false"
Aktiviert ! <cmd> zum Ausführen von Host-Shell-Befehlen (Alias /bash <cmd>). Erfordert tools.elevated-Zulassungslisten.
number
Standard:"2000"
Legt fest, wie lange Bash wartet, bevor in den Hintergrundmodus gewechselt wird (0 wechselt sofort in den Hintergrund).
boolean
Standard:"false"
Aktiviert /config (liest/schreibt openclaw.json). Nur für Eigentümer.
boolean
Standard:"false"
Aktiviert /mcp (liest/schreibt die von OpenClaw verwaltete MCP-Konfiguration unter mcp.servers). Nur für Eigentümer.
boolean
Standard:"false"
Aktiviert /plugins (Plugin-Erkennung/-Status sowie Installation und Aktivierung/Deaktivierung). Schreibvorgänge nur für Eigentümer.
boolean
Standard:"false"
Aktiviert /debug (nur zur Laufzeit geltende Konfigurationsüberschreibungen). Nur für Eigentümer.
boolean
Standard:"true"
Aktiviert /restart und externe Neustartanforderungen über SIGUSR1.
string[]
Explizite Eigentümer-Zulassungsliste für Befehlsoberflächen, die nur Eigentümern vorbehalten sind. Unabhängig von commands.allowFrom und dem Zugriff über DM-Kopplung.
boolean
Standard:"false"
Pro Kanal: Erfordert für Eigentümerbefehle eine Eigentümeridentität. Wenn true, muss der Absender commands.ownerAllowFrom entsprechen oder über den internen Geltungsbereich operator.admin verfügen. Ein Platzhaltereintrag allowFrom ist nicht ausreichend.
"raw" | "hash"
Steuert, wie Eigentümer-IDs im System-Prompt angezeigt werden.
string
HMAC-Geheimnis, das bei commands.ownerDisplay: "hash" verwendet wird.
object
Providerspezifische Zulassungsliste für die Befehlsautorisierung. Wenn sie konfiguriert ist, stellt sie die einzige Autorisierungsquelle für Befehle und Direktiven dar. Verwenden Sie "*" als globale Standardeinstellung; providerspezifische Schlüssel überschreiben sie.

Befehlsliste

Befehle stammen aus drei Quellen:
  • Integrierte Kernbefehle: src/auto-reply/commands-registry.shared.ts
  • Generierte Dock-Befehle: src/auto-reply/commands-registry.data.ts
  • Plugin-Befehle: Aufrufe von Plugin-registerCommand()
Die Verfügbarkeit hängt von Konfigurationsoptionen, der Kanaloberfläche sowie installierten und aktivierten Plugins ab.

Kernbefehle

Explizite /export-session-Pfade ersetzen vorhandene Dateien innerhalb des Arbeitsbereichs. Lassen Sie den Pfad weg, um einen kollisionssicheren Dateinamen zu erzeugen.
Die Control UI fängt eingegebene /new ab, um eine neue Dashboard-Sitzung zu erstellen und zu ihr zu wechseln, außer wenn session.dmScope: "main" konfiguriert ist und das aktuelle übergeordnete Element die Hauptsitzung des Agenten ist — in diesem Fall setzt /new die Hauptsitzung an Ort und Stelle zurück. Eingegebene /reset führen weiterhin das Zurücksetzen des Gateway an Ort und Stelle aus. Verwenden Sie /model default, wenn Sie eine angeheftete Modellauswahl für die Sitzung löschen möchten.
  • /verbose dient der Fehlerdiagnose — lassen Sie es bei normaler Verwendung deaktiviert.
  • /trace zeigt nur Plugin-eigene Trace-/Debug-Zeilen; normale ausführliche Meldungen bleiben deaktiviert.
  • /fast auto|on|off speichert eine Sitzungsüberschreibung dauerhaft; verwenden Sie in der Sitzungs-UI die Option inherit, um sie zu löschen.
  • /fast ist providerspezifisch: OpenAI/Codex ordnen es service_tier=priority zu; direkte Anthropic-Anfragen ordnen es service_tier=auto oder standard_only zu.
  • /reasoning, /verbose und /trace sind in Gruppenumgebungen riskant — sie können interne Schlussfolgerungen oder Plugin-Diagnosen offenlegen. Lassen Sie sie in Gruppenchats deaktiviert.
  • /model speichert das neue Modell sofort dauerhaft in der Sitzung.
  • Wenn der Agent inaktiv ist, wird es bei der nächsten Ausführung sofort verwendet.
  • Wenn eine Ausführung aktiv ist, wird der Wechsel als ausstehend markiert und beim nächsten geeigneten Wiederholungspunkt angewendet.

Dock-Befehle

Dock-Befehle stellen die Antwortweiterleitung der aktiven Sitzung auf einen anderen verknüpften Kanal um. Einrichtung und Fehlerbehebung finden Sie unter Kanal-Docking. Aus Kanal-Plugins mit Unterstützung nativer Befehle generiert:
  • /dock-discord (Alias: /dock_discord)
  • /dock-mattermost (Alias: /dock_mattermost)
  • /dock-slack (Alias: /dock_slack)
  • /dock-telegram (Alias: /dock_telegram)
Dock-Befehle erfordern session.identityLinks. Der Absender der Quelle und der Zielteilnehmer müssen derselben Identitätsgruppe angehören.

Befehle gebündelter Plugins

Nur QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Skill-Befehle

Von Benutzern aufrufbare Skills werden als Slash-Befehle bereitgestellt:
  • /skill <name> [input] funktioniert immer als generischer Einstiegspunkt.
  • Skills können als direkte Befehle registriert werden (z. B. /prose für OpenProse).
  • Die Registrierung nativer Skill-Befehle wird durch commands.nativeSkills und channels.<provider>.commands.nativeSkills gesteuert.
  • Namen werden zu a-z0-9_ bereinigt (max. 32 Zeichen); bei Namenskonflikten werden numerische Suffixe angefügt.
Standardmäßig werden Skill-Befehle als normale Anfrage an das Modell weitergeleitet.Skills können command-dispatch: tool deklarieren, um direkt an ein Tool weiterzuleiten (deterministisch, ohne Beteiligung des Modells). Beispiel: /prose (OpenProse-Plugin) — siehe OpenProse.
Discord verwendet die automatische Vervollständigung für dynamische Optionen und Schaltflächenmenüs, wenn erforderliche Argumente fehlen. Telegram und Slack zeigen für Befehle mit Auswahlmöglichkeiten ein Schaltflächenmenü an. Dynamische Auswahlmöglichkeiten werden anhand des Modells der Zielsitzung aufgelöst, sodass modellspezifische Optionen wie /think-Stufen der /model-Überschreibung der Sitzung folgen.

/tools: Was der Agent jetzt verwenden kann

/tools beantwortet eine Laufzeitfrage: Was dieser Agent jetzt in dieser Unterhaltung verwenden kann — keinen statischen Konfigurationskatalog.
Die Ergebnisse gelten für die jeweilige Sitzung. Ein Wechsel des Agenten, Kanals, Threads, der Absenderautorisierung oder des Modells kann die Ausgabe ändern. Verwenden Sie zum Bearbeiten von Profilen und Überschreibungen den Bereich „Tools“ der Control UI oder die Konfigurationsoberflächen.

/model: Modellauswahl

In Discord öffnen /model und /models eine interaktive Auswahl mit Dropdownlisten für Provider und Modelle. Die Auswahl berücksichtigt agents.defaults.modelPolicy.allow, einschließlich provider/*-Einträgen. Ohne eine ausdrückliche Positivliste schränken Modelleinträge und Aliasse die Auswahl nicht ein.

/config: Schreiben der Konfiguration auf den Datenträger

Nur für Eigentümer. Standardmäßig deaktiviert — aktivieren Sie dies mit commands.config: true.
Die Konfiguration wird vor dem Schreiben validiert. Ungültige Änderungen werden abgelehnt. Aktualisierungen durch /config bleiben über Neustarts hinweg bestehen.

/mcp: MCP-Serverkonfiguration

Nur für Eigentümer. Standardmäßig deaktiviert — aktivieren Sie dies mit commands.mcp: true.
/mcp speichert die Konfiguration in der OpenClaw-Konfiguration, nicht in den Projekteinstellungen des eingebetteten Agenten. /mcp show schwärzt Felder mit Anmeldedaten, erkannte Werte von Anmeldedaten-Flags und bekannte Argumente in der Form von Geheimnissen. Bei Ausführung aus einer Gruppe wird die Konfiguration privat an den Eigentümer gesendet. Wenn keine private Route zum Eigentümer verfügbar ist, schlägt der Befehl sicher fehl und fordert den Eigentümer auf, ihn in einem direkten Chat erneut auszuführen.

/debug: Überschreibungen ausschließlich für die Laufzeit

Nur für Eigentümer. Standardmäßig deaktiviert — aktivieren Sie dies mit commands.debug: true. Überschreibungen gelten sofort für neue Konfigurationslesevorgänge, werden jedoch nicht auf den Datenträger geschrieben.

/plugins: Plugin-Verwaltung

Schreibvorgänge nur für Eigentümer. Standardmäßig deaktiviert — aktivieren Sie dies mit commands.plugins: true.
/plugins enable|disable aktualisiert die Plugin-Konfiguration und lädt die Plugin-Laufzeit des Gateways für neue Agentendurchläufe dynamisch neu. /plugins install startet verwaltete Gateways automatisch neu, da sich Plugin-Quellmodule geändert haben. Installationen aus vertrauenswürdigem ClawHub und dem offiziellen Katalog benötigen keine zusätzliche Bestätigung. Beliebige npm-, Git-, Archiv-, npm-pack:- und lokale Pfadquellen zeigen eine Herkunftswarnung an und erfordern nach der Prüfung der Quelle ein nachgestelltes --force. Dieses Flag bestätigt die Quelle und gestattet das Ersetzen einer vorhandenen Installation; es umgeht weder security.installPolicy noch die Sicherheitsprüfungen des Installationsprogramms. ClawHub-Versionen mit Risikowarnungen erfordern weiterhin das separate, ausschließlich in der Shell verfügbare Flag --acknowledge-clawhub-risk. Marketplace-, verknüpfte und angeheftete Installationen bleiben ebenfalls ausschließlich über die Shell verfügbar.

/trace: Plugin-Trace-Ausgabe

/trace zeigt sitzungsbezogene Plugin-Trace-/Debug-Zeilen ohne vollständigen ausführlichen Modus an. Dies ersetzt weder /debug (Laufzeitüberschreibungen) noch /verbose (normale Tool-Ausgabe).

/btw: Nebenfragen

/btw ist eine kurze Nebenfrage zum aktuellen Sitzungskontext. Alias: /side.
Im Gegensatz zu einer normalen Nachricht:
  • Verwendet die aktuelle Sitzung als Hintergrundkontext.
  • Wird in Codex-Harness-Sitzungen als kurzlebiger Codex-Nebenthread ausgeführt.
  • Ändert den künftigen Sitzungskontext nicht.
  • Wird nicht in den Transkriptverlauf geschrieben.
Das vollständige Verhalten finden Sie unter BTW-Nebenfragen.

Hinweise zu Oberflächen

  • Textbefehle: werden in der normalen Chatsitzung ausgeführt (Direktnachrichten teilen main, Gruppen besitzen jeweils eine eigene Sitzung).
  • Native Discord-Befehle: agent:<agentId>:discord:slash:<userId>
  • Native Slack-Befehle: agent:<agentId>:slack:slash:<userId> (Präfix über channels.slack.slashCommand.sessionPrefix konfigurierbar)
  • Native Telegram-Befehle: telegram:slash:<userId> (zielt über CommandTargetSessionKey auf die Chatsitzung)
  • /login codex sendet Gerätekopplungscodes nur über private Chats oder Antwortpfade der Web-UI. Bei Aufrufen in Telegram-Gruppen/-Themen wird der Eigentümer stattdessen aufgefordert, dem Bot eine Direktnachricht zu senden.
  • /stop zielt auf die aktive Chatsitzung, um den aktuellen Lauf abzubrechen.
channels.slack.slashCommand unterstützt einen einzelnen Befehl im Stil von /openclaw. Erstellen Sie mit commands.native: true für jeden integrierten Befehl einen Slack-Slash-Befehl. Registrieren Sie /agentstatus (nicht /status), da Slack /status reserviert. Der Text /status funktioniert weiterhin in Slack-Nachrichten.
  • Nachrichten, die ausschließlich Befehle enthalten und von Absendern auf der Zulassungsliste stammen, werden sofort verarbeitet (Warteschlange und Modell werden umgangen).
  • Inline-Kurzbefehle (/help, /commands, /status, /whoami) funktionieren auch eingebettet in normale Nachrichten und werden entfernt, bevor das Modell den verbleibenden Text sieht.
  • Nicht autorisierte Nachrichten, die ausschließlich Befehle enthalten, werden stillschweigend ignoriert; eingebettete /...-Token werden als normaler Text behandelt.
  • Befehle akzeptieren optional ein : zwischen dem Befehl und den Argumenten (/think: high, /send: on).
  • /new <model> akzeptiert einen Modellalias, provider/model oder einen Provider-Namen (unscharfer Abgleich); wird keine Übereinstimmung gefunden, wird der Text als Nachrichtentext behandelt.
  • /allowlist add|remove erfordert commands.config: true und berücksichtigt configWrites des Kanals.

Provider-Nutzung und Status

  • Provider-Nutzung/Kontingent (z. B. „Claude: 80 % verbleibend“) wird in /status für den aktuellen Modell-Provider angezeigt, wenn die Nutzungsverfolgung aktiviert ist.
  • Token-/Cache-Zeilen in /status können auf den neuesten Nutzungseintrag des Transkripts zurückgreifen, wenn die Live-Sitzungsmomentaufnahme nur wenige Daten enthält.
  • Ausführung und Laufzeit: /status meldet Execution für den effektiven Sandbox-Pfad und Runtime dafür, wer die Sitzung ausführt: OpenClaw Default, OpenAI Codex, ein CLI-Backend oder ein ACP-Backend.
  • Token/Kosten pro Antwort: gesteuert durch /usage off|tokens|full.
  • /model status betrifft Modelle, Authentifizierung und Endpunkte, nicht die Nutzung.

Verwandte Themen

Skills

So werden Slash-Befehle von Skills registriert und zugriffsbeschränkt.

Skills erstellen

Erstellen Sie einen Skill, der seinen eigenen Slash-Befehl registriert.

BTW

Nebenfragen, ohne den Sitzungskontext zu ändern.

Steuern

Steuern Sie den Agenten während der Ausführung mit /steer.