Slack

พร้อมใช้งานจริงสำหรับ DM และช่องผ่านการผสานรวมแอป Slack โหมดเริ่มต้นคือ Socket Mode; รองรับ HTTP Request URLs ด้วยเช่นกัน โหมด relay มีไว้สำหรับการปรับใช้แบบมีการจัดการที่เราเตอร์ที่เชื่อถือได้เป็นเจ้าของทางเข้า Slack

การเลือก Socket Mode หรือ HTTP Request URLs

ทั้งสองทรานสปอร์ตพร้อมใช้งานจริงและมีความสามารถเทียบเท่ากันสำหรับการส่งข้อความ คำสั่ง slash, App Home และการโต้ตอบ ให้เลือกตามรูปแบบการปรับใช้ ไม่ใช่ตามฟีเจอร์

โหมด relay

โหมด relay แยกทางเข้า Slack ออกจาก OpenClaw gateway เราเตอร์ที่เชื่อถือได้เป็นเจ้าของ การเชื่อมต่อ Slack Socket Mode เดี่ยว เลือก gateway ปลายทาง และส่งต่ออีเวนต์แบบมีชนิด ผ่าน websocket ที่ผ่านการยืนยันตัวตนแล้ว gateway ยังคงใช้โทเค็นบอตของตัวเองสำหรับ การเรียก Slack Web API ขาออก

{  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 ต้องใช้ wss:// เว้นแต่ว่าชี้ไปยัง localhost ให้ถือว่า bearer token และ ตารางเส้นทางของเราเตอร์เป็นส่วนหนึ่งของขอบเขตการอนุญาต Slack: อีเวนต์ที่ถูกกำหนดเส้นทางจะเข้าสู่ ตัวจัดการข้อความ Slack ปกติในฐานะ activation ที่ได้รับอนุญาตแล้ว slack_identity ที่เราเตอร์ให้มา ในเฟรม hello ของ websocket สามารถตั้งชื่อผู้ใช้และไอคอนขาออกเริ่มต้นได้; identity ที่ผู้เรียกส่งมาอย่างชัดเจน ยังคงมีสิทธิ์เหนือกว่า การเชื่อมต่อ relay จะเชื่อมต่อใหม่ด้วยจังหวะ backoff แบบมีขอบเขตเดียวกับ Socket Mode และล้าง identity ที่เราเตอร์ให้มาทุกครั้งที่ตัดการเชื่อมต่อ

ติดตั้ง

ติดตั้ง Slack ก่อนกำหนดค่าช่อง:

openclaw plugins install @openclaw/slack

plugins install ลงทะเบียนและเปิดใช้งาน Plugin Plugin ยังคงไม่ทำอะไรจนกว่าคุณจะกำหนดค่าแอป Slack และการตั้งค่าช่องด้านล่าง ดู Plugins สำหรับลักษณะการทำงานทั่วไปของ Plugin และกฎการติดตั้ง

การตั้งค่าอย่างรวดเร็ว

{"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: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

การปรับแต่ง transport ของ Socket Mode

OpenClaw ตั้งค่า timeout สำหรับ pong ของไคลเอนต์ Slack SDK เป็น 15 วินาทีโดยค่าเริ่มต้นสำหรับ Socket Mode ให้ override การตั้งค่า transport เฉพาะเมื่อคุณต้องปรับแต่งให้เหมาะกับเวิร์กสเปซหรือโฮสต์เฉพาะ:

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

ใช้เฉพาะกับเวิร์กสเปซ Socket Mode ที่บันทึก timeout ของ Slack websocket pong/server-ping หรือทำงานบนโฮสต์ที่ทราบว่ามีภาวะ event-loop starvation clientPingTimeout คือเวลารอ pong หลังจาก SDK ส่ง client ping; serverPingTimeout คือเวลารอ ping จากเซิร์ฟเวอร์ Slack ข้อความและเหตุการณ์ของแอปยังคงเป็นสถานะแอปพลิเคชัน ไม่ใช่สัญญาณความมีชีวิตของ transport

หมายเหตุ:

• socketMode จะถูกละเว้นในโหมด HTTP Request URL
• การตั้งค่า channels.slack.socketMode พื้นฐานมีผลกับบัญชี Slack ทั้งหมด เว้นแต่จะถูก override การ override รายบัญชีใช้ channels.slack.accounts.<accountId>.socketMode; เนื่องจากนี่เป็น object override ให้รวมทุกฟิลด์การปรับแต่ง socket ที่คุณต้องการสำหรับบัญชีนั้น
• มีเพียง clientPingTimeout เท่านั้นที่มีค่าเริ่มต้นของ OpenClaw (15000) serverPingTimeout และ pingPongLoggingEnabled จะถูกส่งไปยัง Slack SDK เฉพาะเมื่อกำหนดค่าไว้
• backoff ในการรีสตาร์ท Socket Mode เริ่มประมาณ 2 วินาทีและจำกัดสูงสุดประมาณ 30 วินาที ความล้มเหลวแบบกู้คืนได้ระหว่างเริ่มต้น, รอเริ่มต้น และตัดการเชื่อมต่อจะ retry จนกว่า channel จะหยุด ข้อผิดพลาดถาวรของบัญชีและ credentials เช่น auth ไม่ถูกต้อง, token ถูกเพิกถอน หรือ scopes ขาดหาย จะล้มเหลวทันทีแทนที่จะ retry ตลอดไป

รายการตรวจสอบ manifest และ scope

manifest พื้นฐานของแอป Slack เหมือนกันสำหรับ Socket Mode และ HTTP Request URLs เฉพาะบล็อก settings (และ url ของ slash command) เท่านั้นที่ต่างกัน

manifest พื้นฐาน (ค่าเริ่มต้นของ 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    },    "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"      ]    }  }}

สำหรับ โหมด HTTP Request URLs ให้แทนที่ settings ด้วยตัวแปร HTTP และเพิ่ม url ให้แต่ละ slash command ต้องมี URL สาธารณะ:

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

การตั้งค่า manifest เพิ่มเติม

แสดงฟีเจอร์ต่าง ๆ ที่ขยายค่าเริ่มต้นข้างต้น

แท็บ Home ของ Slack App Home และสมัครรับ app_home_opened ถูกเปิดใช้งานในแมนิเฟสต์เริ่มต้น เมื่อสมาชิกเวิร์กสเปซเปิดแท็บ Home, OpenClaw จะเผยแพร่มุมมอง Home เริ่มต้นที่ปลอดภัยด้วย views.publish; ไม่มีเพย์โหลดการสนทนาหรือการกำหนดค่าส่วนตัวรวมอยู่ด้วย แท็บ Messages ยังคงเปิดใช้งานสำหรับ Slack DM แมนิเฟสต์ยังเปิดใช้งานเธรดผู้ช่วยของ Slack ด้วย features.assistant_view, assistant:write, assistant_thread_started และ assistant_thread_context_changed; เธรดผู้ช่วยจะถูกส่งต่อไปยังเซสชันเธรด OpenClaw ของตัวเอง และเก็บบริบทเธรดที่ 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": "/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"}]}

โมเดลโทเค็น

• ต้องมี botToken + appToken สำหรับ Socket Mode
• โหมด HTTP ต้องใช้ botToken + signingSecret
• โหมด Relay ต้องใช้ botToken รวมถึง relay.url, relay.authToken และ relay.gatewayId; ไม่ใช้โทเค็นแอปหรือ signing secret
• botToken, appToken, signingSecret, relay.authToken และ userToken รับสตริงข้อความธรรมดา หรือออบเจ็กต์ SecretRef ได้
• โทเค็นจากการกำหนดค่าจะแทนที่ env fallback
• env fallback SLACK_BOT_TOKEN / SLACK_APP_TOKEN ใช้กับบัญชีเริ่มต้นเท่านั้น
• userToken กำหนดค่าได้เท่านั้น (ไม่มี env fallback) และมีค่าเริ่มต้นเป็นพฤติกรรมอ่านอย่างเดียว (userTokenReadOnly: true)

พฤติกรรมสแนปช็อตสถานะ:

• การตรวจสอบบัญชี Slack ติดตามฟิลด์ *Source และ *Status ต่อข้อมูลประจำตัว (botToken, appToken, signingSecret, userToken)
• สถานะคือ available, configured_unavailable หรือ missing
• configured_unavailable หมายความว่าบัญชีถูกกำหนดค่าผ่าน SecretRef หรือแหล่งข้อมูลลับแบบไม่ฝังในบรรทัดอื่น แต่เส้นทางคำสั่ง/รันไทม์ปัจจุบัน ไม่สามารถแปลงค่าเป็นค่าจริงได้
• ในโหมด HTTP จะรวม signingSecretStatus; ใน Socket Mode คู่ที่ต้องมีคือ botTokenStatus + appTokenStatus

แอ็กชันและเกต

แอ็กชันของ Slack ควบคุมด้วย channels.slack.actions.*

กลุ่มแอ็กชันที่มีในเครื่องมือ Slack ปัจจุบัน:

แอ็กชันข้อความ Slack ปัจจุบันประกอบด้วย send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info และ emoji-list download-file รับ ID ไฟล์ Slack ที่แสดงในตัวแทนตำแหน่งไฟล์ขาเข้า และส่งคืนตัวอย่างรูปภาพสำหรับรูปภาพหรือเมทาดาทาไฟล์ในเครื่องสำหรับไฟล์ประเภทอื่น

การควบคุมการเข้าถึงและการกำหนดเส้นทาง

เธรด เซสชัน และแท็กตอบกลับ

• DM จะกำหนดเส้นทางเป็น direct; ช่องเป็น channel; MPIM เป็น group
• การผูกเส้นทาง Slack รับ ID เพียร์ดิบ รวมถึงรูปแบบเป้าหมาย Slack เช่น channel:C12345678, user:U12345678 และ <@U12345678>
• เมื่อใช้ค่าเริ่มต้น session.dmScope=main DM ของ Slack จะถูกรวมเข้ากับเซสชันหลักของเอเจนต์
• เซสชันช่อง: agent:<agentId>:slack:channel:<channelId>
• ข้อความช่องระดับบนสุดทั่วไปจะอยู่ในเซสชันต่อช่อง แม้เมื่อ replyToMode ไม่ใช่ off
• การตอบกลับเธรด Slack ใช้ thread_ts ของ Slack ของพาเรนต์สำหรับส่วนท้ายเซสชัน (:thread:<threadTs>) แม้เมื่อปิดการตอบกลับแบบเธรดขาออกด้วย replyToMode="off"
• OpenClaw จะเพาะ root ช่องระดับบนสุดที่เข้าเงื่อนไขไว้ใน agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> เมื่อคาดว่า root นั้นจะเริ่มเธรด Slack ที่มองเห็นได้ เพื่อให้ root และการตอบกลับเธรดภายหลังใช้เซสชัน OpenClaw เดียวกัน สิ่งนี้ใช้กับอีเวนต์ app_mention, การจับคู่บอทอย่างชัดเจนหรือ mention-pattern ที่กำหนดค่าไว้ และช่อง requireMention: false ที่มี replyToMode ไม่ใช่ off
• ค่าเริ่มต้นของ channels.slack.thread.historyScope คือ thread; ค่าเริ่มต้นของ thread.inheritParent คือ false
• channels.slack.thread.initialHistoryLimit ควบคุมจำนวนข้อความเธรดที่มีอยู่ที่จะถูกดึงเมื่อเซสชันเธรดใหม่เริ่มต้น (ค่าเริ่มต้น 20; ตั้งเป็น 0 เพื่อปิด)
• channels.slack.thread.requireExplicitMention (ค่าเริ่มต้น false): เมื่อเป็น true จะระงับการกล่าวถึงเธรดโดยนัย เพื่อให้บอทตอบสนองเฉพาะการกล่าวถึง @bot อย่างชัดเจนภายในเธรด แม้เมื่อบอทเคยร่วมอยู่ในเธรดแล้ว หากไม่มีสิ่งนี้ การตอบกลับในเธรดที่บอทเข้าร่วมจะข้ามการกั้น requireMention

ตัวควบคุมการตอบกลับแบบเธรด:

• channels.slack.replyToMode: off|first|all|batched (ค่าเริ่มต้น off)
• channels.slack.replyToModeByChatType: ต่อ direct|group|channel
• fallback แบบ legacy สำหรับแชทโดยตรง: channels.slack.dm.replyToMode

รองรับแท็กตอบกลับด้วยตนเอง:

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

สำหรับการตอบกลับเธรด Slack อย่างชัดเจนจากเครื่องมือ message ให้ตั้ง replyBroadcast: true พร้อม action: "send" และ threadId หรือ replyTo เพื่อขอให้ Slack กระจายการตอบกลับเธรดไปยังช่องพาเรนต์ด้วย สิ่งนี้แมปกับแฟล็ก reply_broadcast ของ Slack chat.postMessage และรองรับเฉพาะการส่งข้อความหรือ Block Kit เท่านั้น ไม่รองรับการอัปโหลดสื่อ

เมื่อการเรียกเครื่องมือ message ทำงานภายในเธรด Slack และกำหนดเป้าหมายเป็นช่องเดียวกัน OpenClaw โดยปกติจะสืบทอดเธรด Slack ปัจจุบันตาม replyToMode ตั้ง topLevel: true บน action: "send" หรือ action: "upload-file" เพื่อบังคับให้เป็นข้อความใหม่ในช่องพาเรนต์แทน threadId: null จะถูกยอมรับเป็นการเลือกไม่ใช้ระดับบนสุดแบบเดียวกัน

รีแอ็กชัน Ack

ackReaction ส่งอีโมจิรับทราบขณะที่ OpenClaw กำลังประมวลผลข้อความขาเข้า ackReactionScope ตัดสินว่าอีโมจินั้นจะถูกส่งจริง เมื่อใด

อีโมจิ (ackReaction)

ลำดับการแก้ค่า:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback อีโมจิของตัวตนเอเจนต์ (agents.list[].identity.emoji มิฉะนั้น "eyes" / 👀)

หมายเหตุ:

• Slack คาดหวัง shortcode (เช่น "eyes")
• ใช้ "" เพื่อปิดรีแอ็กชันสำหรับบัญชี Slack หรือทั่วโลก

ขอบเขต (messages.ackReactionScope)

ผู้ให้บริการ Slack อ่านขอบเขตจาก messages.ackReactionScope (ค่าเริ่มต้น "group-mentions") ปัจจุบันไม่มีการเขียนทับระดับบัญชี Slack หรือระดับช่อง Slack; ค่านี้เป็นแบบทั่วทั้ง gateway

ค่า:

• "all": รีแอ็กต์ใน DM และกลุ่ม
• "direct": รีแอ็กต์เฉพาะใน DM
• "group-all": รีแอ็กต์กับทุกข้อความกลุ่ม (ไม่มี DM)
• "group-mentions" (ค่าเริ่มต้น): รีแอ็กต์ในกลุ่ม แต่เฉพาะเมื่อมีการกล่าวถึงบอท (หรือใน mentionables ของกลุ่มที่เลือกเข้าร่วม) ไม่รวม DM
• "off" / "none": ไม่รีแอ็กต์เลย

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // react in DMs and groups  },}

การสตรีมข้อความ

channels.slack.streaming ควบคุมพฤติกรรมตัวอย่างสด:

• off: ปิดการสตรีมตัวอย่างสด
• partial (ค่าเริ่มต้น): แทนที่ข้อความตัวอย่างด้วยผลลัพธ์บางส่วนล่าสุด
• block: ต่อท้ายการอัปเดตตัวอย่างแบบเป็นชิ้น
• progress: แสดงข้อความสถานะความคืบหน้าขณะสร้าง จากนั้นส่งข้อความสุดท้าย
• streaming.preview.toolProgress: เมื่อตัวอย่างฉบับร่างทำงานอยู่ ให้กำหนดเส้นทางการอัปเดตเครื่องมือ/ความคืบหน้าเข้าสู่ข้อความตัวอย่างที่ถูกแก้ไขเดียวกัน (ค่าเริ่มต้น: true) ตั้ง false เพื่อเก็บข้อความเครื่องมือ/ความคืบหน้าแยกต่างหาก
• streaming.preview.commandText / streaming.progress.commandText: ตั้งเป็น status เพื่อคงบรรทัดความคืบหน้าของเครื่องมือแบบกะทัดรัดไว้ ขณะซ่อนข้อความคำสั่ง/exec ดิบ (ค่าเริ่มต้น: raw)

ซ่อนข้อความคำสั่ง/exec ดิบขณะที่ยังคงบรรทัดความคืบหน้าแบบกะทัดรัด:

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

channels.slack.streaming.nativeTransport ควบคุมการสตรีมข้อความแบบเนทีฟของ Slack เมื่อ channels.slack.streaming.mode เป็น partial (ค่าเริ่มต้น: true)

การ์ดงานความคืบหน้าแบบเนทีฟของ Slack เป็นแบบเลือกใช้สำหรับโหมดความคืบหน้า ตั้ง channels.slack.streaming.progress.nativeTaskCards เป็น true พร้อม channels.slack.streaming.mode="progress" เพื่อส่งการ์ดแผน/งานแบบเนทีฟของ Slack ขณะงานกำลังทำงาน จากนั้นอัปเดตการ์ดงานเดียวกันเมื่อเสร็จสิ้น หากไม่มีแฟล็กนี้ โหมดความคืบหน้าจะคงพฤติกรรมตัวอย่างฉบับร่างแบบพกพาไว้

• ต้องมีเธรดตอบกลับเพื่อให้การสตรีมข้อความแบบเนทีฟและสถานะเธรดผู้ช่วยของ Slack ปรากฏ การเลือกเธรดยังคงเป็นไปตาม replyToMode
• root ของช่อง แชทกลุ่ม และ DM ระดับบนสุดยังคงใช้ตัวอย่างฉบับร่างปกติได้เมื่อการสตรีมแบบเนทีฟไม่พร้อมใช้งานหรือไม่มีเธรดตอบกลับ
• DM Slack ระดับบนสุดจะอยู่นอกเธรดโดยค่าเริ่มต้น ดังนั้นจะไม่แสดงตัวอย่างสตรีม/สถานะแบบเนทีฟสไตล์เธรดของ Slack; OpenClaw จะโพสต์และแก้ไขตัวอย่างฉบับร่างใน DM แทน
• สื่อและเพย์โหลดที่ไม่ใช่ข้อความจะ fallback ไปยังการส่งปกติ
• ผลลัพธ์สุดท้ายที่เป็นสื่อ/ข้อผิดพลาดจะยกเลิกการแก้ไขตัวอย่างที่ค้างอยู่; ผลลัพธ์สุดท้ายแบบข้อความ/block ที่เข้าเงื่อนไขจะ flush เฉพาะเมื่อสามารถแก้ไขตัวอย่างในที่เดิมได้
• หากการสตรีมล้มเหลวกลางการตอบกลับ OpenClaw จะ fallback ไปยังการส่งปกติสำหรับเพย์โหลดที่เหลือ

ใช้ตัวอย่างฉบับร่างแทนการสตรีมข้อความแบบเนทีฟของ Slack:

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

เลือกใช้การ์ดงานความคืบหน้าแบบเนทีฟของ Slack:

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

คีย์ Legacy:

• channels.slack.streamMode (replace | status_final | append) เป็น alias รันไทม์แบบ legacy สำหรับ channels.slack.streaming.mode
• boolean channels.slack.streaming เป็น alias รันไทม์แบบ legacy สำหรับ channels.slack.streaming.mode และ channels.slack.streaming.nativeTransport
• channels.slack.nativeStreaming แบบ legacy เป็น alias รันไทม์สำหรับ channels.slack.streaming.nativeTransport
• รัน openclaw doctor --fix เพื่อเขียน config การสตรีม Slack ที่คงอยู่แล้วใหม่เป็นคีย์ canonical

fallback รีแอ็กชันการพิมพ์

typingReaction เพิ่มรีแอ็กชันชั่วคราวให้กับข้อความ Slack ขาเข้าขณะที่ OpenClaw กำลังประมวลผลการตอบกลับ จากนั้นลบออกเมื่อการรันเสร็จสิ้น สิ่งนี้มีประโยชน์มากที่สุดนอกการตอบกลับเธรด ซึ่งใช้ตัวบ่งชี้สถานะ "is typing..." เริ่มต้น

ลำดับการแก้ค่า:

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

หมายเหตุ:

• Slack คาดหวัง shortcode (เช่น "hourglass_flowing_sand")
• รีแอ็กชันเป็นแบบ best-effort และจะพยายามล้างข้อมูลโดยอัตโนมัติหลังเส้นทางตอบกลับหรือล้มเหลวเสร็จสิ้น

สื่อ การแบ่งชิ้น และการส่ง

คำสั่งและพฤติกรรมสแลช

คำสั่งสแลชจะแสดงใน Slack เป็นคำสั่งที่กำหนดค่าไว้คำสั่งเดียวหรือหลายคำสั่งเนทีฟ กำหนดค่า channels.slack.slashCommand เพื่อเปลี่ยนค่าเริ่มต้นของคำสั่ง:

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

/openclaw /help

คำสั่งเนทีฟต้องใช้ การตั้งค่า manifest เพิ่มเติม ในแอป Slack ของคุณ และเปิดใช้ด้วย channels.slack.commands.native: true หรือ commands.native: true ในการกำหนดค่าส่วนกลางแทน

• โหมดอัตโนมัติของคำสั่งเนทีฟเป็น ปิด สำหรับ Slack ดังนั้น commands.native: "auto" จะไม่เปิดใช้คำสั่งเนทีฟของ Slack

/help

เมนูอาร์กิวเมนต์เนทีฟใช้กลยุทธ์การเรนเดอร์แบบปรับตัว ซึ่งแสดง modal ยืนยันก่อน dispatch ค่า option ที่เลือก:

• สูงสุด 5 ตัวเลือก: block ปุ่ม
• 6-100 ตัวเลือก: เมนูเลือกแบบ static
• มากกว่า 100 ตัวเลือก: เลือกแบบ external พร้อมการกรอง option แบบ async เมื่อมีตัวจัดการ interactivity options
• เกินขีดจำกัด Slack: ค่า option ที่เข้ารหัสจะ fallback ไปเป็นปุ่ม

/think

เซสชัน Slash ใช้คีย์ที่แยกกัน เช่น agent:<agentId>:slack:slash:<userId> และยังคงกำหนดเส้นทางการเรียกใช้คำสั่งไปยังเซสชันการสนทนาเป้าหมายโดยใช้ CommandTargetSessionKey

การตอบกลับแบบโต้ตอบ

Slack สามารถแสดงผลตัวควบคุมการตอบกลับแบบโต้ตอบที่ agent เขียนขึ้นได้ แต่ฟีเจอร์นี้ถูกปิดใช้งานโดยค่าเริ่มต้น สำหรับเอาต์พุตใหม่จาก agent, CLI และ Plugin ให้เลือกใช้ปุ่ม presentation หรือบล็อก select ที่ใช้ร่วมกันเป็นหลัก ทั้งสองใช้เส้นทางการโต้ตอบของ Slack เดียวกัน และยังลดระดับการทำงานได้บนช่องทางอื่น

เปิดใช้งานแบบทั่วทั้งระบบ:

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

หรือเปิดใช้งานเฉพาะบัญชี Slack หนึ่งบัญชี:

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

เมื่อเปิดใช้งานแล้ว agents ยังสามารถส่งคำสั่งตอบกลับแบบ Slack-only ที่เลิกแนะนำแล้วได้:

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

คำสั่งเหล่านี้จะถูกคอมไพล์เป็น Slack Block Kit และกำหนดเส้นทางการคลิกหรือการเลือก กลับผ่านเส้นทางเหตุการณ์การโต้ตอบของ Slack ที่มีอยู่ เก็บไว้สำหรับพรอมป์เก่า และทางออกเฉพาะ Slack; ใช้ presentation ที่ใช้ร่วมกันสำหรับตัวควบคุมแบบพกพาใหม่

API ของตัวคอมไพเลอร์คำสั่งก็เลิกแนะนำสำหรับโค้ด producer ใหม่เช่นกัน:

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

ใช้เพย์โหลด presentation และ buildSlackPresentationBlocks(...) สำหรับตัวควบคุมใหม่ ที่แสดงผลใน Slack

หมายเหตุ:

• นี่คือ UI ดั้งเดิมเฉพาะ Slack ช่องทางอื่นจะไม่แปลคำสั่ง Slack Block Kit เป็นระบบปุ่มของตนเอง
• ค่าคอลแบ็กแบบโต้ตอบเป็นโทเค็นทึบที่ OpenClaw สร้างขึ้น ไม่ใช่ค่าดิบที่ agent เขียนขึ้น
• หากบล็อกแบบโต้ตอบที่สร้างขึ้นจะเกินขีดจำกัดของ Slack Block Kit, OpenClaw จะถอยกลับไปใช้ข้อความตอบกลับเดิมแทนการส่งเพย์โหลด blocks ที่ไม่ถูกต้อง

การส่ง modal ที่ Plugin เป็นเจ้าของ

Plugin ของ Slack ที่ลงทะเบียนตัวจัดการแบบโต้ตอบยังสามารถรับเหตุการณ์วงจรชีวิต view_submission และ view_closed ก่อนที่ OpenClaw จะบีบอัด เพย์โหลดสำหรับเหตุการณ์ระบบที่ agent มองเห็นได้ ใช้รูปแบบการกำหนดเส้นทางเหล่านี้แบบใดแบบหนึ่ง เมื่อเปิด Slack modal:

• ตั้งค่า callback_id เป็น openclaw:<namespace>:<payload>
• หรือเก็บ callback_id ที่มีอยู่ไว้ และใส่ pluginInteractiveData: "<namespace>:<payload>" ใน private_metadata ของ modal

ตัวจัดการจะได้รับ ctx.interaction.kind เป็น view_submission หรือ view_closed, inputs ที่ทำให้เป็นมาตรฐานแล้ว และอ็อบเจ็กต์ stateValues ดิบแบบเต็มจาก Slack การกำหนดเส้นทางด้วย callback-id อย่างเดียวเพียงพอสำหรับเรียกใช้ตัวจัดการของ Plugin; ใส่ ฟิลด์การกำหนดเส้นทางผู้ใช้/เซสชัน private_metadata ของ modal ที่มีอยู่ด้วยเมื่อ modal ควรสร้างเหตุการณ์ระบบที่ agent มองเห็นได้ด้วย agent จะได้รับ เหตุการณ์ระบบ Slack interaction: ... แบบกะทัดรัดและผ่านการลบข้อมูลอ่อนไหวแล้ว หากตัวจัดการส่งคืน systemEvent.summary, systemEvent.reference หรือ systemEvent.data ฟิลด์เหล่านั้น จะถูกรวมไว้ในเหตุการณ์แบบกะทัดรัดนั้น เพื่อให้ agent อ้างอิงพื้นที่จัดเก็บที่ Plugin เป็นเจ้าของได้โดยไม่เห็นเพย์โหลดฟอร์มทั้งหมด

การอนุมัติแบบเนทีฟใน Slack

Slack สามารถทำหน้าที่เป็นไคลเอนต์อนุมัติแบบเนทีฟด้วยปุ่มและการโต้ตอบแบบโต้ตอบ แทนที่จะถอยกลับไปใช้ Web UI หรือเทอร์มินัล

• การอนุมัติ Exec และ Plugin สามารถแสดงผลเป็นพรอมป์ Slack-native Block Kit ได้
• channels.slack.execApprovals.* ยังคงเป็นการเปิดใช้งานไคลเอนต์อนุมัติ exec แบบเนทีฟและคอนฟิกการกำหนดเส้นทาง DM/ช่องทาง
• DM การอนุมัติ Exec ใช้ channels.slack.execApprovals.approvers หรือ commands.ownerAllowFrom
• การอนุมัติ Plugin ใช้ปุ่ม Slack-native เมื่อ Slack ถูกเปิดใช้งานเป็นไคลเอนต์อนุมัติแบบเนทีฟสำหรับเซสชันต้นทาง หรือเมื่อ approvals.plugin กำหนดเส้นทางไปยังเซสชัน Slack ต้นทางหรือเป้าหมาย Slack
• DM การอนุมัติ Plugin ใช้ผู้อนุมัติ Plugin ของ Slack จาก channels.slack.allowFrom, allowFrom ของบัญชีที่ตั้งชื่อไว้ หรือเส้นทางเริ่มต้นของบัญชี
• การให้สิทธิ์ผู้อนุมัติยังคงถูกบังคับใช้: ผู้อนุมัติแบบ exec-only ไม่สามารถอนุมัติคำขอ Plugin ได้ เว้นแต่จะเป็นผู้อนุมัติ Plugin ด้วย

สิ่งนี้ใช้พื้นผิวปุ่มอนุมัติที่ใช้ร่วมกันเดียวกับช่องทางอื่น เมื่อเปิดใช้งาน interactivity ในการตั้งค่าแอป Slack ของคุณ พรอมป์การอนุมัติจะแสดงผลเป็นปุ่ม Block Kit โดยตรงในการสนทนา เมื่อมีปุ่มเหล่านั้น ปุ่มเหล่านั้นคือ UX การอนุมัติหลัก; OpenClaw ควรรวมคำสั่ง /approve แบบแมนนวลเฉพาะเมื่อผลลัพธ์ของเครื่องมือบอกว่าการอนุมัติผ่านแชต ไม่พร้อมใช้งาน หรือการอนุมัติแบบแมนนวลเป็นเส้นทางเดียวเท่านั้น

เส้นทางคอนฟิก:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (ไม่บังคับ; ถอยกลับไปใช้ commands.ownerAllowFrom เมื่อทำได้)
• channels.slack.execApprovals.target (dm | channel | both, ค่าเริ่มต้น: dm)
• agentFilter, sessionFilter

Slack จะเปิดใช้งานการอนุมัติ exec แบบเนทีฟโดยอัตโนมัติเมื่อไม่ได้ตั้งค่า enabled หรือเป็น "auto" และมี ผู้อนุมัติ exec อย่างน้อยหนึ่งรายที่ resolve ได้ Slack ยังสามารถจัดการการอนุมัติ Plugin แบบเนทีฟผ่านเส้นทาง native-client นี้เมื่อผู้อนุมัติ Plugin ของ Slack resolve ได้ และคำขอตรงกับตัวกรอง native-client ตั้งค่า enabled: false เพื่อปิดใช้งาน Slack เป็นไคลเอนต์อนุมัติแบบเนทีฟอย่างชัดเจน ตั้งค่า enabled: true เพื่อ บังคับเปิดการอนุมัติแบบเนทีฟเมื่อผู้อนุมัติ resolve ได้ การปิดใช้งานการอนุมัติ exec ของ Slack จะไม่ปิดใช้งาน การส่งการอนุมัติ Plugin แบบเนทีฟของ Slack ที่เปิดใช้งานผ่าน approvals.plugin; การส่งการอนุมัติ Plugin ใช้ผู้อนุมัติ Plugin ของ Slack แทน

พฤติกรรมเริ่มต้นเมื่อไม่มีคอนฟิกการอนุมัติ exec ของ Slack อย่างชัดเจน:

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

จำเป็นต้องใช้คอนฟิก Slack-native อย่างชัดเจนเฉพาะเมื่อคุณต้องการแทนที่ผู้อนุมัติ เพิ่มตัวกรอง หรือ เลือกใช้การส่งไปยังแชตต้นทาง:

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

การส่งต่อ approvals.exec ที่ใช้ร่วมกันเป็นคนละส่วนกัน ใช้เฉพาะเมื่อพรอมป์การอนุมัติ exec ต้อง กำหนดเส้นทางไปยังแชตอื่นหรือเป้าหมาย out-of-band ที่ระบุอย่างชัดเจนด้วย การส่งต่อ approvals.plugin ที่ใช้ร่วมกันก็ เป็นคนละส่วนเช่นกัน; การส่งแบบเนทีฟของ Slack จะระงับ fallback นั้นเฉพาะเมื่อ Slack สามารถจัดการ คำขออนุมัติ Plugin แบบเนทีฟได้

/approve ในแชตเดียวกันยังทำงานได้ในช่องทาง Slack และ DM ที่รองรับคำสั่งอยู่แล้ว ดู การอนุมัติ Exec สำหรับโมเดลการส่งต่อการอนุมัติทั้งหมด

เหตุการณ์และพฤติกรรมการปฏิบัติงาน

• การแก้ไข/ลบข้อความจะถูกแมปเป็นเหตุการณ์ระบบ
• การออกอากาศเธรด (การตอบกลับเธรดแบบ "Also send to channel") จะถูกประมวลผลเป็นข้อความผู้ใช้ปกติ
• เหตุการณ์เพิ่ม/ลบ reaction จะถูกแมปเป็นเหตุการณ์ระบบ
• เหตุการณ์สมาชิกเข้าร่วม/ออก, สร้าง/เปลี่ยนชื่อช่องทาง และเพิ่ม/ลบ pin จะถูกแมปเป็นเหตุการณ์ระบบ
• channel_id_changed สามารถย้ายคีย์คอนฟิกช่องทางเมื่อเปิดใช้งาน configWrites
• เมตาดาต้า topic/purpose ของช่องทางถือเป็นบริบทที่ไม่น่าเชื่อถือ และสามารถถูกฉีดเข้าไปในบริบทการกำหนดเส้นทางได้
• การ seed บริบทตัวเริ่มเธรดและประวัติเธรดเริ่มต้นจะถูกกรองด้วย allowlist ผู้ส่งที่กำหนดไว้เมื่อเกี่ยวข้อง
• Block actions, shortcuts และการโต้ตอบ modal จะปล่อยเหตุการณ์ระบบ Slack interaction: ... แบบมีโครงสร้างพร้อมฟิลด์เพย์โหลดที่ละเอียด:
  • block actions: ค่าที่เลือก, ป้ายกำกับ, ค่าตัวเลือก และเมตาดาต้า workflow_*
  • global shortcuts: เมตาดาต้าคอลแบ็กและผู้กระทำ ถูกกำหนดเส้นทางไปยังเซสชันตรงของผู้กระทำ
  • message shortcuts: บริบทคอลแบ็ก, ผู้กระทำ, ช่องทาง, เธรด และข้อความที่เลือก
  • เหตุการณ์ modal view_submission และ view_closed พร้อมเมตาดาต้าช่องทางที่กำหนดเส้นทางแล้วและอินพุตฟอร์ม

กำหนด global หรือ message shortcuts ในคอนฟิกแอป Slack ของคุณ และใช้ callback ID ใดก็ได้ที่ไม่ว่าง OpenClaw จะตอบรับเพย์โหลด shortcut ที่ตรงกัน ใช้นโยบายผู้ส่ง DM/ช่องทางเดียวกับการโต้ตอบ Slack อื่น และจัดคิวเหตุการณ์ที่ล้างข้อมูลแล้วสำหรับเซสชัน agent ที่กำหนดเส้นทาง Trigger IDs และ response URLs จะถูกลบออกจากบริบทของ agent

ข้อมูลอ้างอิงคอนฟิก

ข้อมูลอ้างอิงหลัก: ข้อมูลอ้างอิงคอนฟิก - Slack

การแก้ไขปัญหา

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

ข้อมูลอ้างอิงวิชันของไฟล์แนบ

Slack สามารถแนบสื่อที่ดาวน์โหลดแล้วเข้ากับเทิร์นของเอเจนต์เมื่อการดาวน์โหลดไฟล์ Slack สำเร็จและขีดจำกัดขนาดอนุญาต ไฟล์รูปภาพสามารถส่งผ่านเส้นทางการเข้าใจสื่อหรือส่งตรงไปยังโมเดลตอบกลับที่รองรับวิชันได้ ส่วนไฟล์อื่นจะถูกเก็บไว้เป็นบริบทไฟล์ที่ดาวน์โหลดได้ แทนที่จะถือเป็นอินพุตรูปภาพ

ประเภทสื่อที่รองรับ

ไปป์ไลน์ขาเข้า

เมื่อข้อความ Slack ที่มีไฟล์แนบมาถึง:

1. OpenClaw ดาวน์โหลดไฟล์จาก URL ส่วนตัวของ Slack โดยใช้โทเค็นบอท
2. ไฟล์ถูกเขียนไปยังที่เก็บสื่อเมื่อสำเร็จ
3. เส้นทางสื่อที่ดาวน์โหลดแล้วและประเภทเนื้อหาถูกเพิ่มลงในบริบทขาเข้า
4. เส้นทางโมเดล/เครื่องมือที่รองรับรูปภาพสามารถใช้ไฟล์แนบรูปภาพจากบริบทนั้นได้
5. ไฟล์ที่ไม่ใช่รูปภาพยังคงพร้อมใช้งานเป็นเมทาดาทาไฟล์หรือการอ้างอิงสื่อสำหรับเครื่องมือที่จัดการได้

การสืบทอดไฟล์แนบจากรากเธรด

เมื่อข้อความมาถึงในเธรด (มีพาเรนต์ thread_ts):

• หากการตอบกลับเองไม่มีสื่อโดยตรงและข้อความรากที่รวมมามีไฟล์ Slack สามารถเติมไฟล์รากเป็นบริบทตัวเริ่มเธรดได้
• ไฟล์แนบของการตอบกลับโดยตรงมีลำดับความสำคัญเหนือไฟล์แนบของข้อความราก
• ข้อความรากที่มีเฉพาะไฟล์และไม่มีข้อความจะแสดงด้วย placeholder ของไฟล์แนบ เพื่อให้ fallback ยังคงรวมไฟล์ของข้อความนั้นได้

การจัดการไฟล์แนบหลายรายการ

เมื่อข้อความ Slack เดียวมีไฟล์แนบหลายไฟล์:

• ไฟล์แนบแต่ละรายการถูกประมวลผลอย่างอิสระผ่านไปป์ไลน์สื่อ
• การอ้างอิงสื่อที่ดาวน์โหลดแล้วถูกรวบรวมไว้ในบริบทข้อความ
• ลำดับการประมวลผลเป็นไปตามลำดับไฟล์ของ Slack ในเพย์โหลดเหตุการณ์
• ความล้มเหลวในการดาวน์โหลดไฟล์แนบหนึ่งรายการไม่บล็อกไฟล์อื่น

ขีดจำกัดขนาด การดาวน์โหลด และโมเดล

• ขีดจำกัดขนาด: ค่าเริ่มต้น 20 MB ต่อไฟล์ กำหนดค่าได้ผ่าน channels.slack.mediaMaxMb
• ความล้มเหลวในการดาวน์โหลด: ไฟล์ที่ Slack ให้บริการไม่ได้, URL หมดอายุ, ไฟล์ที่เข้าถึงไม่ได้, ไฟล์ขนาดเกิน และการตอบกลับ HTML สำหรับ auth/login ของ Slack จะถูกข้าม แทนที่จะถูกรายงานว่าเป็นรูปแบบที่ไม่รองรับ
• โมเดลวิชัน: การวิเคราะห์รูปภาพใช้โมเดลตอบกลับที่ใช้งานอยู่เมื่อรองรับวิชัน หรือโมเดลรูปภาพที่กำหนดค่าไว้ที่ agents.defaults.imageModel

ขีดจำกัดที่ทราบ

เอกสารที่เกี่ยวข้อง

• ไปป์ไลน์การเข้าใจสื่อ
• เครื่องมือ PDF
• Epic: #51349 — การเปิดใช้วิชันสำหรับไฟล์แนบ Slack
• การทดสอบรีเกรสชัน: #51353
• การตรวจสอบแบบสด: #51354

ที่เกี่ยวข้อง