Slack

Siap produksi untuk DM dan channel melalui integrasi aplikasi Slack. Mode default adalah Socket Mode; HTTP Request URLs juga didukung. Mode relay ditujukan untuk deployment terkelola ketika router tepercaya memiliki ingress Slack.

Memilih Socket Mode atau HTTP Request URLs

Kedua transport siap produksi dan mencapai paritas fitur untuk perpesanan, slash commands, App Home, dan interaktivitas. Pilih berdasarkan bentuk deployment, bukan fitur.

Mode relay

Mode relay memisahkan ingress Slack dari gateway OpenClaw. Router tepercaya memiliki satu koneksi Slack Socket Mode, memilih gateway tujuan, dan meneruskan event bertipe melalui websocket terautentikasi. Gateway tetap menggunakan bot token-nya untuk panggilan Slack Web API outbound.

{  channels: {    slack: {      mode: "relay",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      relay: {        url: "wss://router.example.com/gateway/ws",        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },        gatewayId: "team-gateway",      },    },  },}

URL relay harus menggunakan wss:// kecuali menargetkan localhost. Perlakukan bearer token dan tabel rute router sebagai bagian dari batas otorisasi Slack: event yang dirutekan masuk ke handler pesan Slack normal sebagai aktivasi terotorisasi. slack_identity yang disediakan router dalam frame hello websocket dapat menetapkan username dan ikon outbound default; identitas eksplisit yang diberikan pemanggil tetap menang. Koneksi relay melakukan reconnect dengan timing backoff terbatas yang sama seperti Socket Mode dan menghapus identitas yang disediakan router setiap kali terputus.

Instal

Instal Slack sebelum mengonfigurasi channel:

openclaw plugins install @openclaw/slack

plugins install mendaftarkan dan mengaktifkan plugin. Plugin tetap tidak melakukan apa pun sampai Anda mengonfigurasi aplikasi Slack dan pengaturan channel di bawah. Lihat Plugins untuk perilaku plugin umum dan aturan instalasi.

Setup cepat

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","should_escape": false}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","emoji:read","files:read","files:write","groups:history","groups:read","im:history","im:read","im:write","mpim:history","mpim:read","mpim:write","pins:read","pins:write","reactions:read","reactions:write","usergroups:read","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]}}}

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","should_escape": false}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > slack.socket.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "socket",appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=slack-app-token-exampleSLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","emoji:read","files:read","files:write","groups:history","groups:read","im:history","im:read","im:write","mpim:history","mpim:read","mpim:write","pins:read","pins:write","reactions:read","reactions:write","usergroups:read","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","message.channels","message.groups","message.im"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

export SLACK_BOT_TOKEN=slack-bot-token-exampleexport SLACK_SIGNING_SECRET=...cat > slack.http.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "http",botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },webhookPath: "/slack/events",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Penyesuaian transport Mode Socket

OpenClaw menetapkan timeout pong klien Slack SDK ke 15 detik secara default untuk Mode Socket. Timpa pengaturan transport hanya ketika Anda membutuhkan penyesuaian khusus workspace atau host:

{  channels: {    slack: {      mode: "socket",      socketMode: {        clientPingTimeout: 20000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },    },  },}

Gunakan ini hanya untuk workspace Mode Socket yang mencatat timeout pong websocket Slack/ping server atau berjalan di host dengan kelaparan event loop yang diketahui. clientPingTimeout adalah waktu tunggu pong setelah SDK mengirim ping klien; serverPingTimeout adalah waktu tunggu untuk ping server Slack. Pesan dan event aplikasi tetap menjadi status aplikasi, bukan sinyal keaktifan transport.

Catatan:

• socketMode diabaikan dalam mode URL Permintaan HTTP.
• Pengaturan dasar channels.slack.socketMode berlaku untuk semua akun Slack kecuali ditimpa. Penimpaan per akun menggunakan channels.slack.accounts.<accountId>.socketMode; karena ini adalah penimpaan objek, sertakan setiap kolom penyesuaian socket yang Anda inginkan untuk akun tersebut.
• Hanya clientPingTimeout yang memiliki default OpenClaw (15000). serverPingTimeout dan pingPongLoggingEnabled diteruskan ke Slack SDK hanya ketika dikonfigurasi.
• Backoff restart Mode Socket dimulai sekitar 2 detik dan dibatasi sekitar 30 detik. Kegagalan start, start-wait, dan disconnect yang dapat dipulihkan akan dicoba ulang hingga channel berhenti. Error akun dan kredensial permanen seperti autentikasi tidak valid, token dicabut, atau cakupan hilang akan gagal cepat alih-alih mencoba ulang selamanya.

Daftar periksa manifes dan cakupan

Manifes aplikasi Slack dasar sama untuk Mode Socket dan URL Permintaan HTTP. Hanya blok settings (dan url perintah slash) yang berbeda.

Manifes dasar (default Mode Socket):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack connector for OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true },    "app_home": {      "home_tab_enabled": true,      "messages_tab_enabled": true,      "messages_tab_read_only_enabled": false    },    "assistant_view": {      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",      "suggested_prompts": [        { "title": "What can you do?", "message": "What can you help me with?" },        {          "title": "Summarize this channel",          "message": "Summarize the recent activity in this channel."        },        { "title": "Draft a reply", "message": "Help me draft a reply." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "Send a message to OpenClaw",        "should_escape": false      }    ]  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "assistant:write",        "channels:history",        "channels:read",        "chat:write",        "commands",        "emoji:read",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "im:write",        "mpim:history",        "mpim:read",        "mpim:write",        "pins:read",        "pins:write",        "reactions:read",        "reactions:write",        "usergroups:read",        "users:read"      ]    }  },  "settings": {    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_home_opened",        "app_mention",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

Untuk mode URL Permintaan HTTP, ganti settings dengan varian HTTP dan tambahkan url ke setiap perintah slash. URL publik wajib:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Send a message to OpenClaw",        "should_escape": false,        "url": "https://gateway-host.example.com/slack/events"      }    ]  },  "settings": {    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_home_opened",        "app_mention",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    },    "interactivity": {      "is_enabled": true,      "request_url": "https://gateway-host.example.com/slack/events",      "message_menu_options_url": "https://gateway-host.example.com/slack/events"    }  }}

Pengaturan manifes tambahan

Tampilkan berbagai fitur yang memperluas default di atas.

Manifes default mengaktifkan tab Beranda Slack App Home dan berlangganan ke app_home_opened. Saat anggota workspace membuka tab Beranda, OpenClaw menerbitkan tampilan Beranda default yang aman dengan views.publish; tidak ada payload percakapan atau konfigurasi privat yang disertakan. Tab Pesan tetap diaktifkan untuk DM Slack. Manifes juga mengaktifkan utas asisten Slack dengan features.assistant_view, assistant:write, assistant_thread_started, dan assistant_thread_context_changed; utas asisten dirutekan ke sesi utas OpenClaw tersendiri dan menjaga konteks utas yang disediakan Slack tetap tersedia bagi agen.

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]"},{"command": "/reset","description": "Reset the current session"},{"command": "/compact","description": "Compact the session context","usage_hint": "[instructions]"},{"command": "/stop","description": "Stop the current run"},{"command": "/session","description": "Manage thread-binding expiry","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "Set the thinking level","usage_hint": "<level>"},{"command": "/verbose","description": "Toggle verbose output","usage_hint": "on|off|full"},{"command": "/fast","description": "Show or set fast mode","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Toggle reasoning visibility","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Toggle elevated mode","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Show or set exec defaults","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Approve or deny pending approval requests","usage_hint": "<id> <decision>"},{"command": "/model","description": "Show or set the model","usage_hint": "[name|#|status]"},{"command": "/models","description": "List providers/models","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Show the short help summary"},{"command": "/commands","description": "Show the generated command catalog"},{"command": "/tools","description": "Show what the current agent can use right now","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Show runtime status, including provider usage/quota when available"},{"command": "/tasks","description": "List active/recent background tasks for the current session"},{"command": "/context","description": "Explain how context is assembled","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Show your sender identity"},{"command": "/skill","description": "Run a skill by name","usage_hint": "<name> [input]"},{"command": "/btw","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/side","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/usage","description": "Control the usage footer or show cost summary","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Show the short help summary","url": "https://gateway-host.example.com/slack/events"}]}

Model token

• botToken + appToken wajib untuk Socket Mode.
• Mode HTTP memerlukan botToken + signingSecret.
• Mode relay memerlukan botToken serta relay.url, relay.authToken, dan relay.gatewayId; mode ini tidak menggunakan token aplikasi atau signing secret.
• botToken, appToken, signingSecret, relay.authToken, dan userToken menerima string teks biasa atau objek SecretRef.
• Token konfigurasi menimpa fallback env.
• Fallback env SLACK_BOT_TOKEN / SLACK_APP_TOKEN hanya berlaku untuk akun default.
• userToken hanya melalui konfigurasi (tanpa fallback env) dan default ke perilaku hanya-baca (userTokenReadOnly: true).

Perilaku snapshot status:

• Inspeksi akun Slack melacak kolom *Source dan *Status per kredensial (botToken, appToken, signingSecret, userToken).
• Status adalah available, configured_unavailable, atau missing.
• configured_unavailable berarti akun dikonfigurasi melalui SecretRef atau sumber rahasia non-inline lainnya, tetapi jalur perintah/runtime saat ini tidak dapat menyelesaikan nilai aktualnya.
• Dalam mode HTTP, signingSecretStatus disertakan; dalam Socket Mode, pasangan wajibnya adalah botTokenStatus + appTokenStatus.

Aksi dan gate

Aksi Slack dikendalikan oleh channels.slack.actions.*.

Grup aksi yang tersedia dalam tooling Slack saat ini:

Aksi pesan Slack saat ini mencakup send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info, dan emoji-list. download-file menerima ID file Slack yang ditampilkan dalam placeholder file masuk dan mengembalikan pratinjau gambar untuk gambar atau metadata file lokal untuk jenis file lainnya.

Kontrol akses dan perutean

Thread, sesi, dan tag balasan

• DM dirutekan sebagai direct; channel sebagai channel; MPIM sebagai group.
• Pengikatan rute Slack menerima ID peer mentah plus bentuk target Slack seperti channel:C12345678, user:U12345678, dan <@U12345678>.
• Dengan default session.dmScope=main, DM Slack diciutkan ke sesi utama agen.
• Sesi channel: agent:<agentId>:slack:channel:<channelId>.
• Pesan channel level atas biasa tetap berada di sesi per channel, bahkan ketika replyToMode bukan off.
• Balasan thread Slack menggunakan thread_ts induk Slack untuk sufiks sesi (:thread:<threadTs>), bahkan ketika thread balasan keluar dinonaktifkan dengan replyToMode="off".
• OpenClaw menanamkan root channel level atas yang memenuhi syarat ke dalam agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> ketika root tersebut diharapkan memulai thread Slack yang terlihat, sehingga root dan balasan thread berikutnya berbagi satu sesi OpenClaw. Ini berlaku untuk event app_mention, kecocokan bot eksplisit atau pola penyebutan terkonfigurasi, dan channel requireMention: false dengan replyToMode non-off.
• Default channels.slack.thread.historyScope adalah thread; default thread.inheritParent adalah false.
• channels.slack.thread.initialHistoryLimit mengontrol berapa banyak pesan thread yang sudah ada yang diambil ketika sesi thread baru dimulai (default 20; setel 0 untuk menonaktifkan).
• channels.slack.thread.requireExplicitMention (default false): ketika true, menekan penyebutan thread implisit sehingga bot hanya merespons penyebutan @bot eksplisit di dalam thread, bahkan ketika bot sudah berpartisipasi dalam thread tersebut. Tanpa ini, balasan dalam thread yang diikuti bot melewati gerbang requireMention.

Kontrol thread balasan:

• channels.slack.replyToMode: off|first|all|batched (default off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• fallback lama untuk chat langsung: channels.slack.dm.replyToMode

Tag balasan manual didukung:

• [[reply_to_current]]
• [[reply_to:<id>]]

Untuk balasan thread Slack eksplisit dari alat message, setel replyBroadcast: true dengan action: "send" dan threadId atau replyTo untuk meminta Slack juga menyiarkan balasan thread ke channel induk. Ini dipetakan ke flag reply_broadcast chat.postMessage Slack dan hanya didukung untuk pengiriman teks atau Block Kit, bukan unggahan media.

Ketika panggilan alat message berjalan di dalam thread Slack dan menargetkan channel yang sama, OpenClaw biasanya mewarisi thread Slack saat ini sesuai replyToMode. Setel topLevel: true pada action: "send" atau action: "upload-file" untuk memaksa pesan channel induk baru sebagai gantinya. threadId: null diterima sebagai opt-out level atas yang sama.

Reaksi ack

ackReaction mengirim emoji pengakuan saat OpenClaw memproses pesan masuk. ackReactionScope menentukan kapan emoji itu benar-benar dikirim.

Emoji (ackReaction)

Urutan resolusi:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback emoji identitas agen (agents.list[].identity.emoji, atau "eyes" / 👀)

Catatan:

• Slack mengharapkan shortcode (misalnya "eyes").
• Gunakan "" untuk menonaktifkan reaksi untuk akun Slack atau secara global.

Cakupan (messages.ackReactionScope)

Provider Slack membaca cakupan dari messages.ackReactionScope (default "group-mentions"). Saat ini tidak ada penimpaan level akun Slack atau level channel Slack; nilainya bersifat global untuk Gateway.

Nilai:

• "all": bereaksi di DM dan grup.
• "direct": bereaksi hanya di DM.
• "group-all": bereaksi pada setiap pesan grup (tanpa DM).
• "group-mentions" (default): bereaksi di grup, tetapi hanya ketika bot disebut (atau di mentionable grup yang ikut serta). DM dikecualikan.
• "off" / "none": jangan pernah bereaksi.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // bereaksi di DM dan grup  },}

Streaming teks

channels.slack.streaming mengontrol perilaku pratinjau langsung:

• off: nonaktifkan streaming pratinjau langsung.
• partial (default): ganti teks pratinjau dengan output parsial terbaru.
• block: tambahkan pembaruan pratinjau dalam potongan.
• progress: tampilkan teks status progres saat menghasilkan, lalu kirim teks final.
• streaming.preview.toolProgress: ketika pratinjau draf aktif, rutekan pembaruan alat/progres ke pesan pratinjau yang sama yang diedit (default: true). Setel false untuk mempertahankan pesan alat/progres terpisah.
• streaming.preview.commandText / streaming.progress.commandText: setel ke status untuk mempertahankan baris progres alat yang ringkas sambil menyembunyikan teks command/exec mentah (default: raw).

Sembunyikan teks command/exec mentah sambil mempertahankan baris progres ringkas:

{  "channels": {    "slack": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

channels.slack.streaming.nativeTransport mengontrol streaming teks native Slack ketika channels.slack.streaming.mode adalah partial (default: true).

Kartu tugas progres native Slack bersifat opt-in untuk mode progres. Setel channels.slack.streaming.progress.nativeTaskCards ke true dengan channels.slack.streaming.mode="progress" untuk mengirim kartu rencana/tugas native Slack saat pekerjaan berjalan, lalu memperbarui kartu tugas yang sama saat selesai. Tanpa flag ini, mode progres mempertahankan perilaku pratinjau draf portabel.

• Thread balasan harus tersedia agar streaming teks native dan status thread asisten Slack muncul. Pemilihan thread tetap mengikuti replyToMode.
• Root channel, chat grup, dan DM level atas masih dapat menggunakan pratinjau draf normal ketika streaming native tidak tersedia atau tidak ada thread balasan.
• DM Slack level atas tetap di luar thread secara default, sehingga tidak menampilkan pratinjau stream/status native bergaya thread milik Slack; OpenClaw memposting dan mengedit pratinjau draf di DM sebagai gantinya.
• Media dan payload non-teks fallback ke pengiriman normal.
• Final media/error membatalkan edit pratinjau tertunda; final teks/blok yang memenuhi syarat hanya di-flush ketika dapat mengedit pratinjau di tempat.
• Jika streaming gagal di tengah balasan, OpenClaw fallback ke pengiriman normal untuk payload yang tersisa.

Gunakan pratinjau draf alih-alih streaming teks native Slack:

{  channels: {    slack: {      streaming: {        mode: "partial",        nativeTransport: false,      },    },  },}

Ikut serta dalam kartu tugas progres native Slack:

{  channels: {    slack: {      streaming: {        mode: "progress",        progress: {          nativeTaskCards: true,          render: "rich",        },      },    },  },}

Kunci lama:

• channels.slack.streamMode (replace | status_final | append) adalah alias runtime lama untuk channels.slack.streaming.mode.
• boolean channels.slack.streaming adalah alias runtime lama untuk channels.slack.streaming.mode dan channels.slack.streaming.nativeTransport.
• channels.slack.nativeStreaming lama adalah alias runtime untuk channels.slack.streaming.nativeTransport.
• Jalankan openclaw doctor --fix untuk menulis ulang konfigurasi streaming Slack tersimpan ke kunci kanonis.

Fallback reaksi mengetik

typingReaction menambahkan reaksi sementara ke pesan Slack masuk saat OpenClaw memproses balasan, lalu menghapusnya ketika run selesai. Ini paling berguna di luar balasan thread, yang menggunakan indikator status default "sedang mengetik...".

Urutan resolusi:

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

Catatan:

• Slack mengharapkan shortcode (misalnya "hourglass_flowing_sand").
• Reaksi bersifat best-effort dan pembersihan dicoba secara otomatis setelah jalur balasan atau kegagalan selesai.

Media, pemotongan, dan pengiriman

Perintah dan perilaku slash

Perintah slash muncul di Slack sebagai satu perintah terkonfigurasi atau beberapa perintah native. Konfigurasikan channels.slack.slashCommand untuk mengubah default perintah:

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

/openclaw /help

Perintah native memerlukan pengaturan manifes tambahan di aplikasi Slack Anda dan diaktifkan dengan channels.slack.commands.native: true atau commands.native: true di konfigurasi global sebagai gantinya.

• Mode otomatis perintah native nonaktif untuk Slack sehingga commands.native: "auto" tidak mengaktifkan perintah native Slack.

/help

Menu argumen native menggunakan strategi rendering adaptif yang menampilkan modal konfirmasi sebelum mengirimkan nilai opsi yang dipilih:

• hingga 5 opsi: blok tombol
• 6-100 opsi: menu pilih statis
• lebih dari 100 opsi: pilih eksternal dengan pemfilteran opsi asinkron ketika handler opsi interaktivitas tersedia
• batas Slack terlampaui: nilai opsi yang dikodekan fallback ke tombol

/think

Sesi slash menggunakan kunci terisolasi seperti agent:<agentId>:slack:slash:<userId> dan tetap merutekan eksekusi perintah ke sesi percakapan target menggunakan CommandTargetSessionKey.

Balasan interaktif

Slack dapat merender kontrol balasan interaktif yang dibuat agen, tetapi fitur ini dinonaktifkan secara default. Untuk output agen, CLI, dan Plugin baru, utamakan tombol presentation bersama atau blok pilihan. Keduanya menggunakan jalur interaksi Slack yang sama sekaligus menurun fungsinya di saluran lain.

Aktifkan secara global:

{  channels: {    slack: {      capabilities: {        interactiveReplies: true,      },    },  },}

Atau aktifkan hanya untuk satu akun Slack:

{  channels: {    slack: {      accounts: {        ops: {          capabilities: {            interactiveReplies: true,          },        },      },    },  },}

Saat diaktifkan, agen masih dapat memancarkan direktif balasan khusus Slack yang tidak digunakan lagi:

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

Direktif ini dikompilasi menjadi Slack Block Kit dan merutekan klik atau pilihan kembali melalui jalur peristiwa interaksi Slack yang sudah ada. Pertahankan untuk prompt lama dan jalan keluar khusus Slack; gunakan presentasi bersama untuk kontrol portabel baru.

API kompilator direktif juga tidak digunakan lagi untuk kode produsen baru:

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

Gunakan payload presentation dan buildSlackPresentationBlocks(...) untuk kontrol baru yang dirender Slack.

Catatan:

• Ini adalah UI lama khusus Slack. Saluran lain tidak menerjemahkan direktif Slack Block Kit menjadi sistem tombol mereka sendiri.
• Nilai callback interaktif adalah token buram yang dihasilkan OpenClaw, bukan nilai mentah yang dibuat agen.
• Jika blok interaktif yang dihasilkan akan melampaui batas Slack Block Kit, OpenClaw kembali ke balasan teks asli alih-alih mengirim payload blok yang tidak valid.

Pengiriman modal milik Plugin

Plugin Slack yang mendaftarkan handler interaktif juga dapat menerima peristiwa siklus hidup modal view_submission dan view_closed sebelum OpenClaw memadatkan payload untuk peristiwa sistem yang terlihat agen. Gunakan salah satu pola perutean ini saat membuka modal Slack:

• Atur callback_id ke openclaw:<namespace>:<payload>.
• Atau pertahankan callback_id yang ada dan letakkan pluginInteractiveData: "<namespace>:<payload>" dalam private_metadata modal.

Handler menerima ctx.interaction.kind sebagai view_submission atau view_closed, inputs yang dinormalisasi, dan objek mentah penuh stateValues dari Slack. Perutean hanya callback-id cukup untuk memanggil handler Plugin; sertakan field perutean pengguna/sesi private_metadata modal yang ada saat modal juga harus menghasilkan peristiwa sistem yang terlihat agen. Agen menerima peristiwa sistem Slack interaction: ... yang ringkas dan disunting. Jika handler mengembalikan systemEvent.summary, systemEvent.reference, atau systemEvent.data, field tersebut disertakan dalam peristiwa ringkas itu sehingga agen dapat merujuk penyimpanan milik Plugin tanpa melihat payload formulir lengkap.

Persetujuan native di Slack

Slack dapat bertindak sebagai klien persetujuan native dengan tombol dan interaksi interaktif, alih-alih kembali ke UI Web atau terminal.

• Persetujuan exec dan Plugin dapat dirender sebagai prompt Slack-native Block Kit.
• channels.slack.execApprovals.* tetap menjadi konfigurasi pengaktifan klien persetujuan exec native dan perutean DM/saluran.
• DM persetujuan exec menggunakan channels.slack.execApprovals.approvers atau commands.ownerAllowFrom.
• Persetujuan Plugin menggunakan tombol Slack-native saat Slack diaktifkan sebagai klien persetujuan native untuk sesi asal, atau saat approvals.plugin merutekan ke sesi Slack asal atau target Slack.
• DM persetujuan Plugin menggunakan pemberi persetujuan Plugin Slack dari channels.slack.allowFrom, allowFrom akun bernama, atau rute default akun.
• Otorisasi pemberi persetujuan tetap diberlakukan: pemberi persetujuan khusus exec tidak dapat menyetujui permintaan Plugin kecuali mereka juga merupakan pemberi persetujuan Plugin.

Ini menggunakan permukaan tombol persetujuan bersama yang sama seperti saluran lain. Saat interactivity diaktifkan di pengaturan aplikasi Slack Anda, prompt persetujuan dirender sebagai tombol Block Kit langsung dalam percakapan. Saat tombol tersebut ada, tombol itu adalah UX persetujuan utama; OpenClaw sebaiknya hanya menyertakan perintah manual /approve saat hasil alat menyatakan persetujuan chat tidak tersedia atau persetujuan manual adalah satu-satunya jalur.

Jalur konfigurasi:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opsional; kembali ke commands.ownerAllowFrom bila memungkinkan)
• channels.slack.execApprovals.target (dm | channel | both, default: dm)
• agentFilter, sessionFilter

Slack mengaktifkan otomatis persetujuan exec native saat enabled tidak diatur atau "auto" dan setidaknya satu pemberi persetujuan exec berhasil di-resolve. Slack juga dapat menangani persetujuan Plugin native melalui jalur klien native ini saat pemberi persetujuan Plugin Slack berhasil di-resolve dan permintaan cocok dengan filter klien native. Atur enabled: false untuk menonaktifkan Slack sebagai klien persetujuan native secara eksplisit. Atur enabled: true untuk memaksa persetujuan native aktif saat pemberi persetujuan berhasil di-resolve. Menonaktifkan persetujuan exec Slack tidak menonaktifkan pengiriman persetujuan Plugin Slack native yang diaktifkan melalui approvals.plugin; pengiriman persetujuan Plugin menggunakan pemberi persetujuan Plugin Slack sebagai gantinya.

Perilaku default tanpa konfigurasi persetujuan exec Slack eksplisit:

{  commands: {    ownerAllowFrom: ["slack:U12345678"],  },}

Konfigurasi Slack-native eksplisit hanya diperlukan saat Anda ingin menimpa pemberi persetujuan, menambahkan filter, atau memilih pengiriman ke chat asal:

{  channels: {    slack: {      execApprovals: {        enabled: true,        approvers: ["U12345678"],        target: "both",      },    },  },}

Penerusan approvals.exec bersama bersifat terpisah. Gunakan hanya saat prompt persetujuan exec juga harus dirutekan ke chat lain atau target out-of-band eksplisit. Penerusan approvals.plugin bersama juga terpisah; pengiriman native Slack menekan fallback itu hanya saat Slack dapat menangani permintaan persetujuan Plugin secara native.

/approve dalam chat yang sama juga berfungsi di saluran Slack dan DM yang sudah mendukung perintah. Lihat Persetujuan exec untuk model penerusan persetujuan lengkap.

Peristiwa dan perilaku operasional

• Edit/hapus pesan dipetakan ke peristiwa sistem.
• Siaran thread (balasan thread "Juga kirim ke saluran") diproses sebagai pesan pengguna normal.
• Peristiwa tambah/hapus reaksi dipetakan ke peristiwa sistem.
• Peristiwa anggota bergabung/keluar, saluran dibuat/diubah nama, dan tambah/hapus pin dipetakan ke peristiwa sistem.
• channel_id_changed dapat memigrasikan kunci konfigurasi saluran saat configWrites diaktifkan.
• Metadata topik/tujuan saluran diperlakukan sebagai konteks tidak tepercaya dan dapat disuntikkan ke konteks perutean.
• Pengisian awal konteks pembuka thread dan riwayat thread awal difilter oleh allowlist pengirim yang dikonfigurasi bila berlaku.
• Aksi blok, shortcut, dan interaksi modal memancarkan peristiwa sistem Slack interaction: ... terstruktur dengan field payload kaya:
  • aksi blok: nilai yang dipilih, label, nilai pemilih, dan metadata workflow_*
  • shortcut global: metadata callback dan aktor, dirutekan ke sesi langsung aktor
  • shortcut pesan: konteks callback, aktor, saluran, thread, dan pesan terpilih
  • peristiwa modal view_submission dan view_closed dengan metadata saluran yang dirutekan dan input formulir

Definisikan shortcut global atau pesan dalam konfigurasi aplikasi Slack Anda dan gunakan ID callback tidak kosong apa pun. OpenClaw mengakui payload shortcut yang cocok, menerapkan kebijakan pengirim DM/saluran yang sama seperti interaksi Slack lain, dan mengantrekan peristiwa yang disanitasi untuk sesi agen yang dirutekan. ID pemicu dan URL respons disunting dari konteks agen.

Referensi konfigurasi

Referensi utama: Referensi konfigurasi - Slack.

Pemecahan masalah

{messages: {groupChat: {  visibleReplies: "automatic",},},}

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Referensi vision lampiran

Slack dapat melampirkan media yang diunduh ke giliran agen ketika unduhan file Slack berhasil dan batas ukuran mengizinkan. File gambar dapat diteruskan melalui jalur pemahaman media atau langsung ke model balasan yang mendukung vision; file lain dipertahankan sebagai konteks file yang dapat diunduh, bukan diperlakukan sebagai input gambar.

Jenis media yang didukung

Pipeline inbound

Ketika pesan Slack dengan lampiran file tiba:

1. OpenClaw mengunduh file dari URL privat Slack menggunakan token bot.
2. File ditulis ke penyimpanan media saat berhasil.
3. Jalur media yang diunduh dan jenis konten ditambahkan ke konteks inbound.
4. Jalur model/alat yang mendukung gambar dapat menggunakan lampiran gambar dari konteks tersebut.
5. File non-gambar tetap tersedia sebagai metadata file atau referensi media untuk alat yang dapat menanganinya.

Pewarisan lampiran root thread

Ketika pesan tiba dalam thread (memiliki induk thread_ts):

• Jika balasan itu sendiri tidak memiliki media langsung dan pesan root yang disertakan memiliki file, Slack dapat menghidrasi file root sebagai konteks pemulai thread.
• Lampiran balasan langsung lebih diprioritaskan daripada lampiran pesan root.
• Pesan root yang hanya memiliki file dan tanpa teks direpresentasikan dengan placeholder lampiran sehingga fallback tetap dapat menyertakan filenya.

Penanganan multi-lampiran

Ketika satu pesan Slack berisi beberapa lampiran file:

• Setiap lampiran diproses secara independen melalui pipeline media.
• Referensi media yang diunduh digabungkan ke dalam konteks pesan.
• Urutan pemrosesan mengikuti urutan file Slack dalam payload event.
• Kegagalan dalam unduhan satu lampiran tidak memblokir lampiran lainnya.

Batas ukuran, unduhan, dan model

• Batas ukuran: Default 20 MB per file. Dapat dikonfigurasi melalui channels.slack.mediaMaxMb.
• Kegagalan unduhan: File yang tidak dapat disajikan Slack, URL kedaluwarsa, file yang tidak dapat diakses, file terlalu besar, dan respons HTML autentikasi/login Slack dilewati alih-alih dilaporkan sebagai format yang tidak didukung.
• Model vision: Analisis gambar menggunakan model balasan aktif ketika model tersebut mendukung vision, atau model gambar yang dikonfigurasi di agents.defaults.imageModel.

Batasan yang diketahui

Dokumentasi terkait

• Pipeline pemahaman media
• Alat PDF
• Epic: #51349 — Pengaktifan vision lampiran Slack
• Uji regresi: #51353
• Verifikasi live: #51354

Terkait