Konfigurasi — saluran

​

Channel

​

Akses DM dan grup

​

Override model channel

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

​

Default channel dan heartbeat

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

• channels.defaults.groupPolicy: kebijakan grup fallback saat groupPolicy tingkat provider belum diatur.
• channels.defaults.contextVisibility: mode visibilitas konteks tambahan default untuk semua channel. Nilai: all (default, sertakan semua konteks kutipan/thread/riwayat), allowlist (hanya sertakan konteks dari pengirim yang ada di allowlist), allowlist_quote (sama seperti allowlist tetapi pertahankan konteks kutipan/balasan eksplisit). Override per channel: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: sertakan status channel yang sehat dalam keluaran heartbeat.
• channels.defaults.heartbeat.showAlerts: sertakan status terdegradasi/error dalam keluaran heartbeat.
• channels.defaults.heartbeat.useIndicator: render keluaran heartbeat bergaya indikator ringkas.

​

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

• Entri bindings[] tingkat atas dengan type: "acp" mengonfigurasi binding ACP persisten untuk DM dan grup WhatsApp. Gunakan nomor langsung E.164 atau JID grup WhatsApp di match.peer.id. Semantik field dibagikan di Agent 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 bot: channels.telegram.botToken atau channels.telegram.tokenFile (hanya file biasa; symlink ditolak), dengan TELEGRAM_BOT_TOKEN sebagai fallback untuk akun default.
• apiRoot hanya root Telegram Bot API. Gunakan https://api.telegram.org atau root self-hosted/proxy Anda, bukan https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix menghapus akhiran /bot<TOKEN> yang tidak sengaja tertinggal.
• Opsional channels.telegram.defaultAccount mengesampingkan pilihan akun default saat cocok dengan ID akun yang dikonfigurasi.
• Dalam penyiapan multi-akun (2+ ID akun), tetapkan default eksplisit (channels.telegram.defaultAccount atau channels.telegram.accounts.default) untuk menghindari routing fallback; openclaw doctor memperingatkan saat ini hilang atau tidak valid.
• configWrites: false memblokir penulisan konfigurasi yang dipicu Telegram (migrasi ID supergroup, /config set|unset).
• Entri bindings[] tingkat atas dengan type: "acp" mengonfigurasi binding ACP persisten untuk topik forum (gunakan chatId:topic:topicId kanonis di match.peer.id). Semantik field dibagikan di Agent ACP.
• Pratinjau stream Telegram menggunakan sendMessage + editMessageText (berfungsi dalam chat langsung dan grup).
• Kebijakan retry: lihat Kebijakan retry.

​

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, dengan DISCORD_BOT_TOKEN sebagai fallback untuk akun default.
• Panggilan keluar langsung yang menyediakan Discord token eksplisit menggunakan token tersebut untuk panggilan; pengaturan percobaan ulang/kebijakan akun tetap berasal dari akun yang dipilih dalam snapshot runtime aktif.
• channels.discord.defaultAccount opsional menimpa pemilihan akun default saat cocok dengan id akun yang dikonfigurasi.
• Gunakan user:<id> (DM) atau channel:<id> (kanal guild) untuk target pengiriman; ID numerik polos ditolak.
• Slug guild menggunakan huruf kecil dengan spasi diganti -; kunci kanal menggunakan nama yang sudah dijadikan slug (tanpa #). Utamakan ID guild.
• Pesan yang dibuat bot diabaikan secara default. allowBots: true mengaktifkannya; gunakan allowBots: "mentions" untuk hanya menerima pesan bot yang menyebut bot (pesan sendiri tetap difilter).
• Kanal yang mendukung pesan masuk yang dibuat bot dapat menggunakan perlindungan loop bot bersama. Atur channels.defaults.botLoopProtection untuk anggaran pasangan dasar, lalu timpa kanal atau akun hanya ketika satu permukaan memerlukan batas berbeda.
• channels.discord.guilds.<id>.ignoreOtherMentions (dan penimpaan kanal) membuang pesan yang menyebut pengguna atau peran lain tetapi bukan bot (mengecualikan @everyone/@here).
• channels.discord.mentionAliases memetakan teks @handle keluar yang stabil ke ID pengguna Discord sebelum mengirim, sehingga rekan tim yang dikenal dapat disebut secara deterministik bahkan saat cache direktori sementara kosong. Penimpaan per akun berada di bawah channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (default 17) membagi pesan tinggi meskipun kurang dari 2000 karakter.
• channels.discord.suppressEmbeds default ke true, sehingga URL keluar tidak diperluas menjadi pratinjau tautan Discord kecuali dinonaktifkan. Payload embeds eksplisit tetap dikirim secara normal; panggilan alat per pesan dapat menimpa dengan suppressEmbeds.
• channels.discord.threadBindings mengontrol perutean terikat thread Discord:
  • enabled: penimpaan Discord untuk fitur sesi terikat thread (/focus, /unfocus, /agents, /session idle, /session max-age, dan pengiriman/perutean terikat)
  • idleHours: penimpaan Discord untuk auto-unfocus ketidakaktifan dalam jam (0 menonaktifkan)
  • maxAgeHours: penimpaan Discord untuk usia maksimum keras dalam jam (0 menonaktifkan)
  • spawnSessions: sakelar untuk sessions_spawn({ thread: true }) dan pembuatan/pengikatan thread otomatis ACP thread-spawn (default: true)
  • defaultSpawnContext: konteks subagen native untuk spawn terikat thread ("fork" secara default)
• Entri bindings[] tingkat atas dengan type: "acp" mengonfigurasi binding ACP persisten untuk kanal dan thread (gunakan id kanal/thread di match.peer.id). Semantik bidang dibagikan di Agen ACP.
• channels.discord.ui.components.accentColor mengatur warna aksen untuk kontainer komponen Discord v2.
• channels.discord.agentComponents.ttlMs mengontrol berapa lama callback komponen Discord yang dikirim tetap terdaftar. Defaultnya adalah 1800000 (30 menit), maksimumnya 86400000 (24 jam), dan penimpaan per akun berada di bawah channels.discord.accounts.<accountId>.agentComponents.ttlMs. Nilai yang lebih panjang membuat tombol/select/form lama dapat digunakan lebih lama, jadi pilih TTL tersingkat yang sesuai dengan alur kerja.
• channels.discord.voice mengaktifkan percakapan kanal suara Discord dan penimpaan auto-join + LLM + TTS opsional. Konfigurasi Discord khusus teks membiarkan suara nonaktif secara default; atur channels.discord.voice.enabled=true untuk ikut serta.
• channels.discord.voice.model secara opsional menimpa model LLM yang digunakan untuk respons kanal suara Discord.
• channels.discord.voice.daveEncryption dan channels.discord.voice.decryptionFailureTolerance diteruskan ke opsi DAVE @discordjs/voice (true dan 24 secara default).
• channels.discord.voice.connectTimeoutMs mengontrol penantian Ready awal @discordjs/voice untuk /vc join dan percobaan auto-join (30000 secara default).
• channels.discord.voice.reconnectGraceMs mengontrol berapa lama sesi suara yang terputus boleh membutuhkan waktu untuk masuk ke pensinyalan reconnect sebelum OpenClaw menghancurkannya (15000 secara default).
• Pemutaran suara Discord tidak diinterupsi oleh peristiwa speaking-start pengguna lain. Untuk menghindari loop umpan balik, OpenClaw mengabaikan tangkapan suara baru saat TTS sedang diputar.
• OpenClaw juga mencoba pemulihan penerimaan suara dengan keluar/bergabung kembali ke sesi suara setelah kegagalan dekripsi berulang.
• channels.discord.streaming adalah kunci mode stream kanonis. Discord default ke streaming.mode: "progress" sehingga progres alat/kerja muncul dalam satu pesan pratinjau yang diedit; atur streaming.mode: "off" untuk menonaktifkannya. Nilai lama streamMode dan boolean streaming tetap menjadi alias runtime; jalankan openclaw doctor --fix untuk menulis ulang konfigurasi tersimpan.
• channels.discord.autoPresence memetakan ketersediaan runtime ke presence bot (healthy => online, degraded => idle, exhausted => dnd) dan mengizinkan penimpaan teks status opsional.
• channels.discord.dangerouslyAllowNameMatching mengaktifkan kembali pencocokan nama/tag yang dapat berubah (mode kompatibilitas darurat).
• channels.discord.execApprovals: pengiriman persetujuan exec native Discord dan otorisasi pemberi persetujuan.
  • enabled: true, false, atau "auto" (default). Dalam mode otomatis, persetujuan exec aktif saat pemberi persetujuan dapat diresolusikan dari approvers atau commands.ownerAllowFrom.
  • approvers: ID pengguna Discord yang diizinkan menyetujui permintaan exec. Fallback ke commands.ownerAllowFrom saat dihilangkan.
  • agentFilter: allowlist ID agen opsional. Hilangkan untuk meneruskan persetujuan bagi semua agen.
  • sessionFilter: pola kunci sesi opsional (substring atau regex).
  • target: tempat mengirim prompt persetujuan. "dm" (default) mengirim ke DM pemberi persetujuan, "channel" mengirim ke kanal asal, "both" mengirim ke keduanya. Saat target menyertakan "channel", tombol hanya dapat digunakan oleh pemberi persetujuan yang teresolusi.
  • cleanupAfterResolve: saat true, menghapus DM persetujuan setelah persetujuan, penolakan, atau timeout.

​

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 akun layanan: inline (serviceAccount) atau berbasis file (serviceAccountFile).
• SecretRef akun layanan juga didukung (serviceAccountRef).
• Fallback env: GOOGLE_CHAT_SERVICE_ACCOUNT atau GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Gunakan spaces/<spaceId> atau users/<userId> untuk target pengiriman.
• channels.googlechat.dangerouslyAllowNameMatching mengaktifkan kembali pencocokan principal email yang dapat berubah (mode kompatibilitas darurat).

​

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

• Mode Soket memerlukan botToken dan appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN untuk fallback env akun default).
• Mode HTTP memerlukan botToken plus signingSecret (di root atau per akun).
• socketMode meneruskan penyetelan transport Slack SDK Socket Mode ke API penerima Bolt publik. Gunakan hanya saat menyelidiki timeout ping/pong atau perilaku websocket usang. clientPingTimeout default ke 15000; serverPingTimeout dan pingPongLoggingEnabled hanya diteruskan saat dikonfigurasi.
• botToken, appToken, signingSecret, dan userToken menerima string plaintext atau objek SecretRef.
• Snapshot akun Slack mengekspos field sumber/status per kredensial seperti botTokenSource, botTokenStatus, appTokenStatus, dan, dalam mode HTTP, signingSecretStatus. configured_unavailable berarti akun dikonfigurasi melalui SecretRef tetapi jalur perintah/runtime saat ini tidak dapat menyelesaikan nilai rahasia.
• configWrites: false memblokir penulisan config yang dimulai Slack.
• channels.slack.defaultAccount opsional mengganti pemilihan akun default saat cocok dengan id akun yang dikonfigurasi.
• channels.slack.streaming.mode adalah kunci mode stream Slack kanonis. channels.slack.streaming.nativeTransport mengontrol transport streaming native Slack. Nilai legacy streamMode, boolean streaming, dan nativeStreaming tetap menjadi alias runtime; jalankan openclaw doctor --fix untuk menulis ulang config yang dipersistenkan.
• unfurlLinks dan unfurlMedia meneruskan boolean unfurl tautan dan media chat.postMessage Slack untuk balasan bot. unfurlLinks default ke false agar tautan bot outbound tidak melebar inline kecuali diaktifkan; unfurlMedia dihilangkan kecuali dikonfigurasi. Tetapkan salah satu nilai di channels.slack.accounts.<accountId> untuk mengganti nilai tingkat atas bagi satu akun.
• Gunakan user:<id> (DM) atau channel:<id> untuk target pengiriman.

• Streaming native Slack plus status thread “sedang mengetik…” bergaya asisten Slack memerlukan target thread balasan. DM tingkat atas tetap di luar thread secara default, sehingga masih dapat melakukan stream melalui pratinjau draft post-and-edit Slack alih-alih menampilkan pratinjau stream/status native bergaya thread.
• typingReaction menambahkan reaksi sementara ke pesan Slack inbound saat balasan sedang berjalan, lalu menghapusnya saat selesai. Gunakan shortcode emoji Slack seperti "hourglass_flowing_sand".
• channels.slack.execApprovals: pengiriman klien persetujuan native Slack dan otorisasi pemberi persetujuan exec. Skema yang sama seperti Discord: enabled (true/false/"auto"), approvers (ID pengguna Slack), agentFilter, sessionFilter, dan target ("dm", "channel", atau "both"). Persetujuan Plugin dapat menggunakan jalur native-client ini untuk permintaan asal Slack saat pemberi persetujuan Plugin Slack berhasil diselesaikan; pengiriman persetujuan Plugin native Slack juga dapat diaktifkan melalui approvals.plugin untuk sesi asal Slack atau target Slack. Persetujuan Plugin menggunakan pemberi persetujuan Plugin Slack dari allowFrom dan routing default, bukan pemberi persetujuan 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 harus berupa path (misalnya /api/channels/mattermost/command), bukan URL lengkap.
• commands.callbackUrl harus mengarah ke endpoint gateway OpenClaw dan dapat dijangkau dari server Mattermost.
• Callback slash native diautentikasi dengan token per perintah yang dikembalikan oleh Mattermost selama pendaftaran perintah slash. Jika pendaftaran gagal atau tidak ada perintah yang diaktifkan, OpenClaw menolak callback dengan Unauthorized: invalid command token.
• Untuk host callback privat/tailnet/internal, Mattermost mungkin memerlukan ServiceSettings.AllowedUntrustedInternalConnections agar menyertakan host/domain callback. Gunakan nilai host/domain, bukan URL lengkap.
• channels.mattermost.configWrites: izinkan atau tolak penulisan config yang dimulai Mattermost.
• channels.mattermost.requireMention: wajibkan @mention sebelum membalas di channel.
• channels.mattermost.groups.<channelId>.requireMention: override gating mention per channel ("*" untuk default).
• channels.mattermost.defaultAccount opsional mengganti pemilihan akun default saat cocok dengan id akun yang dikonfigurasi.

​

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: sematkan startup channel ke identitas akun Signal tertentu.
• channels.signal.configWrites: izinkan atau tolak penulisan config yang dimulai Signal.
• channels.signal.defaultAccount opsional mengganti pemilihan akun default saat cocok dengan id akun yang dikonfigurasi.

​

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

• channels.imessage.defaultAccount opsional mengganti pemilihan akun default saat cocok dengan id akun yang dikonfigurasi.
• Memerlukan Full Disk Access ke DB Messages.
• Utamakan target chat_id:<id>. Gunakan imsg chats --limit 20 untuk menampilkan daftar chat.
• cliPath dapat mengarah ke wrapper SSH; tetapkan remoteHost (host atau user@host) untuk mengambil attachment melalui SCP.
• attachmentRoots dan remoteAttachmentRoots membatasi path attachment inbound (default: /Users/*/Library/Messages/Attachments).
• SCP menggunakan pemeriksaan host-key ketat, jadi pastikan kunci host relay sudah ada di ~/.ssh/known_hosts.
• channels.imessage.configWrites: izinkan atau tolak penulisan config yang dimulai iMessage.
• channels.imessage.sendTransport: transport pengiriman RPC imsg pilihan untuk balasan outbound normal. auto (default) menggunakan bridge IMCore untuk chat yang ada saat sedang berjalan, lalu fallback ke AppleScript; bridge memerlukan pengiriman private-API; applescript memaksa jalur automation Messages publik.
• channels.imessage.actions.*: aktifkan tindakan API privat yang juga digating oleh imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments mati secara default; tetapkan ke true sebelum mengharapkan media inbound dalam giliran agen.
• Pemulihan inbound setelah restart bridge/gateway bersifat otomatis (dedupe GUID plus pagar usia backlog usang). Config channels.imessage.catchup.enabled: true yang ada masih dihormati sebagai profil kompatibilitas yang deprecated.
• channels.imessage.groups: registry grup dan pengaturan per grup. Dengan groupPolicy: "allowlist", konfigurasikan kunci chat_id eksplisit atau entri wildcard "*" agar pesan grup dapat melewati gate registry.
• Entri bindings[] tingkat atas dengan type: "acp" dapat mengikat percakapan iMessage ke sesi ACP persisten. Gunakan handle yang dinormalisasi atau target chat eksplisit (chat_id:*, chat_guid:*, chat_identifier:*) di match.peer.id. Semantik field bersama: Agen 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",
        },
      },
    },
  },
}

• Auth token menggunakan accessToken; auth kata sandi menggunakan userId + password.
• channels.matrix.proxy merutekan lalu lintas HTTP Matrix melalui proxy HTTP(S) eksplisit. Akun bernama dapat menimpanya dengan channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork mengizinkan homeserver privat/internal. proxy dan opt-in jaringan ini adalah kontrol yang independen.
• channels.matrix.defaultAccount memilih akun pilihan dalam penyiapan multi-akun.
• channels.matrix.autoJoin default-nya off, sehingga room undangan dan undangan baru bergaya DM diabaikan sampai Anda menetapkan autoJoin: "allowlist" dengan autoJoinAllowlist atau autoJoin: "always".
• channels.matrix.execApprovals: pengiriman persetujuan eksekusi native Matrix dan otorisasi pemberi persetujuan.
  • enabled: true, false, atau "auto" (default). Dalam mode otomatis, persetujuan eksekusi aktif saat pemberi persetujuan dapat diselesaikan dari approvers atau commands.ownerAllowFrom.
  • approvers: ID pengguna Matrix (mis. @owner:example.org) yang diizinkan menyetujui permintaan eksekusi.
  • agentFilter: allowlist ID agent opsional. Hilangkan untuk meneruskan persetujuan bagi semua agent.
  • sessionFilter: pola kunci sesi opsional (substring atau regex).
  • target: tempat mengirim prompt persetujuan. "dm" (default), "channel" (room asal), atau "both".
  • Penimpaan per akun: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope mengontrol bagaimana DM Matrix dikelompokkan ke dalam sesi: per-user (default) berbagi berdasarkan peer yang dirutekan, sedangkan per-room mengisolasi setiap room DM.
• Probe status Matrix dan lookup direktori live menggunakan kebijakan proxy yang sama dengan lalu lintas runtime.
• Konfigurasi Matrix lengkap, aturan penargetan, dan contoh penyiapan didokumentasikan di Matrix.

​

Microsoft Teams

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

• Jalur kunci inti yang dibahas di sini: channels.msteams, channels.msteams.configWrites.
• Konfigurasi Teams lengkap (kredensial, Webhook, kebijakan DM/grup, penimpaan per tim/per channel) didokumentasikan di 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",
      },
    },
  },
}

• Jalur kunci inti yang dibahas di sini: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• channels.irc.defaultAccount opsional menimpa pemilihan akun default saat cocok dengan id akun yang dikonfigurasi.
• Konfigurasi channel IRC lengkap (host/port/TLS/channel/allowlist/gating mention) didokumentasikan di IRC.

​

Multi-akun (semua channel)

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

• default digunakan saat accountId dihilangkan (CLI + perutean).
• Token env hanya berlaku untuk akun default.
• Pengaturan channel dasar berlaku untuk semua akun kecuali ditimpa per akun.
• Gunakan bindings[].match.accountId untuk merutekan setiap akun ke agent yang berbeda.
• Jika Anda menambahkan akun non-default melalui openclaw channels add (atau onboarding channel) saat masih menggunakan konfigurasi channel tingkat atas akun tunggal, OpenClaw terlebih dahulu mempromosikan nilai akun tunggal tingkat atas yang berskala akun ke dalam peta akun channel agar akun asli tetap berfungsi. Sebagian besar channel memindahkannya ke channels.<channel>.accounts.default; Matrix dapat mempertahankan target bernama/default yang cocok yang sudah ada sebagai gantinya.
• Binding khusus channel yang sudah ada (tanpa accountId) tetap cocok dengan akun default; binding berskala akun tetap opsional.
• openclaw doctor --fix juga memperbaiki bentuk campuran dengan memindahkan nilai akun tunggal tingkat atas yang berskala akun ke akun yang dipromosikan yang dipilih untuk channel tersebut. Sebagian besar channel menggunakan accounts.default; Matrix dapat mempertahankan target bernama/default yang cocok yang sudah ada sebagai gantinya.

​

Channel Plugin lainnya

​

Gating mention chat grup

• Mention metadata: @-mention platform native. Diabaikan dalam mode self-chat WhatsApp.
• Pola teks: Pola regex aman di agents.list[].groupChat.mentionPatterns. Pola tidak valid dan repetisi bertingkat yang tidak aman diabaikan.
• Gating mention hanya ditegakkan saat deteksi memungkinkan (mention native atau setidaknya satu pola).

{
  messages: {
    visibleReplies: "automatic", // force old automatic final replies for direct/source chats
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // always-on unmentioned room chatter becomes quiet context
      visibleReplies: "message_tool", // opt-in; require message(action=send) for visible room replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

Batas riwayat DM

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

​

Mode self-chat

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

​

Perintah (penanganan perintah chat)

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

​

Terkait

• Referensi konfigurasi — kunci tingkat atas
• Konfigurasi — agen
• Ringkasan channel