Slack

Siap produksi untuk DM dan channel melalui integrasi aplikasi Slack. Mode default adalah Socket Mode; HTTP Request URLs juga didukung.

# Memilih Socket Mode atau HTTP Request URLs

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

# Penyiapan 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
},
"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",
"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
},
"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",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > 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" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

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
},
"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",
"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
},
"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",
"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=xoxb-...
export 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",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Penyesuaian transport Socket Mode

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

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

Gunakan ini hanya untuk workspace Socket Mode yang mencatat timeout pong websocket/ping-server Slack atau berjalan pada 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 peristiwa aplikasi tetap merupakan status aplikasi, bukan sinyal keaktifan transport.

# Daftar periksa manifes dan cakupan

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

Manifes dasar (default Socket Mode):

{
  "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
    },
    "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",
        "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 HTTP Request URLs, ganti settings dengan varian HTTP dan tambahkan url ke setiap perintah slash. Diperlukan URL publik:

{
  "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",
        "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 fitur berbeda yang memperluas default di atas.

Manifes default mengaktifkan tab Home Slack App Home dan berlangganan ke app_home_opened. Saat anggota workspace membuka tab Home, OpenClaw menerbitkan tampilan Home default yang aman dengan views.publish; tidak ada payload percakapan atau konfigurasi privat yang disertakan. Tab Messages tetap diaktifkan untuk DM Slack.

{
"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": "/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.
• botToken, appToken, signingSecret, dan userToken menerima string plaintext atau objek SecretRef.
• Token konfigurasi menggantikan fallback env.
• Fallback env SLACK_BOT_TOKEN / SLACK_APP_TOKEN hanya berlaku untuk akun default.
• userToken (xoxp-...) hanya melalui konfigurasi (tanpa fallback env) dan default-nya adalah perilaku hanya baca (userTokenReadOnly: true).

Perilaku snapshot status:

• Pemeriksaan akun Slack melacak bidang *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 secret non-inline lainnya, tetapi jalur perintah/runtime saat ini tidak dapat me-resolve nilai aktualnya.
• Dalam mode HTTP, signingSecretStatus disertakan; dalam Socket Mode, pasangan yang diperlukan adalah botTokenStatus + appTokenStatus.

# Aksi dan gate

Aksi Slack dikontrol 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 routing

# Threading, sesi, dan tag balasan

• DM di-route sebagai direct; channel sebagai channel; MPIM sebagai group.
• Binding 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>.
• Balasan thread dapat membuat suffix sesi thread (:thread:<threadTs>) saat berlaku.
• 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 saat sesi thread baru dimulai (default 20; setel 0 untuk menonaktifkan).
• channels.slack.thread.requireExplicitMention (default false): saat true, menekan mention thread implisit sehingga bot hanya merespons mention @bot eksplisit di dalam thread, bahkan ketika bot sudah berpartisipasi dalam thread. Tanpa ini, balasan dalam thread yang diikuti bot melewati gating requireMention.

Kontrol threading balasan:

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

Tag balasan manual didukung:

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

# Reaksi ack

ackReaction mengirim emoji pengakuan saat OpenClaw memproses pesan masuk.

Urutan resolusi:

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

Catatan:

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

# 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 berbentuk chunk.
• progress: tampilkan teks status progres saat menghasilkan, lalu kirim teks final.
• streaming.preview.toolProgress: saat pratinjau draf aktif, route pembaruan tool/progres ke pesan pratinjau yang sama yang diedit (default: true). Setel false untuk mempertahankan pesan tool/progres terpisah.
• streaming.preview.commandText / streaming.progress.commandText: setel ke status untuk mempertahankan baris progres tool yang ringkas sambil menyembunyikan teks perintah/exec mentah (default: raw).

Sembunyikan teks perintah/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 saat channels.slack.streaming.mode adalah partial (default: true).

• 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 tingkat atas tetap dapat menggunakan pratinjau draf normal saat streaming native tidak tersedia atau tidak ada thread balasan.
• DM Slack tingkat atas tetap berada 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.
• Payload media dan non-teks melakukan fallback ke pengiriman normal.
• Final media/error membatalkan edit pratinjau yang tertunda; final teks/blok yang memenuhi syarat hanya di-flush ketika dapat mengedit pratinjau di tempat.
• Jika streaming gagal di tengah balasan, OpenClaw melakukan fallback ke pengiriman normal untuk payload yang tersisa.

Gunakan pratinjau draf alih-alih streaming teks native Slack:

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

Key legacy:

• 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 yang tersimpan ke kunci kanonis.

# Fallback reaksi mengetik

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

Urutan resolusi:

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

Catatan:

• Slack mengharapkan shortcode (misalnya "hourglass_flowing_sand").
• Reaksi bersifat upaya terbaik 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 yang dikonfigurasi 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 dalam 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 mengirim nilai opsi yang dipilih:

• hingga 5 opsi: blok tombol
• 6-100 opsi: menu pilih statis
• lebih dari 100 opsi: pilih eksternal dengan pemfilteran opsi async saat handler opsi interaktivitas tersedia
• batas Slack terlampaui: nilai opsi yang dienkode 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 ditulis agen, tetapi fitur ini dinonaktifkan secara default.

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 dapat mengeluarkan direktif balasan khusus Slack:

• [[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 ada.

Catatan:

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

# Persetujuan exec di Slack

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

• Persetujuan exec menggunakan channels.slack.execApprovals.* untuk perutean DM/channel native.
• Persetujuan Plugin tetap dapat diselesaikan melalui permukaan tombol native Slack yang sama ketika permintaan sudah masuk ke Slack dan jenis ID persetujuan adalah plugin:.
• Otorisasi pemberi persetujuan tetap ditegakkan: hanya pengguna yang diidentifikasi sebagai pemberi persetujuan yang dapat menyetujui atau menolak permintaan melalui Slack.

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

Jalur konfigurasi:

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

Slack mengaktifkan otomatis persetujuan exec native ketika enabled tidak diatur atau "auto" dan setidaknya satu pemberi persetujuan dapat diresolusi. Atur enabled: false untuk menonaktifkan Slack sebagai klien persetujuan native secara eksplisit. Atur enabled: true untuk memaksa persetujuan native aktif ketika pemberi persetujuan dapat diresolusi.

Perilaku default tanpa konfigurasi persetujuan exec Slack eksplisit:

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

Konfigurasi native Slack eksplisit hanya diperlukan ketika Anda ingin menimpa pemberi persetujuan, menambahkan filter, atau ikut menggunakan pengiriman chat asal:

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

Penerusan bersama approvals.exec terpisah. Gunakan hanya ketika prompt persetujuan exec juga harus dirutekan ke chat lain atau target out-of-band eksplisit. Penerusan bersama approvals.plugin juga terpisah; tombol native Slack tetap dapat menyelesaikan persetujuan Plugin ketika permintaan tersebut sudah masuk ke Slack.

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

# Peristiwa dan perilaku operasional

• Edit/hapus pesan dipetakan menjadi peristiwa sistem.
• Siaran thread (balasan thread "Also send to channel") diproses sebagai pesan pengguna normal.
• Peristiwa tambah/hapus reaksi dipetakan menjadi peristiwa sistem.
• Peristiwa anggota bergabung/keluar, channel dibuat/diubah namanya, dan tambah/hapus pin dipetakan menjadi peristiwa sistem.
• channel_id_changed dapat memigrasikan kunci konfigurasi channel ketika configWrites diaktifkan.
• Metadata topik/tujuan channel diperlakukan sebagai konteks tidak tepercaya dan dapat disuntikkan ke konteks perutean.
• Starter thread dan penyemaian konteks riwayat thread awal difilter oleh daftar izin pengirim yang dikonfigurasi bila berlaku.
• Aksi blok dan interaksi modal memancarkan peristiwa sistem Slack interaction: ... terstruktur dengan kolom payload kaya:
  • aksi blok: nilai yang dipilih, label, nilai picker, dan metadata workflow_*
  • peristiwa modal view_submission dan view_closed dengan metadata channel yang dirutekan dan input formulir

# Referensi konfigurasi

Referensi utama: Referensi konfigurasi - Slack.

# Pemecahan masalah

openclaw channels status --probe
openclaw logs --follow
openclaw 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 berkemampuan visi; file lain dipertahankan sebagai konteks file yang dapat diunduh, bukan diperlakukan sebagai input gambar.

# Jenis media yang didukung

# Pipeline masuk

Ketika pesan Slack dengan lampiran file tiba:

1. OpenClaw mengunduh file dari URL pribadi Slack menggunakan token bot (xoxb-...).
2. File ditulis ke penyimpanan media saat berhasil.
3. Jalur media yang diunduh dan jenis konten ditambahkan ke konteks masuk.
4. Jalur model/alat berkemampuan 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 utas

Ketika pesan tiba dalam sebuah utas (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 utas.
• Lampiran balasan langsung didahulukan daripada lampiran pesan root.
• Pesan root yang hanya memiliki file dan tanpa teks direpresentasikan dengan placeholder lampiran agar fallback tetap dapat menyertakan file-file tersebut.

# 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 peristiwa.
• Kegagalan unduhan pada satu lampiran tidak memblokir lampiran lain.

# 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 oleh Slack, URL kedaluwarsa, file tidak dapat diakses, file terlalu besar, dan respons HTML auth/login Slack dilewati alih-alih dilaporkan sebagai format yang tidak didukung.
• Model visi: Analisis gambar menggunakan model balasan aktif ketika mendukung visi, atau model gambar yang dikonfigurasi di agents.defaults.imageModel.

# Batas yang diketahui

# Dokumentasi terkait

• Pipeline pemahaman media
• Alat PDF
• Epik: #51349 — pengaktifan visi lampiran Slack
• Pengujian regresi: #51353
• Verifikasi langsung: #51354

# Terkait