Konfiguracja — kanały

​

Kanały

​

Dostęp DM i grupowy

​

Nadpisania modeli kanałów

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

​

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: awaryjna polityka grupowa, gdy groupPolicy na poziomie providera 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 allowlisty), allowlist_quote (to samo co allowlist, ale zachowuje jawny kontekst cytatu/odpowiedzi). Nadpisanie per channel: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: uwzględnia zdrowe statusy kanałów w danych wyjściowych Heartbeat.
• channels.defaults.heartbeat.showAlerts: uwzględnia statusy pogorszone/błędów w danych wyjściowych Heartbeat.
• channels.defaults.heartbeat.useIndicator: renderuje kompaktowe dane wyjściowe Heartbeat w stylu wskaźnika.

​

WhatsApp

{
  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"],
    },
  },
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
}

{
  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: off; opt in explicitly to avoid preview-edit rate limits)
      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",
      },
      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; symlinki są odrzucane), z TELEGRAM_BOT_TOKEN jako wartością awaryjną dla konta domyślnego.
• Opcjonalne channels.telegram.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• W konfiguracjach wielokontowych (2+ identyfikatory kont) ustaw jawne domyślne konto (channels.telegram.defaultAccount lub channels.telegram.accounts.default), aby uniknąć routingu awaryjnego; openclaw doctor ostrzega, gdy tego brakuje lub 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ółdzielona w ACP Agents.
• Podglądy strumienia Telegram używają sendMessage + editMessageText (działa w czatach bezpośrednich i grupowych).
• Polityka ponawiania: zobacz Polityka 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,
      chunkMode: "length", // length | newline
      streaming: "off", // off | partial | block | progress (progress maps to partial on Discord)
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSubagentSessions: false, // opt-in for sessions_spawn({ thread: true })
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        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ą awaryjną dla konta domyślnego.
• Bezpośrednie wywołania wychodzące, które podają jawny Discord token, używają tego tokenu dla wywołania; ustawienia ponawiania/polityki konta nadal pochodzą z wybranego konta w aktywnej migawce środowiska uruchomieniowego.
• Opcjonalne channels.discord.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• Używaj user:<id> (DM) lub channel:<id> (kanał guild) jako celów dostarczania; surowe numeryczne identyfikatory są odrzucane.
• Slugi guild są pisane małymi literami, a spacje są zastępowane przez -; klucze kanałów używają nazwy w postaci sluga (bez #). Preferuj identyfikatory guild.
• Wiadomości autorstwa botów 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).
• 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).
• maxLinesPerMessage (domyślnie 17) dzieli wysokie wiadomości nawet wtedy, gdy mają mniej niż 2000 znaków.
• channels.discord.threadBindings steruje routingiem związanym z wątkami Discord:
  • enabled: nadpisanie Discord dla funkcji sesji związanych z wątkiem (/focus, /unfocus, /agents, /session idle, /session max-age oraz powiązanego dostarczania/routingu)
  • idleHours: nadpisanie Discord dla automatycznego odfokusowania po bezczynności w godzinach (0 wyłącza)
  • maxAgeHours: nadpisanie Discord dla twardego maksymalnego wieku w godzinach (0 wyłącza)
  • spawnSubagentSessions: przełącznik opt-in dla automatycznego tworzenia/powiązywania wątków przez sessions_spawn({ thread: true })
• 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ółdzielona w ACP Agents.
• channels.discord.ui.components.accentColor ustawia kolor akcentu dla kontenerów komponentów Discord v2.
• channels.discord.voice włącza konwersacje w kanałach głosowych Discord oraz opcjonalne auto-join + nadpisania TTS.
• channels.discord.voice.daveEncryption i channels.discord.voice.decryptionFailureTolerance są przekazywane do opcji DAVE @discordjs/voice (domyślnie true i 24).
• OpenClaw dodatkowo próbuje odzyskiwać odbiór głosu, opuszczając i ponownie dołączając do sesji głosowej po powtarzających się błędach deszyfrowania.
• channels.discord.streaming to kanoniczny klucz trybu strumieniowania. Starsze wartości streamMode i logiczne streaming są migrowane automatycznie.
• channels.discord.autoPresence mapuje dostępność środowiska uruchomieniowego na status obecności bota (healthy => online, degraded => idle, exhausted => dnd) i pozwala na opcjonalne nadpisania tekstu statusu.
• channels.discord.dangerouslyAllowNameMatching ponownie włącza dopasowywanie po zmiennych nazwach/tagach (awaryjny tryb zgodności).
• channels.discord.execApprovals: natywne dla Discord dostarczanie zatwierdzeń exec i autoryzacja zatwierdzających.
  • enabled: true, false lub "auto" (domyślnie). W trybie auto zatwierdzenia exec aktywują się, gdy zatwierdzający mogą zostać rozwiązani z approvers lub commands.ownerAllowFrom.
  • approvers: identyfikatory użytkowników Discord uprawnionych do zatwierdzania żądań exec. Gdy pominięte, używane jest commands.ownerAllowFrom.
  • agentFilter: opcjonalna allowlista identyfikatorów agentów. Pomiń, aby przekazywać zatwierdzenia dla wszystkich agentów.
  • sessionFilter: opcjonalne wzorce kluczy sesji (substring lub regex).
  • target: miejsce wysyłania promptów zatwierdzeń. "dm" (domyślnie) wysyła do DM zatwierdzających, "channel" wysyła do kanału źródłowego, "both" wysyła do obu. Gdy target zawiera "channel", przyciski mogą być używane tylko przez rozwiązanych zatwierdzających.
  • cleanupAfterResolve: gdy true, usuwa DM z zatwierdzeniami po zatwierdzeniu, odrzuceniu lub przekroczeniu limitu 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: inline (serviceAccount) lub z pliku (serviceAccountFile).
• SecretRef konta usługi jest również obsługiwany (serviceAccountRef).
• Awaryjne wartości env: GOOGLE_CHAT_SERVICE_ACCOUNT lub GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Używaj spaces/<spaceId> lub users/<userId> jako celów dostarczania.
• channels.googlechat.dangerouslyAllowNameMatching ponownie włącza dopasowywanie po zmiennym principalu e-mail (awaryjny tryb zgodności).

​

Slack

{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      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",
      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 awaryjne wartości env dla konta domyślnego).
• Tryb HTTP wymaga botToken plus signingSecret (na poziomie głównym lub per account).
• botToken, appToken, signingSecret i userToken akceptują jawne ciągi znaków lub obiekty SecretRef.
• Migawki kont Slack udostępniają pola źródła/statusu per credential, takie jak botTokenSource, botTokenStatus, appTokenStatus, a w trybie HTTP także signingSecretStatus. configured_unavailable oznacza, że konto jest skonfigurowane przez SecretRef, ale bieżąca ścieżka polecenia/środowiska uruchomieniowego nie mogła rozwiązać wartości sekretu.
• configWrites: false blokuje zapisy konfiguracji inicjowane przez Slack.
• Opcjonalne channels.slack.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• channels.slack.streaming.mode to kanoniczny klucz trybu strumieniowania Slack. channels.slack.streaming.nativeTransport steruje natywnym transportem strumieniowania Slack. Starsze wartości streamMode, logiczne streaming i nativeStreaming są migrowane automatycznie.
• Używaj user:<id> (DM) lub channel:<id> jako celów dostarczania.

• Natywne strumieniowanie Slack plus status wątku w stylu asystenta Slack „is typing…” wymagają celu odpowiedzi w wątku. DM najwyższego poziomu domyślnie pozostają poza wątkiem, więc używają typingReaction lub zwykłego dostarczania zamiast podglądu 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 shortcode emoji Slack, np. "hourglass_flowing_sand".
• channels.slack.execApprovals: natywne dla Slack dostarczanie zatwierdzeń exec i autoryzacja zatwierdzających. Ten sam schemat co w Discord: enabled (true/false/"auto"), approvers (identyfikatory użytkowników Slack), agentFilter, sessionFilter oraz target ("dm", "channel" lub "both").

​

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 URL-em.
• commands.callbackUrl musi wskazywać punkt końcowy Gateway OpenClaw i być osiągalny z serwera Mattermost.
• Natywne callbacki slash są uwierzytelniane za pomocą tokenów per command zwracanych przez Mattermost podczas rejestracji poleceń slash. Jeśli rejestracja się nie powiedzie lub żadne polecenia nie zostaną aktywowane, OpenClaw odrzuca callbacki komunikatem Unauthorized: invalid command token.
• Dla prywatnych/tailnet/wewnętrznych hostów callback Mattermost może wymagać, aby ServiceSettings.AllowedUntrustedInternalConnections zawierało host/domenę callbacku. Używaj wartości host/domena, a nie pełnych URL-i.
• channels.mattermost.configWrites: zezwalaj lub odmawiaj zapisów konfiguracji inicjowanych przez Mattermost.
• channels.mattermost.requireMention: wymaga @mention przed odpowiedzią w kanałach.
• channels.mattermost.groups.<channelId>.requireMention: nadpisanie wymagania wzmianki per channel ("*" jako wartość domyślna).
• Opcjonalne channels.mattermost.defaultAccount nadpisuje wybór konta domyślnego, 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: przypina uruchamianie kanału do konkretnej tożsamości konta Signal.
• channels.signal.configWrites: zezwala lub odmawia zapisów konfiguracji inicjowanych przez Signal.
• Opcjonalne channels.signal.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.

​

BlueBubbles

{
  channels: {
    bluebubbles: {
      enabled: true,
      dmPolicy: "pairing",
      // serverUrl, password, webhookPath, group controls, and advanced actions:
      // see /channels/bluebubbles
    },
  },
}

• Główne ścieżki kluczy omówione tutaj: channels.bluebubbles, channels.bluebubbles.dmPolicy.
• Opcjonalne channels.bluebubbles.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• Wpisy najwyższego poziomu bindings[] z type: "acp" mogą wiązać konwersacje BlueBubbles z trwałymi sesjami ACP. Użyj uchwytu BlueBubbles lub docelowego ciągu (chat_id:*, chat_guid:*, chat_identifier:*) w match.peer.id. Współdzielona semantyka pól: ACP Agents.
• Pełna konfiguracja kanału BlueBubbles jest opisana w BlueBubbles.

​

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",
      region: "US",
    },
  },
}

• Opcjonalne channels.imessage.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• Wymaga Full Disk Access do bazy danych Messages.
• Preferuj cele chat_id:<id>. Użyj imsg chats --limit 20, aby wyświetlić listę czatów.
• cliPath może wskazywać na wrapper SSH; ustaw remoteHost (host lub user@host) do pobierania załączników przez SCP.
• attachmentRoots i remoteAttachmentRoots ograniczają ścieżki przychodzących załączników (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: zezwalaj lub odmawiaj zapisów konfiguracji inicjowanych przez iMessage.
• 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ółdzielona semantyka pól: ACP Agents.

#!/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ą to nadpisać przez channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork zezwala na prywatne/wewnętrzne homeserver. proxy i to sieciowe ustawienie opt-in to niezależne mechanizmy.
• 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 lub "auto" (domyślnie). W trybie auto zatwierdzenia exec aktywują się, gdy zatwierdzający mogą zostać rozwiązani z approvers lub commands.ownerAllowFrom.
  • approvers: identyfikatory użytkowników Matrix (np. @owner:example.org) uprawnionych do zatwierdzania żądań exec.
  • agentFilter: opcjonalna allowlista identyfikatorów agentów. Pomiń, aby przekazywać zatwierdzenia dla wszystkich agentów.
  • sessionFilter: opcjonalne wzorce kluczy sesji (substring lub regex).
  • target: miejsce wysyłania promptów zatwierdzeń. "dm" (domyślnie), "channel" (pokój źródłowy) lub "both".
  • Nadpisania per account: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope steruje tym, jak DM Matrix są grupowane w sesje: per-user (domyślnie) współdzieli według routowanego peera, natomiast per-room izoluje każdy pokój DM.
• Testy statusu Matrix i wyszukiwania katalogu na żywo używają tej samej polityki proxy co ruch środowiska uruchomieniowego.
• Pełna konfiguracja Matrix, reguły kierowania i przykłady konfiguracji są opisane w Matrix.

​

Microsoft Teams

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

• Główne ścieżki kluczy omówione tutaj: channels.msteams, channels.msteams.configWrites.
• Pełna konfiguracja Teams (poświadczenia, Webhook, polityka DM/grupowa, nadpisania per team/per channel) jest opisana 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 omówione tutaj: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• Opcjonalne channels.irc.defaultAccount nadpisuje wybór konta domyślnego, gdy pasuje do skonfigurowanego identyfikatora konta.
• Pełna konfiguracja kanału IRC (host/port/TLS/channels/allowlisty/wymaganie wzmianki) jest opisana 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.
• Bazowe ustawienia kanału mają zastosowanie do wszystkich kont, chyba że zostaną nadpisane per account.
• 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 (lub onboarding kanału), będąc nadal przy jednokontowej konfiguracji kanału na poziomie głównym, OpenClaw najpierw promuje wartości jednokontowe z najwyższego poziomu o zakresie konta do mapy kont kanału, aby oryginalne 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/docelowy domyślny wpis.
• Istniejące powiązania tylko kanałowe (bez accountId) nadal dopasowują konto domyślne; powiązania o zakresie konta pozostają opcjonalne.
• openclaw doctor --fix także naprawia mieszane kształty, przenosząc wartości jednokontowe z najwyższego poziomu o zakresie konta do promowanego 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/docelowy domyślny wpis.

​

Inne kanały Plugin

​

Wymaganie wzmianki w czatach grupowych

• 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.
• Wymaganie wzmianki jest egzekwowane tylko wtedy, gdy wykrycie jest możliwe (natywne wzmianki lub co najmniej jeden wzorzec).

{
  messages: {
    groupChat: { historyLimit: 50 },
  },
  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", // register native commands when supported
    nativeSkills: "auto", // register native skill commands when supported
    text: true, // parse /commands in chat messages
    bash: false, // allow ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // allow /config
    mcp: false, // allow /mcp
    plugins: false, // allow /plugins
    debug: false, // allow /debug
    restart: true, // allow /restart + gateway restart tool
    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