Slack

Sẵn sàng cho production với DM và kênh thông qua tích hợp ứng dụng Slack. Chế độ mặc định là Socket Mode; URL yêu cầu HTTP cũng được hỗ trợ. Chế độ relay dành cho các triển khai được quản lý, nơi một router đáng tin cậy sở hữu luồng vào Slack.

Chọn Socket Mode hoặc URL yêu cầu HTTP

Cả hai transport đều sẵn sàng cho production và đạt tương đương tính năng cho nhắn tin, lệnh slash, App Home và tương tác. Hãy chọn theo mô hình triển khai, không phải theo tính năng.

Chế độ relay

Chế độ relay tách luồng vào Slack khỏi gateway OpenClaw. Một router đáng tin cậy sở hữu kết nối Slack Socket Mode duy nhất, chọn gateway đích và chuyển tiếp một sự kiện có kiểu qua websocket đã xác thực. Gateway tiếp tục dùng bot token của nó cho các lệnh gọi 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 phải dùng wss:// trừ khi trỏ tới localhost. Hãy xem bearer token và bảng route của router là một phần của ranh giới ủy quyền Slack: các sự kiện được định tuyến đi vào handler tin nhắn Slack thông thường như các kích hoạt đã được ủy quyền. slack_identity do router cung cấp trong frame websocket hello có thể đặt tên người dùng và biểu tượng outbound mặc định; danh tính rõ ràng do caller cung cấp vẫn được ưu tiên. Kết nối relay kết nối lại với cùng thời gian backoff có giới hạn như Socket Mode và xóa danh tính do router cung cấp mỗi khi ngắt kết nối.

Cài đặt

Cài đặt Slack trước khi cấu hình kênh:

openclaw plugins install @openclaw/slack

plugins install đăng ký và bật Plugin. Plugin vẫn không làm gì cho đến khi bạn cấu hình ứng dụng Slack và cài đặt kênh bên dưới. Xem Plugin để biết hành vi Plugin chung và quy tắc cài đặt.

Thiết lập nhanh

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

Tinh chỉnh truyền tải Socket Mode

OpenClaw đặt thời gian chờ pong của ứng dụng khách Slack SDK mặc định là 15 giây cho Socket Mode. Chỉ ghi đè các thiết lập truyền tải khi bạn cần tinh chỉnh theo workspace hoặc máy chủ cụ thể:

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

Chỉ dùng thiết lập này cho các workspace Socket Mode ghi nhật ký timeout pong/server-ping của websocket Slack hoặc chạy trên các máy chủ đã biết có tình trạng thiếu hụt event loop. clientPingTimeout là thời gian chờ pong sau khi SDK gửi client ping; serverPingTimeout là thời gian chờ ping từ máy chủ Slack. Tin nhắn và sự kiện của ứng dụng vẫn là trạng thái ứng dụng, không phải tín hiệu về trạng thái sống của truyền tải.

Ghi chú:

• socketMode bị bỏ qua trong chế độ HTTP Request URL.
• Các thiết lập channels.slack.socketMode cơ sở áp dụng cho tất cả tài khoản Slack trừ khi bị ghi đè. Ghi đè theo tài khoản dùng channels.slack.accounts.<accountId>.socketMode; vì đây là ghi đè đối tượng, hãy bao gồm mọi trường tinh chỉnh socket bạn muốn cho tài khoản đó.
• Chỉ clientPingTimeout có mặc định của OpenClaw (15000). serverPingTimeout và pingPongLoggingEnabled chỉ được truyền cho Slack SDK khi được cấu hình.
• Backoff khởi động lại Socket Mode bắt đầu khoảng 2 giây và giới hạn khoảng 30 giây. Các lỗi khởi động, chờ khởi động và ngắt kết nối có thể khôi phục sẽ thử lại cho đến khi kênh dừng. Các lỗi tài khoản và thông tin xác thực vĩnh viễn như xác thực không hợp lệ, token bị thu hồi hoặc thiếu phạm vi sẽ thất bại nhanh thay vì thử lại mãi mãi.

Danh sách kiểm tra manifest và phạm vi

Manifest ứng dụng Slack cơ sở giống nhau cho Socket Mode và HTTP Request URLs. Chỉ khối settings (và url của lệnh slash) là khác.

Manifest cơ sở (mặc định 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"      ]    }  }}

Đối với chế độ HTTP Request URLs, thay settings bằng biến thể HTTP và thêm url vào từng lệnh slash. Bắt buộc có URL công khai:

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

Thiết lập manifest bổ sung

Hiển thị các tính năng khác mở rộng các mặc định ở trên.

Manifest mặc định bật thẻ Home trong Slack App Home và đăng ký app_home_opened. Khi một thành viên workspace mở thẻ Home, OpenClaw phát hành một chế độ xem Home mặc định an toàn bằng views.publish; không có payload hội thoại hay cấu hình riêng tư nào được đưa vào. Thẻ Messages vẫn được bật cho Slack DM. Manifest cũng bật các luồng trợ lý Slack bằng features.assistant_view, assistant:write, assistant_thread_started và assistant_thread_context_changed; các luồng trợ lý được định tuyến tới phiên luồng OpenClaw riêng và giữ ngữ cảnh luồng do Slack cung cấp để agent sử dụng.

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

Mô hình token

• botToken + appToken là bắt buộc đối với Socket Mode.
• Chế độ HTTP yêu cầu botToken + signingSecret.
• Chế độ Relay yêu cầu botToken cùng với relay.url, relay.authToken và relay.gatewayId; chế độ này không dùng app token hay signing secret.
• botToken, appToken, signingSecret, relay.authToken và userToken chấp nhận chuỗi văn bản thuần hoặc đối tượng SecretRef.
• Token cấu hình ghi đè env fallback.
• Env fallback SLACK_BOT_TOKEN / SLACK_APP_TOKEN chỉ áp dụng cho tài khoản mặc định.
• userToken chỉ có trong cấu hình (không có env fallback) và mặc định là hành vi chỉ đọc (userTokenReadOnly: true).

Hành vi ảnh chụp trạng thái:

• Việc kiểm tra tài khoản Slack theo dõi các trường *Source và *Status theo từng thông tin xác thực (botToken, appToken, signingSecret, userToken).
• Trạng thái là available, configured_unavailable hoặc missing.
• configured_unavailable nghĩa là tài khoản được cấu hình thông qua SecretRef hoặc một nguồn bí mật không inline khác, nhưng đường dẫn lệnh/runtime hiện tại không thể phân giải giá trị thực tế.
• Trong chế độ HTTP, signingSecretStatus được đưa vào; trong Socket Mode, cặp bắt buộc là botTokenStatus + appTokenStatus.

Hành động và cổng kiểm soát

Các hành động Slack được kiểm soát bởi channels.slack.actions.*.

Các nhóm hành động có sẵn trong công cụ Slack hiện tại:

Các hành động tin nhắn Slack hiện tại bao gồm send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info và emoji-list. download-file chấp nhận ID tệp Slack được hiển thị trong placeholder tệp đầu vào và trả về bản xem trước hình ảnh cho hình ảnh hoặc siêu dữ liệu tệp cục bộ cho các loại tệp khác.

Kiểm soát truy cập và định tuyến

Luồng thảo luận, phiên và thẻ trả lời

• DM định tuyến là direct; kênh là channel; MPIM là group.
• Ràng buộc tuyến Slack chấp nhận ID đối tượng thô cùng các dạng mục tiêu Slack như channel:C12345678, user:U12345678 và <@U12345678>.
• Với mặc định session.dmScope=main, DM Slack được gộp vào phiên chính của tác nhân.
• Phiên kênh: agent:<agentId>:slack:channel:<channelId>.
• Tin nhắn kênh cấp cao nhất thông thường vẫn nằm trong phiên theo kênh, ngay cả khi replyToMode không phải off.
• Trả lời trong luồng Slack dùng thread_ts Slack của cha cho hậu tố phiên (:thread:<threadTs>), ngay cả khi luồng trả lời gửi ra bị tắt bằng replyToMode="off".
• OpenClaw gieo một gốc kênh cấp cao nhất đủ điều kiện vào agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> khi gốc đó dự kiến sẽ bắt đầu một luồng Slack hiển thị, để gốc và các trả lời luồng sau này dùng chung một phiên OpenClaw. Điều này áp dụng cho sự kiện app_mention, khớp đề cập bot rõ ràng hoặc mẫu đề cập đã cấu hình, và các kênh requireMention: false có replyToMode không phải off.
• Mặc định của channels.slack.thread.historyScope là thread; mặc định của thread.inheritParent là false.
• channels.slack.thread.initialHistoryLimit kiểm soát số lượng tin nhắn luồng hiện có được lấy khi một phiên luồng mới bắt đầu (mặc định 20; đặt 0 để tắt).
• channels.slack.thread.requireExplicitMention (mặc định false): khi true, chặn đề cập luồng ngầm định để bot chỉ phản hồi các đề cập @bot rõ ràng bên trong luồng, ngay cả khi bot đã tham gia luồng. Nếu không có tùy chọn này, các trả lời trong luồng có bot tham gia sẽ bỏ qua cổng requireMention.

Điều khiển luồng trả lời:

• channels.slack.replyToMode: off|first|all|batched (mặc định off)
• channels.slack.replyToModeByChatType: theo từng direct|group|channel
• dự phòng cũ cho trò chuyện trực tiếp: channels.slack.dm.replyToMode

Hỗ trợ thẻ trả lời thủ công:

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

Đối với trả lời luồng Slack rõ ràng từ công cụ message, đặt replyBroadcast: true với action: "send" và threadId hoặc replyTo để yêu cầu Slack cũng phát trả lời luồng tới kênh cha. Điều này ánh xạ tới cờ reply_broadcast của Slack chat.postMessage và chỉ được hỗ trợ cho gửi văn bản hoặc Block Kit, không hỗ trợ tải lên phương tiện.

Khi một lệnh gọi công cụ message chạy bên trong luồng Slack và nhắm tới cùng kênh, OpenClaw thường kế thừa luồng Slack hiện tại theo replyToMode. Đặt topLevel: true trên action: "send" hoặc action: "upload-file" để buộc tạo tin nhắn mới ở kênh cha. threadId: null được chấp nhận như cùng một cách chọn không tham gia cấp cao nhất.

Phản ứng xác nhận

ackReaction gửi một emoji xác nhận trong khi OpenClaw đang xử lý tin nhắn đi vào. ackReactionScope quyết định khi nào emoji đó thực sự được gửi.

Emoji (ackReaction)

Thứ tự phân giải:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• dự phòng emoji danh tính tác nhân (agents.list[].identity.emoji, nếu không thì "eyes" / 👀)

Ghi chú:

• Slack kỳ vọng mã ngắn (ví dụ "eyes").
• Dùng "" để tắt phản ứng cho tài khoản Slack hoặc toàn cục.

Phạm vi (messages.ackReactionScope)

Nhà cung cấp Slack đọc phạm vi từ messages.ackReactionScope (mặc định "group-mentions"). Hiện không có ghi đè ở cấp tài khoản Slack hoặc kênh Slack; giá trị này là toàn cục cho Gateway.

Giá trị:

• "all": phản ứng trong DM và nhóm.
• "direct": chỉ phản ứng trong DM.
• "group-all": phản ứng trên mọi tin nhắn nhóm (không có DM).
• "group-mentions" (mặc định): phản ứng trong nhóm, nhưng chỉ khi bot được đề cập (hoặc trong các mục có thể được đề cập trong nhóm đã chọn tham gia). DM bị loại trừ.
• "off" / "none": không bao giờ phản ứng.

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

Phát trực tuyến văn bản

channels.slack.streaming kiểm soát hành vi xem trước trực tiếp:

• off: tắt phát trực tuyến bản xem trước trực tiếp.
• partial (mặc định): thay văn bản xem trước bằng đầu ra từng phần mới nhất.
• block: nối thêm các bản cập nhật xem trước theo khối.
• progress: hiển thị văn bản trạng thái tiến trình trong khi tạo, rồi gửi văn bản cuối cùng.
• streaming.preview.toolProgress: khi bản xem trước nháp đang hoạt động, định tuyến các cập nhật công cụ/tiến trình vào cùng tin nhắn xem trước đã chỉnh sửa (mặc định: true). Đặt false để giữ các tin nhắn công cụ/tiến trình riêng.
• streaming.preview.commandText / streaming.progress.commandText: đặt thành status để giữ các dòng tiến trình công cụ gọn trong khi ẩn văn bản lệnh/thực thi thô (mặc định: raw).

Ẩn văn bản lệnh/thực thi thô trong khi giữ các dòng tiến trình gọn:

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

channels.slack.streaming.nativeTransport kiểm soát phát trực tuyến văn bản gốc của Slack khi channels.slack.streaming.mode là partial (mặc định: true).

Thẻ tác vụ tiến trình gốc của Slack là tùy chọn tham gia cho chế độ tiến trình. Đặt channels.slack.streaming.progress.nativeTaskCards thành true với channels.slack.streaming.mode="progress" để gửi thẻ kế hoạch/tác vụ gốc Slack trong khi công việc đang chạy, rồi cập nhật cùng thẻ tác vụ đó khi hoàn tất. Nếu không có cờ này, chế độ tiến trình giữ hành vi xem trước nháp di động.

• Phải có luồng trả lời để phát trực tuyến văn bản gốc và trạng thái luồng Slack assistant xuất hiện. Việc chọn luồng vẫn theo replyToMode.
• Gốc kênh, trò chuyện nhóm và DM cấp cao nhất vẫn có thể dùng bản xem trước nháp bình thường khi phát trực tuyến gốc không khả dụng hoặc không tồn tại luồng trả lời.
• DM Slack cấp cao nhất mặc định nằm ngoài luồng, nên chúng không hiển thị bản xem trước luồng/trạng thái gốc kiểu luồng của Slack; thay vào đó OpenClaw đăng và chỉnh sửa bản xem trước nháp trong DM.
• Phương tiện và tải trọng không phải văn bản quay về cơ chế gửi bình thường.
• Kết quả cuối cùng là phương tiện/lỗi sẽ hủy các chỉnh sửa xem trước đang chờ; kết quả cuối cùng dạng văn bản/khối đủ điều kiện chỉ được xả khi có thể chỉnh sửa trực tiếp bản xem trước.
• Nếu phát trực tuyến thất bại giữa chừng khi trả lời, OpenClaw quay về cơ chế gửi bình thường cho các tải trọng còn lại.

Dùng bản xem trước nháp thay vì phát trực tuyến văn bản gốc Slack:

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

Chọn tham gia thẻ tác vụ tiến trình gốc Slack:

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

Khóa cũ:

• channels.slack.streamMode (replace | status_final | append) là bí danh runtime cũ cho channels.slack.streaming.mode.
• boolean channels.slack.streaming là bí danh runtime cũ cho channels.slack.streaming.mode và channels.slack.streaming.nativeTransport.
• channels.slack.nativeStreaming cũ là bí danh runtime cho channels.slack.streaming.nativeTransport.
• Chạy openclaw doctor --fix để ghi lại cấu hình phát trực tuyến Slack đã lưu thành các khóa chuẩn.

Dự phòng phản ứng đang nhập

typingReaction thêm một phản ứng tạm thời vào tin nhắn Slack đi vào trong khi OpenClaw đang xử lý trả lời, rồi xóa phản ứng đó khi lượt chạy kết thúc. Tùy chọn này hữu ích nhất bên ngoài các trả lời theo luồng, vốn dùng chỉ báo trạng thái mặc định "đang nhập...".

Thứ tự phân giải:

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

Ghi chú:

• Slack kỳ vọng mã ngắn (ví dụ "hourglass_flowing_sand").
• Phản ứng được thực hiện theo khả năng tốt nhất và quá trình dọn dẹp được tự động thử sau khi trả lời hoặc đường dẫn thất bại hoàn tất.

Phương tiện, chia khúc và gửi

Lệnh và hành vi dấu gạch chéo

Lệnh dấu gạch chéo xuất hiện trong Slack dưới dạng một lệnh đã cấu hình duy nhất hoặc nhiều lệnh gốc. Cấu hình channels.slack.slashCommand để thay đổi mặc định lệnh:

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

/openclaw /help

Lệnh gốc yêu cầu cài đặt manifest bổ sung trong ứng dụng Slack của bạn và được bật bằng channels.slack.commands.native: true hoặc commands.native: true trong cấu hình toàn cục.

• Chế độ tự động lệnh gốc đang tắt cho Slack, nên commands.native: "auto" không bật lệnh gốc Slack.

/help

Menu đối số gốc dùng chiến lược render thích ứng, hiển thị modal xác nhận trước khi gửi giá trị tùy chọn đã chọn:

• tối đa 5 tùy chọn: khối nút
• 6-100 tùy chọn: menu chọn tĩnh
• hơn 100 tùy chọn: chọn bên ngoài với lọc tùy chọn bất đồng bộ khi có trình xử lý tùy chọn tương tác
• vượt quá giới hạn Slack: giá trị tùy chọn đã mã hóa quay về nút

/think

Các phiên slash dùng khóa cô lập như agent:<agentId>:slack:slash:<userId> và vẫn định tuyến việc thực thi lệnh đến phiên hội thoại đích bằng CommandTargetSessionKey.

Phản hồi tương tác

Slack có thể kết xuất các điều khiển phản hồi tương tác do agent tạo, nhưng tính năng này bị tắt theo mặc định. Với đầu ra mới từ agent, CLI và Plugin, hãy ưu tiên các nút presentation dùng chung hoặc các khối chọn. Chúng dùng cùng đường dẫn tương tác Slack đồng thời vẫn suy giảm phù hợp trên các kênh khác.

Bật trên toàn cục:

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

Hoặc chỉ bật cho một tài khoản Slack:

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

Khi được bật, agent vẫn có thể phát ra các chỉ thị phản hồi chỉ dành cho Slack đã không còn được khuyến nghị:

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

Các chỉ thị này được biên dịch thành Slack Block Kit và định tuyến lượt nhấp hoặc lựa chọn trở lại qua đường dẫn sự kiện tương tác Slack hiện có. Giữ chúng cho các prompt cũ và các lối thoát riêng cho Slack; dùng presentation dùng chung cho các điều khiển di động mới.

Các API biên dịch chỉ thị cũng không còn được khuyến nghị cho mã producer mới:

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

Dùng payload presentation và buildSlackPresentationBlocks(...) cho các điều khiển mới được Slack kết xuất.

Ghi chú:

• Đây là UI kế thừa riêng cho Slack. Các kênh khác không chuyển dịch chỉ thị Slack Block Kit thành hệ thống nút riêng của chúng.
• Các giá trị callback tương tác là token mờ do OpenClaw tạo, không phải giá trị thô do agent tạo.
• Nếu các khối tương tác được tạo vượt quá giới hạn Slack Block Kit, OpenClaw sẽ quay về phản hồi văn bản gốc thay vì gửi payload khối không hợp lệ.

Gửi modal do Plugin sở hữu

Các Plugin Slack đăng ký trình xử lý tương tác cũng có thể nhận các sự kiện vòng đời modal view_submission và view_closed trước khi OpenClaw nén payload cho sự kiện hệ thống hiển thị với agent. Dùng một trong các mẫu định tuyến này khi mở modal Slack:

• Đặt callback_id thành openclaw:<namespace>:<payload>.
• Hoặc giữ callback_id hiện có và đặt pluginInteractiveData: "<namespace>:<payload>" trong private_metadata của modal.

Trình xử lý nhận ctx.interaction.kind là view_submission hoặc view_closed, inputs đã chuẩn hóa, và toàn bộ đối tượng stateValues thô từ Slack. Chỉ định tuyến bằng callback ID là đủ để gọi trình xử lý Plugin; hãy bao gồm các trường định tuyến người dùng/phiên private_metadata hiện có của modal khi modal cũng cần tạo sự kiện hệ thống hiển thị với agent. Agent nhận một sự kiện hệ thống Slack interaction: ... gọn, đã biên tập. Nếu trình xử lý trả về systemEvent.summary, systemEvent.reference, hoặc systemEvent.data, các trường đó được đưa vào sự kiện gọn đó để agent có thể tham chiếu bộ nhớ do Plugin sở hữu mà không thấy toàn bộ payload biểu mẫu.

Phê duyệt gốc trong Slack

Slack có thể hoạt động như một ứng dụng phê duyệt gốc với các nút và tương tác, thay vì quay về Web UI hoặc terminal.

• Phê duyệt exec và Plugin có thể kết xuất dưới dạng prompt Slack-native Block Kit.
• channels.slack.execApprovals.* vẫn là cấu hình bật ứng dụng phê duyệt exec gốc và định tuyến DM/kênh.
• DM phê duyệt exec dùng channels.slack.execApprovals.approvers hoặc commands.ownerAllowFrom.
• Phê duyệt Plugin dùng nút Slack-native khi Slack được bật làm ứng dụng phê duyệt gốc cho phiên khởi tạo, hoặc khi approvals.plugin định tuyến đến phiên Slack khởi tạo hoặc một đích Slack.
• DM phê duyệt Plugin dùng người phê duyệt Plugin Slack từ channels.slack.allowFrom, allowFrom theo tài khoản được đặt tên, hoặc tuyến mặc định của tài khoản.
• Ủy quyền người phê duyệt vẫn được thực thi: người phê duyệt chỉ dành cho exec không thể phê duyệt yêu cầu Plugin trừ khi họ cũng là người phê duyệt Plugin.

Cơ chế này dùng cùng bề mặt nút phê duyệt dùng chung như các kênh khác. Khi interactivity được bật trong cài đặt ứng dụng Slack của bạn, prompt phê duyệt kết xuất trực tiếp trong cuộc hội thoại dưới dạng nút Block Kit. Khi các nút đó xuất hiện, chúng là UX phê duyệt chính; OpenClaw chỉ nên bao gồm lệnh /approve thủ công khi kết quả công cụ cho biết phê duyệt qua chat không khả dụng hoặc phê duyệt thủ công là đường dẫn duy nhất.

Đường dẫn cấu hình:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (tùy chọn; quay về commands.ownerAllowFrom khi có thể)
• channels.slack.execApprovals.target (dm | channel | both, mặc định: dm)
• agentFilter, sessionFilter

Slack tự động bật phê duyệt exec gốc khi enabled chưa được đặt hoặc là "auto" và phân giải được ít nhất một người phê duyệt exec. Slack cũng có thể xử lý phê duyệt Plugin gốc qua đường dẫn ứng dụng gốc này khi người phê duyệt Plugin Slack được phân giải và yêu cầu khớp với các bộ lọc ứng dụng gốc. Đặt enabled: false để tắt rõ ràng Slack làm ứng dụng phê duyệt gốc. Đặt enabled: true để bắt buộc bật phê duyệt gốc khi người phê duyệt được phân giải. Việc tắt phê duyệt exec Slack không tắt việc gửi phê duyệt Plugin Slack gốc được bật qua approvals.plugin; việc gửi phê duyệt Plugin dùng người phê duyệt Plugin Slack thay thế.

Hành vi mặc định khi không có cấu hình phê duyệt exec Slack rõ ràng:

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

Cấu hình Slack-native rõ ràng chỉ cần thiết khi bạn muốn ghi đè người phê duyệt, thêm bộ lọc, hoặc chọn tham gia gửi đến chat khởi nguồn:

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

Chuyển tiếp approvals.exec dùng chung là riêng biệt. Chỉ dùng khi prompt phê duyệt exec cũng phải định tuyến đến các cuộc chat khác hoặc các đích ngoài băng rõ ràng. Chuyển tiếp approvals.plugin dùng chung cũng riêng biệt; gửi gốc của Slack chỉ chặn đường dự phòng đó khi Slack có thể xử lý yêu cầu phê duyệt Plugin theo cách gốc.

/approve trong cùng chat cũng hoạt động trong các kênh Slack và DM đã hỗ trợ lệnh. Xem Phê duyệt exec để biết đầy đủ mô hình chuyển tiếp phê duyệt.

Sự kiện và hành vi vận hành

• Chỉnh sửa/xóa tin nhắn được ánh xạ thành sự kiện hệ thống.
• Phát sóng chuỗi thảo luận (phản hồi chuỗi thảo luận "Also send to channel") được xử lý như tin nhắn người dùng bình thường.
• Sự kiện thêm/xóa phản ứng được ánh xạ thành sự kiện hệ thống.
• Sự kiện thành viên tham gia/rời đi, kênh được tạo/đổi tên, và thêm/xóa ghim được ánh xạ thành sự kiện hệ thống.
• channel_id_changed có thể di chuyển khóa cấu hình kênh khi configWrites được bật.
• Siêu dữ liệu chủ đề/mục đích của kênh được xem là ngữ cảnh không đáng tin cậy và có thể được chèn vào ngữ cảnh định tuyến.
• Người bắt đầu chuỗi thảo luận và việc gieo ngữ cảnh lịch sử chuỗi ban đầu được lọc theo danh sách cho phép người gửi đã cấu hình khi áp dụng.
• Hành động khối, lối tắt và tương tác modal phát ra sự kiện hệ thống Slack interaction: ... có cấu trúc với các trường payload phong phú:
  • hành động khối: giá trị đã chọn, nhãn, giá trị bộ chọn, và siêu dữ liệu workflow_*
  • lối tắt toàn cục: siêu dữ liệu callback và actor, được định tuyến đến phiên trực tiếp của actor
  • lối tắt tin nhắn: callback, actor, kênh, chuỗi thảo luận, và ngữ cảnh tin nhắn đã chọn
  • sự kiện modal view_submission và view_closed với siêu dữ liệu kênh đã định tuyến và đầu vào biểu mẫu

Định nghĩa lối tắt toàn cục hoặc tin nhắn trong cấu hình ứng dụng Slack của bạn và dùng bất kỳ callback ID không rỗng nào. OpenClaw xác nhận các payload lối tắt khớp, áp dụng cùng chính sách người gửi DM/kênh như các tương tác Slack khác, và đưa sự kiện đã làm sạch vào hàng đợi cho phiên agent được định tuyến. Trigger ID và URL phản hồi được biên tập khỏi ngữ cảnh agent.

Tham chiếu cấu hình

Tham chiếu chính: Tham chiếu cấu hình - Slack.

Khắc phục sự cố

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Tham chiếu vision cho tệp đính kèm

Slack có thể đính kèm phương tiện đã tải xuống vào lượt tác tử khi tải xuống tệp Slack thành công và giới hạn kích thước cho phép. Tệp ảnh có thể được truyền qua đường dẫn hiểu phương tiện hoặc trực tiếp đến mô hình trả lời có khả năng vision; các tệp khác được giữ lại dưới dạng ngữ cảnh tệp có thể tải xuống thay vì được xử lý như đầu vào ảnh.

Loại phương tiện được hỗ trợ

Pipeline đầu vào

Khi một tin nhắn Slack có tệp đính kèm đến:

1. OpenClaw tải tệp xuống từ URL riêng tư của Slack bằng token bot.
2. Tệp được ghi vào kho phương tiện khi thành công.
3. Đường dẫn phương tiện đã tải xuống và loại nội dung được thêm vào ngữ cảnh đầu vào.
4. Các đường dẫn mô hình/công cụ có khả năng xử lý ảnh có thể dùng tệp đính kèm ảnh từ ngữ cảnh đó.
5. Tệp không phải ảnh vẫn khả dụng dưới dạng siêu dữ liệu tệp hoặc tham chiếu phương tiện cho các công cụ có thể xử lý chúng.

Kế thừa tệp đính kèm từ gốc chuỗi

Khi một tin nhắn đến trong một chuỗi (có cha thread_ts):

• Nếu bản thân câu trả lời không có phương tiện trực tiếp và tin nhắn gốc được bao gồm có tệp, Slack có thể hydrate các tệp gốc làm ngữ cảnh mở đầu chuỗi.
• Tệp đính kèm trực tiếp của câu trả lời được ưu tiên hơn tệp đính kèm của tin nhắn gốc.
• Tin nhắn gốc chỉ có tệp và không có văn bản được biểu diễn bằng một placeholder tệp đính kèm để fallback vẫn có thể bao gồm các tệp của nó.

Xử lý nhiều tệp đính kèm

Khi một tin nhắn Slack duy nhất chứa nhiều tệp đính kèm:

• Mỗi tệp đính kèm được xử lý độc lập qua pipeline phương tiện.
• Tham chiếu phương tiện đã tải xuống được tổng hợp vào ngữ cảnh tin nhắn.
• Thứ tự xử lý theo thứ tự tệp của Slack trong payload sự kiện.
• Lỗi tải xuống của một tệp đính kèm không chặn các tệp khác.

Giới hạn kích thước, tải xuống và mô hình

• Giới hạn kích thước: Mặc định 20 MB mỗi tệp. Có thể cấu hình qua channels.slack.mediaMaxMb.
• Lỗi tải xuống: Các tệp mà Slack không thể phục vụ, URL hết hạn, tệp không truy cập được, tệp quá kích thước, và phản hồi HTML xác thực/đăng nhập Slack sẽ bị bỏ qua thay vì được báo cáo là định dạng không được hỗ trợ.
• Mô hình vision: Phân tích ảnh dùng mô hình trả lời đang hoạt động khi mô hình đó hỗ trợ vision, hoặc mô hình ảnh được cấu hình tại agents.defaults.imageModel.

Giới hạn đã biết

Tài liệu liên quan

• Pipeline hiểu phương tiện
• Công cụ PDF
• Epic: #51349 — Bật vision cho tệp đính kèm Slack
• Kiểm thử hồi quy: #51353
• Xác minh trực tiếp: #51354

Liên quan