Konfiguration — Kanäle

​

Kanäle

​

DM- und Gruppenzugriff

​

Kanalspezifische Modellüberschreibungen

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-5.6-sol",
        "user:U12345": "openai/gpt-5.4-mini",
      },
      telegram: {
        "-1001234567890": "openai/gpt-5.4-mini",
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
        "123456789": "openai/gpt-4.1",
      },
    },
  },
}

​

Kanalstandards und Heartbeat

{
  channels: {
    defaults: {
      groupPolicy: "allowlist", // open | allowlist | disabled
      contextVisibility: "all", // all | allowlist | allowlist_quote
      implicitMentions: {
        replyToBot: true,
        quotedBot: true,
        threadParticipation: true,
      },
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• channels.defaults.groupPolicy: Ersatz-Gruppenrichtlinie, wenn groupPolicy auf Providerebene nicht gesetzt ist.
• channels.defaults.contextVisibility: standardmäßiger Modus für die Sichtbarkeit ergänzenden Kontexts für alle Kanäle. Werte: all (Standard; gesamten zitierten, Thread- und Verlaufskontext einbeziehen), allowlist (nur Kontext von Absendern auf der Zulassungsliste einbeziehen), allowlist_quote (wie die Zulassungsliste, aber expliziten Zitat-/Antwortkontext beibehalten). Kanalspezifische Überschreibung: channels.<channel>.contextVisibility.
• channels.defaults.implicitMentions: steuert, welche unterstützten eingehenden Fakten als Erwähnungen gelten. replyToBot, quotedBot und threadParticipation verwenden jeweils standardmäßig true, wodurch das aktuelle Verhalten erhalten bleibt. Überschreiben Sie dies pro Kanal mit channels.<channel>.implicitMentions oder pro Konto mit channels.<channel>.accounts.<id>.implicitMentions; jedes Flag wird unabhängig in der Reihenfolge Konto -> Kanal -> Standardwerte aufgelöst. Die Namen sind positiv formuliert: Setzen Sie ein Flag auf false, damit dieser Fakt die Erwähnungssteuerung nicht mehr umgeht. Native explizite Erwähnungen sind immer zulässig, und ein Flag hat keine Wirkung, wenn der Kanal diesen Fakt nicht erzeugt. Die aktuelle Erzeugermatrix finden Sie unter Erwähnungssteuerung. Diese Einstellungen ändern weder die Modi für ausgehende Antworten/Threads noch die Verarbeitung autorisierter Befehle.
• channels.defaults.heartbeat.showOk: fehlerfreie Kanalstatus in die Heartbeat-Ausgabe aufnehmen (Standard false).
• channels.defaults.heartbeat.showAlerts: beeinträchtigte/fehlerhafte Status in die Heartbeat-Ausgabe aufnehmen (Standard true).
• channels.defaults.heartbeat.useIndicator: kompakte Heartbeat-Ausgabe im Indikatorstil darstellen (Standard true).

​

WhatsApp

{
  web: {
    enabled: true,
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" }, // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• Einträge der obersten Ebene in bindings[] mit type: "acp" konfigurieren persistente ACP-Bindungen für WhatsApp-DMs und -Gruppen. Verwenden Sie in match.peer.id eine direkte Nummer im E.164-Format oder eine WhatsApp-Gruppen-JID. Die Feldsemantik wird unter ACP-Agenten beschrieben.

{
  channels: {
    whatsapp: {
      accounts: {
        default: {},
        personal: {},
        biz: {
          // authDir: "~/.openclaw/credentials/whatsapp/biz",
        },
      },
    },
  },
}

​

Telegram

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "your-bot-token",
      dmPolicy: "pairing",
      allowFrom: ["tg:123456789"],
      groups: {
        "*": { requireMention: true },
        "-1001234567890": {
          allowFrom: ["@admin"],
          systemPrompt: "Keep answers brief.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Stay on topic.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: { mode: "partial" }, // off | partial | block | progress (default: partial)
      actions: { reactions: true, sendMessage: true },
      reactionNotifications: "own", // off | own | all
      mediaMaxMb: 100,
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
      network: {
        autoSelectFamily: true,
        dnsResultOrder: "ipv4first",
      },
      apiRoot: "https://api.telegram.org",
      trustedLocalFileRoots: ["/srv/telegram-bot-api-data"],
      proxy: "socks5://localhost:9050",
      webhookUrl: "https://example.com/telegram-webhook",
      webhookSecret: "secret",
      webhookPath: "/telegram-webhook",
    },
  },
}

• Bot-Token: channels.telegram.botToken oder channels.telegram.tokenFile (nur reguläre Datei; symbolische Links werden abgelehnt), mit TELEGRAM_BOT_TOKEN als Ersatz für das Standardkonto.
• apiRoot ist ausschließlich die Wurzel der Telegram Bot API. Verwenden Sie https://api.telegram.org oder die Wurzel Ihrer selbst gehosteten beziehungsweise Proxy-Instanz, nicht https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix entfernt ein versehentlich angehängtes /bot<TOKEN>-Suffix.
• Bei einem selbst gehosteten Bot-API-Server im --local-Modus listet trustedLocalFileRoots die Hostpfade auf, die OpenClaw lesen darf. Binden Sie das Datenvolume des Servers auf dem OpenClaw-Host ein und konfigurieren Sie entweder dessen Datenstamm oder das Token-spezifische Verzeichnis; Containerpfade unter /var/lib/telegram-bot-api werden diesen Stammverzeichnissen zugeordnet. Andere absolute Pfade werden weiterhin abgelehnt.
• Das optionale channels.telegram.defaultAccount überschreibt die Auswahl des Standardkontos, wenn es mit einer konfigurierten Konto-ID übereinstimmt.
• Legen Sie bei Mehrkontoeinrichtungen (2+ Konto-IDs) einen expliziten Standardwert fest (channels.telegram.defaultAccount oder channels.telegram.accounts.default), um Ersatz-Routing zu vermeiden; openclaw doctor warnt, wenn dieser fehlt oder ungültig ist.
• configWrites: false blockiert von Telegram initiierte Konfigurationsschreibvorgänge (Supergruppen-ID-Migrationen, /config set|unset).
• Einträge der obersten Ebene in bindings[] mit type: "acp" konfigurieren persistente ACP-Bindungen für Forenthemen (verwenden Sie das kanonische chatId:topic:topicId in match.peer.id). Die Feldsemantik wird unter ACP-Agenten beschrieben.
• Telegram-Streamingvorschauen verwenden sendMessage + editMessageText (funktioniert in Direkt- und Gruppenchats).
• network.dnsResultOrder verwendet standardmäßig "ipv4first", um häufige IPv6-Abruffehler zu vermeiden.
• Wiederholungsrichtlinie: siehe Wiederholungsrichtlinie.

​

Discord

{
  channels: {
    discord: {
      enabled: true,
      token: "your-bot-token",
      mediaMaxMb: 100,
      allowBots: false,
      actions: {
        reactions: true,
        stickers: true,
        polls: true,
        permissions: true,
        messages: true,
        threads: true,
        pins: true,
        search: true,
        memberInfo: true,
        roleInfo: true,
        roles: false,
        channelInfo: true,
        voiceStatus: true,
        events: true,
        moderation: false,
      },
      replyToMode: "off", // off | first | all | batched
      dmPolicy: "pairing",
      allowFrom: ["1234567890", "123456789012345678"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },
      guilds: {
        "123456789012345678": {
          slug: "friends-of-openclaw",
          requireMention: false,
          ignoreOtherMentions: true,
          reactionNotifications: "own",
          users: ["987654321098765432"],
          channels: {
            general: { allow: true },
            help: {
              allow: true,
              requireMention: true,
              users: ["987654321098765432"],
              skills: ["docs"],
              systemPrompt: "Nur kurze Antworten.",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      suppressEmbeds: true,
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord-Standard: progress)
        chunkMode: "length", // length | newline
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          toolProgress: true,
        },
      },
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSessions: true,
        defaultSpawnContext: "fork",
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        connectTimeoutMs: 30000,
        reconnectGraceMs: 15000,
        tts: {
          provider: "openai",
          openai: { voice: "alloy" },
        },
      },
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["987654321098765432"],
        agentFilter: ["default"],
        sessionFilter: ["discord:"],
        target: "dm", // dm | channel | both
        cleanupAfterResolve: false,
      },
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

• Token: channels.discord.token, mit DISCORD_BOT_TOKEN als Fallback für das Standardkonto.
• Direkte ausgehende Aufrufe, die explizit ein Discord-token angeben, verwenden dieses Token für den Aufruf; Einstellungen für Wiederholungsversuche und Richtlinien des Kontos stammen weiterhin aus dem ausgewählten Konto im aktiven Runtime-Snapshot.
• Das optionale channels.discord.defaultAccount überschreibt die Auswahl des Standardkontos, wenn es mit einer konfigurierten Konto-ID übereinstimmt.
• Verwenden Sie user:<id> (DM) oder channel:<id> (Guild-Kanal) für Zustellungsziele; reine numerische IDs werden abgelehnt.
• Guild-Slugs bestehen aus Kleinbuchstaben, wobei Leerzeichen durch - ersetzt werden; Kanalschlüssel verwenden den Namen als Slug (ohne #). Bevorzugen Sie Guild-IDs.
• Von Bots verfasste Nachrichten werden standardmäßig ignoriert. allowBots: true aktiviert sie; verwenden Sie allowBots: "mentions", um nur Bot-Nachrichten zu akzeptieren, in denen der Bot erwähnt wird (eigene Nachrichten werden weiterhin herausgefiltert).
• Kanäle, die von Bots verfasste eingehende Nachrichten unterstützen, können den gemeinsamen Bot-Schleifenschutz verwenden. Legen Sie channels.defaults.botLoopProtection für grundlegende Paarbudgets fest und überschreiben Sie anschließend den Kanal oder das Konto nur, wenn eine Oberfläche andere Grenzwerte benötigt.
• channels.discord.guilds.<id>.ignoreOtherMentions (und Kanalüberschreibungen) verwirft Nachrichten, die einen anderen Benutzer oder eine andere Rolle, aber nicht den Bot erwähnen (ausgenommen @everyone/@here).
• channels.discord.mentionAliases ordnet stabilen ausgehenden @handle-Text vor dem Senden Discord-Benutzer-IDs zu, sodass bekannte Teammitglieder auch dann deterministisch erwähnt werden können, wenn der temporäre Verzeichnis-Cache leer ist. Kontospezifische Überschreibungen befinden sich unter channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (Standard: 17) teilt hohe Nachrichten auch dann auf, wenn sie weniger als 2000 Zeichen umfassen.
• channels.discord.suppressEmbeds ist standardmäßig true, sodass ausgehende URLs nicht zu Discord-Linkvorschauen erweitert werden, sofern dies nicht deaktiviert wird. Explizite embeds-Payloads werden weiterhin normal gesendet; Tool-Aufrufe für einzelne Nachrichten können dies mit suppressEmbeds überschreiben.
• channels.discord.threadBindings steuert das an Discord-Threads gebundene Routing:
  • enabled: Discord-Überschreibung für an Threads gebundene Sitzungsfunktionen (/focus, /unfocus, /agents, /session idle, /session max-age sowie gebundene Zustellung und gebundenes Routing)
  • idleHours: Discord-Überschreibung für das automatische Aufheben des Fokus nach Inaktivität in Stunden (0 deaktiviert dies)
  • maxAgeHours: Discord-Überschreibung für das feste Höchstalter in Stunden (0 deaktiviert dies)
  • spawnSessions: Schalter für sessions_spawn({ thread: true }) und die automatische Thread-Erstellung/-Bindung beim Erzeugen von ACP-Threads (Standard: true)
  • defaultSpawnContext: nativer Subagent-Kontext für an Threads gebundene Erzeugungen (standardmäßig "fork")
• Einträge der obersten Ebene unter bindings[] mit type: "acp" konfigurieren persistente ACP-Bindungen für Kanäle und Threads (verwenden Sie die Kanal-/Thread-ID in match.peer.id). Die Feldsemantik wird unter ACP-Agenten gemeinsam erläutert.
• channels.discord.ui.components.accentColor legt die Akzentfarbe für Discord-Komponentencontainer der Version 2 fest.
• channels.discord.agentComponents.ttlMs steuert, wie lange Callbacks gesendeter Discord-Komponenten registriert bleiben. Standard: 1800000 (30 Minuten), Maximum: 86400000 (24 Stunden). Kontospezifische Überschreibungen befinden sich unter channels.discord.accounts.<accountId>.agentComponents.ttlMs. Bevorzugen Sie die kürzeste TTL, die für den Workflow ausreicht.
• channels.discord.voice aktiviert Unterhaltungen in Discord-Sprachkanälen sowie optionale Überschreibungen für automatischen Beitritt, LLM und TTS. Reine Textkonfigurationen für Discord lassen Sprachfunktionen standardmäßig deaktiviert; setzen Sie channels.discord.voice.enabled=true, um sie zu aktivieren.
• channels.discord.voice.model überschreibt optional das LLM-Modell, das für Antworten in Discord-Sprachkanälen verwendet wird.
• channels.discord.voice.daveEncryption (Standard: true) und channels.discord.voice.decryptionFailureTolerance (Standard: 24) werden an die DAVE-Optionen von @discordjs/voice durchgereicht.
• channels.discord.voice.connectTimeoutMs steuert die anfängliche Wartezeit auf den @discordjs/voice-Ready-Zustand für /vc join und Versuche zum automatischen Beitritt (Standard: 30000).
• channels.discord.voice.reconnectGraceMs steuert, wie lange eine getrennte Sprachsitzung benötigen darf, um in die Signalisierung für die Wiederverbindung einzutreten, bevor OpenClaw sie beendet (Standard: 15000).
• Die Discord-Sprachwiedergabe wird nicht durch das Ereignis zum Sprechbeginn eines anderen Benutzers unterbrochen. Um Rückkopplungsschleifen zu vermeiden, ignoriert OpenClaw neue Sprachaufnahmen, während TTS wiedergegeben wird.
• OpenClaw versucht zusätzlich, den Sprachempfang nach wiederholten Entschlüsselungsfehlern wiederherzustellen, indem es eine Sprachsitzung verlässt und ihr erneut beitritt.
• channels.discord.streaming ist der kanonische Schlüssel für den Streaming-Modus. Discord verwendet standardmäßig streaming.mode: "progress", sodass der Fortschritt von Tools und Arbeiten in einer einzigen bearbeiteten Vorschaunachricht erscheint; setzen Sie streaming.mode: "off", um dies zu deaktivieren. Veraltete flache Schlüssel (streamMode, chunkMode, blockStreaming, draftChunk, blockStreamingCoalesce) werden zur Laufzeit nicht mehr gelesen; führen Sie openclaw doctor --fix aus, um die persistierte Konfiguration zu migrieren.
• channels.discord.autoPresence ordnet die Runtime-Verfügbarkeit der Bot-Präsenz zu (fehlerfrei => online, beeinträchtigt => idle, erschöpft => dnd) und erlaubt optionale Überschreibungen des Statustexts.
• channels.discord.guilds.<id>.presenceEvents leitet Ereignisse zur Verfügbarkeit von Personen als Agent-Systemereignisse an einen konfigurierten Discord-Kanal weiter. Berechtigte Mitglieder müssen channelId sehen können; öffentliche Threads erben die Sichtbarkeit des übergeordneten Elements, während private Threads zusätzlich eine Mitgliedschaft oder Manage Threads erfordern. users kann diesen Personenkreis weiter einschränken. Die Funktion initialisiert aktuell online befindliche Mitglieder aus vollständigen GUILD_CREATE-Snapshots, leitet beobachtete Übergänge von offline zu online weiter und behandelt ein erstes späteres Online-Signal eines zuvor nicht gesehenen Mitglieds als neu verfügbar, ohne festzustellen, ob die Person online gegangen oder erst nach dem Snapshot beigetreten ist. Guilds oberhalb des Discord-Snapshot-Limits von 75,000 Mitgliedern benötigen zunächst eine explizite Offline-Aktualisierung. Optionen zur Drosselung: reconnectSuppressSeconds (Ruhefenster nach einer neuen Gateway-Sitzung, während der Guild-Präsenzstatus neu aufgebaut wird; Standard: 300, 0 deaktiviert es) und burstLimit/burstWindowSeconds (Ratenbegrenzung für erfolgreich in die Warteschlange gestellte Ereignisse pro Guild; Standard: 8 Ereignisse pro gleitendem 60s-Fenster). Fortgesetzte Sitzungen starten das Unterdrückungsfenster für Wiederverbindungen nicht. Die bestehende Abklingzeit für erneute Begrüßungen pro Benutzer bleibt bei acht Stunden. Erforderlich sind channels.discord.intents.presence=true, der privilegierte Presence Intent im Developer Portal von Discord und ein aktivierter Agent-Heartbeat.
• channels.discord.dangerouslyAllowNameMatching aktiviert die veränderliche Namens-/Tag-Zuordnung erneut (Break-Glass-Kompatibilitätsmodus).
• channels.discord.execApprovals: Discord-native Zustellung von Ausführungsgenehmigungen und Autorisierung der Genehmigenden.
  • enabled: true, false oder "auto" (Standard). Im automatischen Modus werden Ausführungsgenehmigungen aktiviert, wenn Genehmigende über approvers oder commands.ownerAllowFrom aufgelöst werden können.
  • approvers: Discord-Benutzer-IDs, die Ausführungsanfragen genehmigen dürfen. Fällt bei Auslassung auf commands.ownerAllowFrom zurück.
  • agentFilter: optionale Positivliste für Agent-IDs. Lassen Sie sie weg, um Genehmigungen für alle Agenten weiterzuleiten.
  • sessionFilter: optionale Muster für Sitzungsschlüssel (Teilzeichenfolge oder regulärer Ausdruck).
  • target: Ziel für Genehmigungsaufforderungen. "dm" (Standard) sendet sie an die DMs der Genehmigenden, "channel" sendet sie an den Ursprungskanal und "both" sendet sie an beide. Wenn das Ziel "channel" umfasst, können die Schaltflächen nur von den ermittelten Genehmigenden verwendet werden.
  • cleanupAfterResolve: Wenn true gesetzt ist, werden Genehmigungs-DMs nach Genehmigung, Ablehnung oder Zeitüberschreitung gelöscht.

​

Google Chat

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url", // app-url | project-number
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890",
      dmPolicy: "pairing",
      allowFrom: ["users/1234567890"],
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• Dienstkonto-JSON: inline (serviceAccount) oder dateibasiert (serviceAccountFile).
• serviceAccount akzeptiert direkt eine SecretRef.
• Umgebungs-Fallbacks: GOOGLE_CHAT_SERVICE_ACCOUNT oder GOOGLE_CHAT_SERVICE_ACCOUNT_FILE (nur für das Standardkonto).
• Verwenden Sie spaces/<spaceId> oder users/<userId> für Zustellungsziele.
• channels.googlechat.dangerouslyAllowNameMatching aktiviert die veränderliche Zuordnung von E-Mail-Principals erneut (Break-Glass-Kompatibilitätsmodus).

​

Slack

{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      socketMode: {
        clientPingTimeout: 15000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
      dmPolicy: "pairing",
      allowFrom: ["U123", "U456", "*"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
      channels: {
        C123: { enabled: true, requireMention: true, allowBots: false },
        "#general": {
          enabled: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Nur kurze Antworten.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
        initialHistoryLimit: 20,
      },
      actions: {
        reactions: true,
        messages: true,
        pins: true,
        memberInfo: true,
        emojiList: true,
      },
      slashCommand: {
        enabled: true,
        name: "openclaw",
        sessionPrefix: "slack:slash",
        ephemeral: true,
      },
      typingReaction: "hourglass_flowing_sand",
      unfurlLinks: false,
      unfurlMedia: false,
      textChunkLimit: 4000,
      streaming: {
        mode: "partial", // off | partial | block | progress
        chunkMode: "length", // length | newline
        nativeTransport: true, // native Slack-Streaming-API verwenden, wenn mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Socket-Modus erfordert sowohl botToken als auch appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN für den Umgebungsvariablen-Fallback des Standardkontos).
• HTTP-Modus erfordert botToken sowie signingSecret (auf Stammebene oder pro Konto).
• Benutzeridentität (identity: "user") veröffentlicht und liest als der autorisierende Mensch. Sie erfordert userToken sowie appToken im Socket-Modus oder userToken sowie signingSecret im HTTP-Modus. Weder ein Bot-Token noch ein Bot-Benutzer ist erforderlich. Informationen zu Benutzerberechtigungen und Ereignisabonnements finden Sie unter Benutzeridentität.
• enterpriseOrgInstall: true bindet ein Konto in den organisationsweiten Ereignispfad von Slack Enterprise Grid ein. Beim Start wird das Bot-Token mit auth.test überprüft; der Start schlägt fehl, wenn der konfigurierte Modus nicht mit der Installationsidentität von Slack übereinstimmt. Unternehmens-DMs müssen deaktiviert sein oder dmPolicy: "open" mit einem wirksamen allowFrom: ["*"] verwenden. Kanal- und Benutzerrichtlinien müssen stabile Slack-IDs verwenden; veränderliche Namen und nicht unterstützte Kanalpräfixe führen zum Fehlschlagen des Starts. V1 verarbeitet nur direkte Socket-Modus- oder HTTP-Ereignisse vom Typ message und app_mention mit sofortigen Antworten; Relay, Befehle, Interaktionen, App Home, Listener für Reaktionsereignisse, Pins, Aktionswerkzeuge, native Genehmigungen, Bindungen, verzögerte Zustellung und proaktives Senden sind nicht verfügbar. Listener-eigene Bestätigungen, Tipp- und Statusreaktionen bleiben mit reactions:write verfügbar; eingehende Reaktionsbenachrichtigungen und Reaktionsaktionswerkzeuge sind nicht verfügbar. Informationen zum Least-Privilege-Manifest, Einrichtungsablauf und zu allen Einschränkungen finden Sie unter Organisationsweite Enterprise-Grid-Installationen.
• socketMode übergibt die Transportoptimierung des Slack-SDK-Socket-Modus an die öffentliche Bolt-Receiver-API. Verwenden Sie dies nur zur Untersuchung von Ping/Pong-Zeitüberschreitungen oder veraltetem WebSocket-Verhalten. clientPingTimeout verwendet standardmäßig 15000; serverPingTimeout und pingPongLoggingEnabled werden nur übergeben, wenn sie konfiguriert sind.
• botToken, appToken, signingSecret und userToken akzeptieren Klartextzeichenfolgen oder SecretRef-Objekte.
• Slack-Kontomomentaufnahmen stellen quell- und statusbezogene Felder pro Anmeldedaten bereit, beispielsweise botTokenSource, botTokenStatus, userTokenSource, userTokenStatus, appTokenStatus und im HTTP-Modus signingSecretStatus. configured_unavailable bedeutet, dass das Konto über SecretRef konfiguriert ist, der aktuelle Befehls- bzw. Laufzeitpfad den Geheimniswert jedoch nicht auflösen konnte.
• configWrites: false blockiert von Slack initiierte Konfigurationsschreibvorgänge.
• Das optionale channels.slack.defaultAccount überschreibt die Auswahl des Standardkontos, wenn es mit einer konfigurierten Konto-ID übereinstimmt.
• channels.slack.streaming.mode ist der kanonische Schlüssel für den Slack-Stream-Modus (Standard: "partial"). channels.slack.streaming.nativeTransport steuert den nativen Streaming-Transport von Slack (Standard: true). Veraltete Werte für streamMode, den booleschen Wert streaming, chunkMode, blockStreaming, blockStreamingCoalesce und nativeStreaming werden zur Laufzeit nicht mehr gelesen; führen Sie openclaw doctor --fix aus, um die persistierte Konfiguration zu streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport} zu migrieren.
• unfurlLinks und unfurlMedia übergeben die booleschen Slack-Werte chat.postMessage für Link- und Medienvorschauen bei Bot-Antworten. unfurlLinks verwendet standardmäßig false, sodass ausgehende Bot-Links nicht inline erweitert werden, sofern dies nicht aktiviert ist; unfurlMedia wird weggelassen, sofern es nicht konfiguriert ist. Legen Sie einen der Werte unter channels.slack.accounts.<accountId> fest, um den Wert der obersten Ebene für ein einzelnes Konto zu überschreiben.
• Verwenden Sie user:<id> (DM) oder channel:<id> als Zustellungsziele.

• Natives Slack-Streaming sowie der assistentenähnliche Thread-Status „is typing…“ von Slack erfordern einen Antwort-Thread als Ziel. DMs auf oberster Ebene bleiben standardmäßig außerhalb von Threads, sodass sie weiterhin über Slack-Entwurfsvorschauen mit Veröffentlichung und Bearbeitung streamen können, anstatt die native, threadbasierte Stream-/Statusvorschau anzuzeigen.
• typingReaction fügt der eingehenden Slack-Nachricht vorübergehend eine Reaktion hinzu, während eine Antwort ausgeführt wird, und entfernt sie nach Abschluss. Verwenden Sie einen Slack-Emoji-Shortcode wie "hourglass_flowing_sand".
• channels.slack.execApprovals: Slack-native Zustellung an den Genehmigungsclient und Autorisierung ausführender Genehmiger. Dasselbe Schema wie bei Discord: enabled (true/false/"auto"), approvers (Slack-Benutzer-IDs), agentFilter, sessionFilter und target ("dm", "channel" oder "both"). Plugin-Genehmigungen können diesen nativen Clientpfad für von Slack stammende Anfragen verwenden, wenn Slack-Plugin-Genehmiger aufgelöst werden; die Slack-native Zustellung von Plugin-Genehmigungen kann außerdem über approvals.plugin für von Slack stammende Sitzungen oder Slack-Ziele aktiviert werden. Plugin-Genehmigungen verwenden Slack-Plugin-Genehmiger aus allowFrom und das Standardrouting, nicht die ausführenden Genehmiger.

​

Mattermost

openclaw plugins install @openclaw/mattermost

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
      chatmode: "oncall", // oncall | onmessage | onchar
      oncharPrefixes: [">", "!"],
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
      commands: {
        native: true, // optional aktivieren
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Optionale explizite URL für Reverse-Proxy-/öffentliche Bereitstellungen
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" },
    },
  },
}

• commands.callbackPath muss ein Pfad sein (beispielsweise /api/channels/mattermost/command), keine vollständige URL.
• commands.callbackUrl muss zum OpenClaw-Gateway-Endpunkt aufgelöst werden und vom Mattermost-Server erreichbar sein.
• Native Slash-Callbacks werden mit den befehlsspezifischen Tokens authentifiziert, die Mattermost bei der Registrierung von Slash-Befehlen zurückgibt. Wenn die Registrierung fehlschlägt oder keine Befehle aktiviert werden, lehnt OpenClaw Callbacks mit Unauthorized: invalid command token. ab.
• Bei privaten Callback-Hosts bzw. Callback-Hosts im Tailnet oder internen Netz kann Mattermost verlangen, dass ServiceSettings.AllowedUntrustedInternalConnections den Callback-Host bzw. die Callback-Domain enthält. Verwenden Sie Host-/Domainwerte, keine vollständigen URLs.
• channels.mattermost.configWrites: von Mattermost initiierte Konfigurationsschreibvorgänge zulassen oder verweigern.
• channels.mattermost.requireMention: @mention vor dem Antworten in Kanälen voraussetzen.
• channels.mattermost.groups.<channelId>.requireMention: kanalspezifische Überschreibung der Erwähnungspflicht ("*" für den Standard).
• Das optionale channels.mattermost.defaultAccount überschreibt die Auswahl des Standardkontos, wenn es mit einer konfigurierten Konto-ID übereinstimmt.

​

Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // optionale Kontobindung
      dmPolicy: "pairing",
      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      configWrites: true,
      reactionNotifications: "own", // off | own | all | allowlist
      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      historyLimit: 50,
    },
  },
}

• channels.signal.account: den Kanalstart an eine bestimmte Signal-Kontoidentität binden.
• channels.signal.configWrites: von Signal initiierte Konfigurationsschreibvorgänge zulassen oder verweigern.
• Das optionale channels.signal.defaultAccount überschreibt die Auswahl des Standardkontos, wenn es mit einer konfigurierten Konto-ID übereinstimmt.

​

iMessage

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
      remoteHost: "user@gateway-host",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],
      historyLimit: 50,
      includeAttachments: false,
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      mediaMaxMb: 16,
      service: "auto",
      sendTransport: "auto",
      region: "US",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
    },
  },
}

• Optional überschreibt channels.imessage.defaultAccount die standardmäßige Kontoauswahl, wenn der Wert mit einer konfigurierten Konto-ID übereinstimmt.
• Erfordert vollständigen Festplattenzugriff auf die Nachrichtendatenbank.
• Bevorzugen Sie chat_id:<id>-Ziele. Verwenden Sie imsg chats --limit 20, um Chats aufzulisten.
• cliPath kann auf einen SSH-Wrapper verweisen; legen Sie remoteHost (host oder user@host) für den Abruf von Anhängen per SCP fest.
• attachmentRoots und remoteAttachmentRoots beschränken die Pfade eingehender Anhänge (Standard: /Users/*/Library/Messages/Attachments).
• SCP verwendet eine strikte Hostschlüsselprüfung. Stellen Sie daher sicher, dass der Hostschlüssel des Relay-Hosts bereits in ~/.ssh/known_hosts vorhanden ist.
• channels.imessage.configWrites: Von iMessage initiierte Konfigurationsschreibvorgänge zulassen oder verweigern.
• channels.imessage.sendTransport: bevorzugter imsg-RPC-Sendetransport für normale ausgehende Antworten. auto (Standard) verwendet für bestehende Chats die IMCore-Bridge, wenn sie ausgeführt wird, und greift anschließend auf AppleScript zurück; bridge erfordert die Zustellung über eine private API; applescript erzwingt den öffentlichen Automatisierungspfad von Nachrichten.
• channels.imessage.actions.*: Private API-Aktionen aktivieren, die zusätzlich durch imsg status / openclaw channels status --probe eingeschränkt werden.
• channels.imessage.includeAttachments ist standardmäßig deaktiviert; legen Sie den Wert auf true fest, bevor Sie eingehende Medien in Agentendurchläufen erwarten.
• Die Wiederherstellung eingehender Nachrichten nach einem Neustart der Bridge/des Gateways erfolgt automatisch (GUID-Deduplizierung plus Altersgrenze für veraltete Rückstände). Bestehende channels.imessage.catchup.enabled: true-Konfigurationen werden weiterhin als veraltetes Kompatibilitätsprofil berücksichtigt; catchup ist standardmäßig deaktiviert.
• channels.imessage.groups: Gruppenregister und gruppenspezifische Einstellungen. Konfigurieren Sie bei groupPolicy: "allowlist" entweder explizite chat_id-Schlüssel oder einen "*"-Platzhaltereintrag, damit Gruppennachrichten die Registerprüfung passieren können.
• Einträge der obersten Ebene unter bindings[] mit type: "acp" können iMessage-Unterhaltungen an persistente ACP-Sitzungen binden. Verwenden Sie in match.peer.id ein normalisiertes Handle oder ein explizites Chatziel (chat_id:*, chat_guid:*, chat_identifier:*). Gemeinsame Feldsemantik: ACP-Agenten.

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

​

Matrix

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
      encryption: true,
      initialSyncLimit: 20,
      defaultAccount: "ops",
      accounts: {
        ops: {
          name: "Ops",
          userId: "@ops:example.org",
          accessToken: "syt_ops_xxx",
        },
        alerts: {
          userId: "@alerts:example.org",
          password: "secret",
          proxy: "http://127.0.0.1:7891",
        },
      },
    },
  },
}

• Die Token-Authentifizierung verwendet accessToken; die Passwortauthentifizierung verwendet userId + password.
• channels.matrix.proxy leitet den Matrix-HTTP-Datenverkehr über einen expliziten HTTP(S)-Proxy. Benannte Konten können dies mit channels.matrix.accounts.<id>.proxy überschreiben.
• channels.matrix.network.dangerouslyAllowPrivateNetwork lässt private/interne Homeserver zu. proxy und diese Netzwerkfreigabe sind voneinander unabhängige Steuerelemente.
• channels.matrix.defaultAccount wählt das bevorzugte Konto in Konfigurationen mit mehreren Konten aus.
• channels.matrix.autoJoin verwendet standardmäßig "off", sodass Einladungen zu Räumen und neue DM-ähnliche Einladungen ignoriert werden, bis Sie autoJoin: "allowlist" mit autoJoinAllowlist oder autoJoin: "always" festlegen.
• channels.matrix.execApprovals: Matrix-native Übermittlung von Ausführungsgenehmigungen und Autorisierung der Genehmigenden.
  • enabled: true, false oder "auto" (Standard). Im automatischen Modus werden Ausführungsgenehmigungen aktiviert, wenn die Genehmigenden aus approvers oder commands.ownerAllowFrom ermittelt werden können.
  • approvers: Matrix-Benutzer-IDs (z. B. @owner:example.org), die Ausführungsanfragen genehmigen dürfen.
  • agentFilter: optionale Positivliste für Agenten-IDs. Lassen Sie sie weg, um Genehmigungen für alle Agenten weiterzuleiten.
  • sessionFilter: optionale Muster für Sitzungsschlüssel (Teilzeichenfolge oder regulärer Ausdruck).
  • target: Ziel für Genehmigungsaufforderungen. "dm" (Standard), "channel" (Ursprungsraum) oder "both".
  • Kontospezifische Überschreibungen: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope steuert, wie Matrix-DMs zu Sitzungen gruppiert werden: per-user (Standard) verwendet eine gemeinsame Sitzung pro weitergeleitetem Kommunikationspartner, während per-room jeden DM-Raum isoliert.
• Matrix-Statusprüfungen und Live-Verzeichnissuchen verwenden dieselbe Proxy-Richtlinie wie der Laufzeitdatenverkehr.
• Die vollständige Matrix-Konfiguration, Zielregeln und Einrichtungsbeispiele sind unter Matrix dokumentiert.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // siehe /channels/msteams
    },
  },
}

• Hier behandelte zentrale Schlüsselpfade: channels.msteams, channels.msteams.configWrites.
• Die vollständige Teams-Konfiguration (Anmeldedaten, Webhook, DM-/Gruppenrichtlinie sowie team- und kanalspezifische Überschreibungen) ist unter Microsoft Teams dokumentiert.

​

IRC

{
  channels: {
    irc: {
      enabled: true,
      dmPolicy: "pairing",
      configWrites: true,
      nickserv: {
        enabled: true,
        service: "NickServ",
        password: "${IRC_NICKSERV_PASSWORD}",
        register: false,
        registerEmail: "bot@example.com",
      },
    },
  },
}

• Hier behandelte zentrale Schlüsselpfade: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• Optional überschreibt channels.irc.defaultAccount die standardmäßige Kontoauswahl, wenn der Wert mit einer konfigurierten Konto-ID übereinstimmt.
• Die vollständige IRC-Kanalkonfiguration (Host/Port/TLS/Kanäle/Positivlisten/Erwähnungsprüfung) ist unter IRC dokumentiert.

​

Mehrere Konten (alle Kanäle)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• default wird verwendet, wenn accountId weggelassen wird (CLI + Routing).
• Umgebungsvariablen-Token gelten nur für das Standardkonto.
• Die grundlegenden Kanaleinstellungen gelten für alle Konten, sofern sie nicht kontospezifisch überschrieben werden.
• Verwenden Sie bindings[].match.accountId, um jedes Konto an einen anderen Agenten weiterzuleiten.
• Wenn Sie über openclaw channels add (oder die Kanaleinrichtung) ein nicht standardmäßiges Konto hinzufügen, während weiterhin eine Einkontokonfiguration des Kanals auf oberster Ebene verwendet wird, verschiebt OpenClaw zunächst die kontospezifischen Einkontowerte der obersten Ebene in die Kontozuordnung des Kanals, damit das ursprüngliche Konto weiterhin funktioniert. Die meisten Kanäle verschieben sie nach channels.<channel>.accounts.default; Matrix kann stattdessen ein vorhandenes passendes benanntes Ziel oder Standardziel beibehalten.
• Bestehende rein kanalbezogene Bindungen (ohne accountId) stimmen weiterhin mit dem Standardkonto überein; kontospezifische Bindungen bleiben optional.
• openclaw doctor --fix repariert außerdem gemischte Strukturen, indem kontospezifische Einkontowerte der obersten Ebene in das für diesen Kanal ausgewählte hochgestufte Konto verschoben werden. Die meisten Kanäle verwenden accounts.default; Matrix kann stattdessen ein vorhandenes passendes benanntes Ziel oder Standardziel beibehalten.

​

Weitere Plugin-Kanäle

​

Erwähnungsprüfung in Gruppenchats

• Metadaten-Erwähnungen: Native @Erwähnungen der Plattform. Werden im WhatsApp-Selbstchatmodus ignoriert.
• Textmuster: Sichere Regex-Muster in agents.entries.*.groupChat.mentionPatterns. Ungültige Muster und unsichere verschachtelte Wiederholungen werden ignoriert.
• Die Erwähnungsbeschränkung wird nur durchgesetzt, wenn eine Erkennung möglich ist (native Erwähnungen oder mindestens ein Muster).

{
  messages: {
    visibleReplies: "automatic", // alte automatische finale Antworten für Direkt-/Quellchats erzwingen
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // dauerhaft aktives, nicht erwähnendes Raumgeplauder wird zu stillem Kontext
      visibleReplies: "message_tool", // Opt-in; message(action=send) für sichtbare Raumantworten voraussetzen
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

Verlaufslimits für Direktnachrichten

{
  channels: {
    telegram: {
      dmHistoryLimit: 30,
      dms: {
        "123456789": { historyLimit: 50 },
      },
    },
  },
}

​

Selbstchatmodus

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },
      },
    ],
  },
}

​

Befehle (Verarbeitung von Chatbefehlen)

{
  commands: {
    native: "auto", // native Befehle registrieren, sofern unterstützt
    nativeSkills: "auto", // native Skill-Befehle registrieren, sofern unterstützt
    text: true, // /commands in Chatnachrichten parsen
    bash: false, // ! zulassen (Alias: /bash)
    bashForegroundMs: 2000,
    config: false, // /config zulassen
    mcp: false, // /mcp zulassen
    plugins: false, // /plugins zulassen
    debug: false, // /debug zulassen
    restart: true, // /restart und externe SIGUSR1-Neustartanforderungen zulassen
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

Verwandte Themen

• Konfigurationsreferenz — Schlüssel der obersten Ebene
• Konfiguration — Agenten
• Kanalübersicht