Konfiguracja — kanały

​

Kanały

​

Dostęp DM i grupowy

​

Nadpisania modelu kanału

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-5.5",
        "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",
      },
    },
  },
}

​

Domyślne ustawienia kanałów i Heartbeat

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

• channels.defaults.groupPolicy: zapasowa zasada grupowa, gdy groupPolicy na poziomie dostawcy nie jest ustawione.
• channels.defaults.contextVisibility: domyślny tryb widoczności dodatkowego kontekstu dla wszystkich kanałów. Wartości: all (domyślnie, uwzględnia cały cytowany/wątkowy/historyczny kontekst), allowlist (uwzględnia tylko kontekst od nadawców z listy zezwoleń), allowlist_quote (tak samo jak allowlist, ale zachowuje jawny kontekst cytatu/odpowiedzi). Nadpisanie dla kanału: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: uwzględniaj zdrowe statusy kanałów w wyjściu Heartbeat.
• channels.defaults.heartbeat.showAlerts: uwzględniaj statusy zdegradowane/błędów w wyjściu Heartbeat.
• channels.defaults.heartbeat.useIndicator: renderuj kompaktowe wyjście Heartbeat w stylu wskaźnika.

​

WhatsApp

{
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      chunkMode: "length", // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• Wpisy najwyższego poziomu bindings[] z type: "acp" konfigurują trwałe powiązania ACP dla DM i grup WhatsApp. Użyj bezpośredniego numeru E.164 lub JID grupy WhatsApp w match.peer.id. Semantyka pól jest wspólna w Agentach ACP.

{
  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: "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",
      proxy: "socks5://localhost:9050",
      webhookUrl: "https://example.com/telegram-webhook",
      webhookSecret: "secret",
      webhookPath: "/telegram-webhook",
    },
  },
}

• Token bota: channels.telegram.botToken lub channels.telegram.tokenFile (tylko zwykły plik; dowiązania symboliczne są odrzucane), z TELEGRAM_BOT_TOKEN jako wartością zapasową dla konta domyślnego.
• apiRoot to tylko korzeń Telegram Bot API. Użyj https://api.telegram.org albo własnego hostowanego/proxy korzenia, a nie https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix usuwa przypadkowy końcowy sufiks /bot<TOKEN>.
• Opcjonalne channels.telegram.defaultAccount nadpisuje wybór domyślnego konta, gdy pasuje do skonfigurowanego identyfikatora konta.
• W konfiguracjach wielu kont (2+ identyfikatory kont) ustaw jawne domyślne konto (channels.telegram.defaultAccount lub channels.telegram.accounts.default), aby uniknąć zapasowego trasowania; openclaw doctor ostrzega, gdy tego brakuje albo jest nieprawidłowe.
• configWrites: false blokuje zapisy konfiguracji inicjowane przez Telegram (migracje identyfikatorów supergrup, /config set|unset).
• Wpisy najwyższego poziomu bindings[] z type: "acp" konfigurują trwałe powiązania ACP dla tematów forum (użyj kanonicznego chatId:topic:topicId w match.peer.id). Semantyka pól jest wspólna w Agentach ACP.
• Podglądy strumieni Telegram używają sendMessage + editMessageText (działa w czatach bezpośrednich i grupowych).
• Zasada ponawiania: zobacz Zasadę ponawiania.

​

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: "Short answers only.",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      suppressEmbeds: true,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        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, z DISCORD_BOT_TOKEN jako wartością zastępczą dla domyślnego konta.
• Bezpośrednie wywołania wychodzące, które podają jawny token Discord, używają tego tokenu dla wywołania; ustawienia ponawiania i zasad konta nadal pochodzą z wybranego konta w aktywnej migawce środowiska uruchomieniowego.
• Opcjonalne channels.discord.defaultAccount nadpisuje wybór domyślnego konta, gdy pasuje do skonfigurowanego identyfikatora konta.
• Użyj user:<id> (DM) lub channel:<id> (kanał gildii) jako celów dostarczania; same numeryczne identyfikatory są odrzucane.
• Slugi gildii są pisane małymi literami, ze spacjami zastąpionymi przez -; klucze kanałów używają nazwy w formie sluga (bez #). Preferuj identyfikatory gildii.
• Wiadomości utworzone przez boty są domyślnie ignorowane. allowBots: true je włącza; użyj allowBots: "mentions", aby akceptować tylko wiadomości botów, które wspominają bota (własne wiadomości nadal są filtrowane).
• Kanały obsługujące przychodzące wiadomości utworzone przez boty mogą używać wspólnej ochrony przed pętlą botów. Ustaw channels.defaults.botLoopProtection dla bazowych budżetów par, a następnie nadpisz kanał lub konto tylko wtedy, gdy jedna powierzchnia wymaga innych limitów.
• channels.discord.guilds.<id>.ignoreOtherMentions (oraz nadpisania kanałów) odrzuca wiadomości, które wspominają innego użytkownika lub rolę, ale nie bota (z wyłączeniem @everyone/@here).
• channels.discord.mentionAliases mapuje stabilny tekst wychodzący @handle na identyfikatory użytkowników Discord przed wysłaniem, dzięki czemu znani członkowie zespołu mogą być wspominani deterministycznie nawet wtedy, gdy przejściowy cache katalogu jest pusty. Nadpisania dla poszczególnych kont znajdują się w channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (domyślnie 17) dzieli wysokie wiadomości nawet wtedy, gdy mają mniej niż 2000 znaków.
• channels.discord.suppressEmbeds domyślnie ma wartość true, więc wychodzące adresy URL nie rozwijają się w podglądy linków Discord, chyba że zostanie to wyłączone. Jawne ładunki embeds nadal są wysyłane normalnie; wywołania narzędzi dla pojedynczych wiadomości mogą nadpisać to przez suppressEmbeds.
• channels.discord.threadBindings steruje routingiem powiązanym z wątkami Discord:
  • enabled: nadpisanie Discord dla funkcji sesji powiązanych z wątkami (/focus, /unfocus, /agents, /session idle, /session max-age oraz powiązane dostarczanie/routing)
  • idleHours: nadpisanie Discord dla automatycznego cofnięcia skupienia po braku aktywności w godzinach (0 wyłącza)
  • maxAgeHours: nadpisanie Discord dla twardego maksymalnego wieku w godzinach (0 wyłącza)
  • spawnSessions: przełącznik dla sessions_spawn({ thread: true }) oraz automatycznego tworzenia/powiązania wątków przez ACP thread-spawn (domyślnie: true)
  • defaultSpawnContext: natywny kontekst subagenta dla uruchomień powiązanych z wątkami (domyślnie "fork")
• Wpisy najwyższego poziomu bindings[] z type: "acp" konfigurują trwałe powiązania ACP dla kanałów i wątków (użyj identyfikatora kanału/wątku w match.peer.id). Semantyka pól jest wspólna w Agentach ACP.
• channels.discord.ui.components.accentColor ustawia kolor akcentu dla kontenerów komponentów Discord v2.
• channels.discord.agentComponents.ttlMs określa, jak długo wysłane callbacki komponentów Discord pozostają zarejestrowane. Wartość domyślna to 1800000 (30 minut), maksimum to 86400000 (24 godziny), a nadpisania dla poszczególnych kont znajdują się w channels.discord.accounts.<accountId>.agentComponents.ttlMs. Dłuższe wartości pozwalają dłużej używać starych przycisków, selektorów i formularzy, więc preferuj najkrótszy TTL pasujący do przepływu pracy.
• channels.discord.voice włącza rozmowy na kanałach głosowych Discord oraz opcjonalne nadpisania automatycznego dołączania, LLM i TTS. Konfiguracje Discord tylko tekstowe domyślnie pozostawiają głos wyłączony; ustaw channels.discord.voice.enabled=true, aby go włączyć.
• channels.discord.voice.model opcjonalnie nadpisuje model LLM używany dla odpowiedzi na kanałach głosowych Discord.
• channels.discord.voice.daveEncryption i channels.discord.voice.decryptionFailureTolerance są przekazywane do opcji DAVE @discordjs/voice (domyślnie true i 24).
• channels.discord.voice.connectTimeoutMs steruje początkowym oczekiwaniem na Ready @discordjs/voice dla /vc join oraz prób automatycznego dołączania (domyślnie 30000).
• channels.discord.voice.reconnectGraceMs określa, jak długo rozłączona sesja głosowa może wejść w sygnalizację ponownego połączenia, zanim OpenClaw ją zniszczy (domyślnie 15000).
• Odtwarzanie głosu Discord nie jest przerywane przez zdarzenie rozpoczęcia mówienia innego użytkownika. Aby uniknąć pętli sprzężenia zwrotnego, OpenClaw ignoruje nowe przechwytywanie głosu podczas odtwarzania TTS.
• OpenClaw dodatkowo próbuje odzyskać odbiór głosu przez opuszczenie i ponowne dołączenie do sesji głosowej po powtarzających się niepowodzeniach deszyfrowania.
• channels.discord.streaming jest kanonicznym kluczem trybu strumienia. Discord domyślnie używa streaming.mode: "progress", dzięki czemu postęp narzędzi/pracy pojawia się w jednej edytowanej wiadomości podglądu; ustaw streaming.mode: "off", aby to wyłączyć. Starsze wartości streamMode i logiczne streaming pozostają aliasami środowiska uruchomieniowego; uruchom openclaw doctor --fix, aby przepisać utrwaloną konfigurację.
• channels.discord.autoPresence mapuje dostępność środowiska uruchomieniowego na obecność bota (healthy => online, degraded => idle, exhausted => dnd) i pozwala na opcjonalne nadpisania tekstu statusu.
• channels.discord.dangerouslyAllowNameMatching ponownie włącza dopasowywanie po zmiennej nazwie/tagu (awaryjny tryb kompatybilności).
• channels.discord.execApprovals: natywne dla Discord dostarczanie zatwierdzeń exec i autoryzacja zatwierdzających.
  • enabled: true, false lub "auto" (domyślnie). W trybie automatycznym zatwierdzenia exec aktywują się, gdy zatwierdzający mogą zostać ustaleni z approvers lub commands.ownerAllowFrom.
  • approvers: identyfikatory użytkowników Discord uprawnionych do zatwierdzania żądań exec. Gdy pominięte, używa wartości zastępczej z commands.ownerAllowFrom.
  • agentFilter: opcjonalna lista dozwolonych identyfikatorów agentów. Pomiń, aby przekazywać zatwierdzenia dla wszystkich agentów.
  • sessionFilter: opcjonalne wzorce kluczy sesji (podciąg lub regex).
  • target: gdzie wysyłać monity o zatwierdzenie. "dm" (domyślnie) wysyła do DM zatwierdzających, "channel" wysyła do kanału źródłowego, "both" wysyła do obu. Gdy cel zawiera "channel", przyciski mogą być używane tylko przez ustalonych zatwierdzających.
  • cleanupAfterResolve: gdy true, usuwa DM z zatwierdzeniami po zatwierdzeniu, odmowie lub przekroczeniu czasu.

​

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",
      dm: {
        enabled: true,
        policy: "pairing",
        allowFrom: ["users/1234567890"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• JSON konta usługi: wbudowany (serviceAccount) lub oparty na pliku (serviceAccountFile).
• SecretRef konta usługi jest również obsługiwany (serviceAccountRef).
• Wartości zastępcze env: GOOGLE_CHAT_SERVICE_ACCOUNT lub GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Użyj spaces/<spaceId> lub users/<userId> jako celów dostarczania.
• channels.googlechat.dangerouslyAllowNameMatching ponownie włącza dopasowywanie zmiennego podmiotu e-mail (awaryjny tryb kompatybilności).

​

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: { allow: true, requireMention: true, allowBots: false },
        "#general": {
          allow: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Short answers only.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
      },
      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,
      chunkMode: "length",
      streaming: {
        mode: "partial", // off | partial | block | progress
        nativeTransport: true, // use Slack native streaming API when mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Tryb Socket wymaga zarówno botToken, jak i appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN jako domyślny awaryjny env konta).
• Tryb HTTP wymaga botToken oraz signingSecret (na poziomie głównym lub dla konta).
• socketMode przekazuje dostrajanie transportu Slack SDK Socket Mode do publicznego API odbiornika Bolt. Używaj go tylko podczas badania timeoutów ping/pong lub zachowania nieaktualnego websocketu. clientPingTimeout ma domyślną wartość 15000; serverPingTimeout i pingPongLoggingEnabled są przekazywane tylko wtedy, gdy są skonfigurowane.
• botToken, appToken, signingSecret i userToken akceptują zwykły tekst lub obiekty SecretRef.
• Migawki kont Slack ujawniają pola źródła/statusu dla poszczególnych danych uwierzytelniających, takie jak botTokenSource, botTokenStatus, appTokenStatus oraz, w trybie HTTP, signingSecretStatus. configured_unavailable oznacza, że konto jest skonfigurowane przez SecretRef, ale bieżąca ścieżka polecenia/runtime nie mogła rozwiązać wartości sekretu.
• configWrites: false blokuje zapisy konfiguracji inicjowane przez Slack.
• Opcjonalne channels.slack.defaultAccount zastępuje wybór domyślnego konta, gdy pasuje do skonfigurowanego identyfikatora konta.
• channels.slack.streaming.mode jest kanonicznym kluczem trybu strumienia Slack. channels.slack.streaming.nativeTransport kontroluje natywny transport strumieniowania Slack. Starsze wartości streamMode, logiczne streaming i nativeStreaming pozostają aliasami runtime; uruchom openclaw doctor --fix, aby przepisać utrwaloną konfigurację.
• unfurlLinks i unfurlMedia przekazują wartości logiczne rozwijania linków i mediów z chat.postMessage Slack dla odpowiedzi bota. unfurlLinks ma domyślną wartość false, aby wychodzące linki bota nie rozwijały się inline, chyba że zostanie to włączone; unfurlMedia jest pomijane, chyba że jest skonfigurowane. Ustaw dowolną z tych wartości w channels.slack.accounts.<accountId>, aby zastąpić wartość najwyższego poziomu dla jednego konta.
• Użyj user:<id> (DM) lub channel:<id> jako celów dostarczania.

• Natywne strumieniowanie Slack oraz status wątku w stylu asystenta Slack „pisze…” wymagają docelowego wątku odpowiedzi. DM-y najwyższego poziomu domyślnie pozostają poza wątkiem, więc nadal mogą strumieniować przez szkicowe podglądy publikowania i edycji Slack zamiast pokazywać podgląd natywnego strumienia/statusu w stylu wątku.
• typingReaction dodaje tymczasową reakcję do przychodzącej wiadomości Slack, gdy odpowiedź jest uruchomiona, a następnie usuwa ją po zakończeniu. Użyj krótkiego kodu emoji Slack, takiego jak "hourglass_flowing_sand".
• channels.slack.execApprovals: natywne dla Slack dostarczanie klienta zatwierdzeń i autoryzacja zatwierdzającego exec. Ten sam schemat co w Discord: enabled (true/false/"auto"), approvers (identyfikatory użytkowników Slack), agentFilter, sessionFilter i target ("dm", "channel" lub "both"). Zatwierdzenia Plugin mogą używać tej natywnej ścieżki klienta dla żądań pochodzących ze Slack, gdy zatwierdzający Plugin Slack zostaną rozwiązani; natywne dla Slack dostarczanie zatwierdzeń Plugin można także włączyć przez approvals.plugin dla sesji pochodzących ze Slack lub celów Slack. Zatwierdzenia Plugin używają zatwierdzających Plugin Slack z allowFrom i domyślnego routingu, a nie zatwierdzających exec.

​

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, // opt-in
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Optional explicit URL for reverse-proxy/public deployments
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      chunkMode: "length",
    },
  },
}

• commands.callbackPath musi być ścieżką (na przykład /api/channels/mattermost/command), a nie pełnym adresem URL.
• commands.callbackUrl musi wskazywać endpoint Gateway OpenClaw i być osiągalne z serwera Mattermost.
• Natywne wywołania zwrotne slash są uwierzytelniane tokenami dla poszczególnych poleceń zwracanymi przez Mattermost podczas rejestracji polecenia slash. Jeśli rejestracja się nie powiedzie lub żadne polecenia nie zostaną aktywowane, OpenClaw odrzuca wywołania zwrotne z komunikatem Unauthorized: invalid command token.
• Dla prywatnych/tailnet/internal hostów wywołań zwrotnych Mattermost może wymagać, aby ServiceSettings.AllowedUntrustedInternalConnections obejmowało host/domenę wywołania zwrotnego. Używaj wartości hosta/domeny, a nie pełnych adresów URL.
• channels.mattermost.configWrites: zezwól lub odmów zapisów konfiguracji inicjowanych przez Mattermost.
• channels.mattermost.requireMention: wymagaj @mention przed odpowiedzią w kanałach.
• channels.mattermost.groups.<channelId>.requireMention: nadpisanie bramkowania wzmianki dla kanału ("*" jako domyślne).
• Opcjonalne channels.mattermost.defaultAccount zastępuje wybór domyślnego konta, gdy pasuje do skonfigurowanego identyfikatora konta.

​

Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // optional account binding
      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: przypnij uruchamianie kanału do określonej tożsamości konta Signal.
• channels.signal.configWrites: zezwól lub odmów zapisów konfiguracji inicjowanych przez Signal.
• Opcjonalne channels.signal.defaultAccount zastępuje wybór domyślnego konta, gdy pasuje do skonfigurowanego identyfikatora konta.

​

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,
      },
    },
  },
}

• Opcjonalne channels.imessage.defaultAccount zastępuje wybór domyślnego konta, gdy pasuje do skonfigurowanego identyfikatora konta.
• Wymaga pełnego dostępu do dysku dla bazy danych Wiadomości.
• Preferuj cele chat_id:<id>. Użyj imsg chats --limit 20, aby wyświetlić czaty.
• cliPath może wskazywać wrapper SSH; ustaw remoteHost (host lub user@host) do pobierania załączników przez SCP.
• attachmentRoots i remoteAttachmentRoots ograniczają ścieżki załączników przychodzących (domyślnie: /Users/*/Library/Messages/Attachments).
• SCP używa ścisłego sprawdzania klucza hosta, więc upewnij się, że klucz hosta przekaźnika już istnieje w ~/.ssh/known_hosts.
• channels.imessage.configWrites: zezwól lub odmów zapisów konfiguracji inicjowanych przez iMessage.
• channels.imessage.sendTransport: preferowany transport wysyłki RPC imsg dla zwykłych odpowiedzi wychodzących. auto (domyślnie) używa mostka IMCore dla istniejących czatów, gdy jest uruchomiony, a następnie przełącza się na AppleScript; bridge wymaga dostarczania przez prywatne API; applescript wymusza publiczną ścieżkę automatyzacji Wiadomości.
• channels.imessage.actions.*: włącz akcje prywatnego API, które są również bramkowane przez imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments jest domyślnie wyłączone; ustaw je na true, zanim zaczniesz oczekiwać mediów przychodzących w turach agenta.
• Odzyskiwanie wiadomości przychodzących po restarcie mostka/gateway jest automatyczne (deduplikacja GUID plus ograniczenie wieku nieaktualnego backlogu). Istniejące konfiguracje channels.imessage.catchup.enabled: true są nadal honorowane jako przestarzały profil zgodności.
• channels.imessage.groups: rejestr grup i ustawienia dla grup. Przy groupPolicy: "allowlist" skonfiguruj jawne klucze chat_id albo wpis wieloznaczny "*", aby wiadomości grupowe mogły przejść przez bramkę rejestru.
• Wpisy najwyższego poziomu bindings[] z type: "acp" mogą wiązać konwersacje iMessage z trwałymi sesjami ACP. Użyj znormalizowanego uchwytu lub jawnego celu czatu (chat_id:*, chat_guid:*, chat_identifier:*) w match.peer.id. Wspólna semantyka pól: Agenci ACP.

#!/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",
        },
      },
    },
  },
}

• Uwierzytelnianie tokenem używa accessToken; uwierzytelnianie hasłem używa userId + password.
• channels.matrix.proxy kieruje ruch HTTP Matrix przez jawny proxy HTTP(S). Nazwane konta mogą go zastąpić za pomocą channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork zezwala na prywatne/wewnętrzne homeserwery. proxy i ta opcja sieciowa są niezależnymi mechanizmami kontroli.
• channels.matrix.defaultAccount wybiera preferowane konto w konfiguracjach wielokontowych.
• channels.matrix.autoJoin domyślnie ma wartość off, więc zaproszone pokoje i nowe zaproszenia w stylu DM są ignorowane, dopóki nie ustawisz autoJoin: "allowlist" z autoJoinAllowlist albo autoJoin: "always".
• channels.matrix.execApprovals: natywne dla Matrix dostarczanie zatwierdzeń exec i autoryzacja zatwierdzających.
  • enabled: true, false albo "auto" (domyślnie). W trybie auto zatwierdzenia exec aktywują się, gdy zatwierdzających można rozpoznać z approvers lub commands.ownerAllowFrom.
  • approvers: identyfikatory użytkowników Matrix (np. @owner:example.org) uprawnione do zatwierdzania żądań exec.
  • agentFilter: opcjonalna lista dozwolonych identyfikatorów agentów. Pomiń, aby przekazywać zatwierdzenia dla wszystkich agentów.
  • sessionFilter: opcjonalne wzorce kluczy sesji (podciąg lub regex).
  • target: miejsce wysyłania monitów o zatwierdzenie. "dm" (domyślnie), "channel" (pokój źródłowy) albo "both".
  • Zastąpienia dla konta: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope kontroluje, jak DM-y Matrix są grupowane w sesje: per-user (domyślnie) współdzieli według trasowanego rozmówcy, a per-room izoluje każdy pokój DM.
• Sondy statusu Matrix i wyszukiwania w katalogu na żywo używają tej samej polityki proxy co ruch w czasie działania.
• Pełna konfiguracja Matrix, reguły kierowania i przykłady konfiguracji są udokumentowane w Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, zasady zespołów/kanałów:
      // see /channels/msteams
    },
  },
}

• Główne ścieżki kluczy opisane tutaj: channels.msteams, channels.msteams.configWrites.
• Pełna konfiguracja Teams (poświadczenia, webhook, polityka DM/grup, zastąpienia dla zespołów/kanałów) jest udokumentowana w Microsoft Teams.

​

IRC

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

• Główne ścieżki kluczy opisane tutaj: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• Opcjonalne channels.irc.defaultAccount zastępuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• Pełna konfiguracja kanału IRC (host/port/TLS/kanały/listy dozwolonych/bramkowanie wzmianek) jest udokumentowana w IRC.

​

Wiele kont (wszystkie kanały)

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

• default jest używane, gdy accountId jest pominięte (CLI + routing).
• Tokeny env dotyczą tylko konta default.
• Podstawowe ustawienia kanału dotyczą wszystkich kont, chyba że zostaną zastąpione dla danego konta.
• Użyj bindings[].match.accountId, aby kierować każde konto do innego agenta.
• Jeśli dodasz konto inne niż domyślne przez openclaw channels add (albo onboarding kanału), mając nadal jednokontową konfigurację kanału najwyższego poziomu, OpenClaw najpierw promuje jednokontowe wartości najwyższego poziomu o zakresie konta do mapy kont kanału, aby pierwotne konto nadal działało. Większość kanałów przenosi je do channels.<channel>.accounts.default; Matrix może zamiast tego zachować istniejący pasujący nazwany/domyślny cel.
• Istniejące powiązania tylko kanału (bez accountId) nadal pasują do konta domyślnego; powiązania o zakresie konta pozostają opcjonalne.
• openclaw doctor --fix naprawia także mieszane kształty, przenosząc jednokontowe wartości najwyższego poziomu o zakresie konta do wypromowanego konta wybranego dla tego kanału. Większość kanałów używa accounts.default; Matrix może zamiast tego zachować istniejący pasujący nazwany/domyślny cel.

​

Inne kanały Plugin

​

Bramkowanie wzmianek na czacie grupowym

• Wzmianki w metadanych: natywne @wzmianki platformy. Ignorowane w trybie self-chat WhatsApp.
• Wzorce tekstowe: bezpieczne wzorce regex w agents.list[].groupChat.mentionPatterns. Nieprawidłowe wzorce i niebezpieczne zagnieżdżone powtórzenia są ignorowane.
• Bramkowanie wzmianek jest egzekwowane tylko wtedy, gdy wykrywanie jest możliwe (natywne wzmianki lub co najmniej jeden wzorzec).

{
  messages: {
    visibleReplies: "automatic", // wymuś stare automatyczne odpowiedzi końcowe dla czatów bezpośrednich/źródłowych
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // zawsze włączone niewspomniane pogawędki w pokoju stają się cichym kontekstem
      visibleReplies: "message_tool", // opt-in; wymagaj message(action=send) dla widocznych odpowiedzi w pokoju
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

Limity historii DM

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

​

Tryb self-chat

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

​

Polecenia (obsługa poleceń czatu)

{
  commands: {
    native: "auto", // rejestruj natywne polecenia, gdy są obsługiwane
    nativeSkills: "auto", // rejestruj natywne polecenia Skills, gdy są obsługiwane
    text: true, // analizuj /commands w wiadomościach czatu
    bash: false, // zezwól na ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // zezwól na /config
    mcp: false, // zezwól na /mcp
    plugins: false, // zezwól na /plugins
    debug: false, // zezwól na /debug
    restart: true, // zezwól na /restart + narzędzie restartu Gateway
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

Powiązane

• Dokumentacja konfiguracji — klucze najwyższego poziomu
• Konfiguracja — agenci
• Przegląd kanałów