Slack

Sẵn sàng cho môi trường sản xuất với DM và kênh thông qua tích hợp ứng dụng Slack. Chế độ mặc định là Socket Mode; HTTP Request URLs cũng được hỗ trợ.

# Chọn Socket Mode hoặc HTTP Request URLs

Cả hai phương thức truyền tải đều sẵn sàng cho môi trường sản xuất và đạt ngang bằ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.

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

# Điều chỉnh truyền tải Socket Mode

OpenClaw đặt thời gian chờ pong của client Slack SDK mặc định là 15 giây cho Socket Mode. Chỉ ghi đè thiết lập truyền tải khi bạn cần điều chỉnh riêng cho không gian làm việc hoặc máy chủ:

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

Chỉ dùng thiết lập này cho các không gian làm việc Socket Mode ghi nhật ký lỗi hết thời gian chờ websocket pong/server-ping của Slack hoặc chạy trên các máy chủ đã biết có tình trạng nghẽn 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 ứ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.

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

Đối với chế độ HTTP Request URLs, thay settings bằng biến thể HTTP và thêm url vào mỗi 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",
        "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 nhau mở rộng các mặc định ở trên.

Manifest mặc định bật tab Home của Slack App Home và đăng ký app_home_opened. Khi một thành viên không gian làm việc mở tab Home, OpenClaw xuất bản một chế độ xem Home mặc định an toàn bằng views.publish; không bao gồm payload cuộc trò chuyện hoặc cấu hình riêng tư. Tab Messages vẫn được bật cho 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"
}
]
}

# Mô hình token

• botToken + appToken là bắt buộc đối với Socket Mode.
• Chế độ HTTP yêu cầu botToken + signingSecret.
• botToken, appToken, signingSecret và userToken chấp nhận chuỗi văn bản thuần hoặc đối tượng SecretRef.
• Token trong cấu hình ghi đè cơ chế dự phòng env.
• Cơ chế dự phòng env SLACK_BOT_TOKEN / SLACK_APP_TOKEN chỉ áp dụng cho tài khoản mặc định.
• userToken (xoxp-...) chỉ dùng trong cấu hình (không có cơ chế dự phòng env) và mặc định ở hành vi chỉ đọc (userTokenReadOnly: true).

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

• 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 qua SecretRef hoặc một nguồn bí mật không nội tuyến 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 bao gồm; trong Socket Mode, cặp bắt buộc là botTokenStatus + appTokenStatus.

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

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

Các nhóm hành động khả dụng 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 hiển thị trong placeholder tệp gửi đến và trả về bản xem trước hình ảnh cho ả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, phiên và thẻ trả lời

• DM định tuyến dưới dạng direct; kênh dưới dạng channel; MPIM dưới dạng group.
• Liên kết tuyến Slack chấp nhận ID peer thô cùng các dạng đích Slack như channel:C12345678, user:U12345678 và <@U12345678>.
• Với session.dmScope=main mặc định, DM Slack được gộp vào phiên chính của tác tử.
• Phiên kênh: agent:<agentId>:slack:channel:<channelId>.
• Trả lời luồng có thể tạo hậu tố phiên luồng (:thread:<threadTs>) khi áp dụng.
• 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 lượt nhắc luồng ngầm để bot chỉ phản hồi các lượt nhắc @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 mà bot đã tham gia sẽ bỏ qua cổng kiểm soát 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 cuộc trò chuyện trực tiếp: channels.slack.dm.replyToMode

Thẻ trả lời thủ công được hỗ trợ:

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

# 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 gửi đến.

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 tử (agents.list[].identity.emoji, nếu không thì "👀")

Ghi chú:

• Slack yêu cầu shortcode (ví dụ "eyes").
• Dùng "" để tắt phản ứng cho tài khoản Slack hoặc toàn cục.

# Truyền văn bản trực tuyến

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

• off: tắt truyền xem trước trực tiếp.
• partial (mặc định): thay thế 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 nháp xem trước đang hoạt động, định tuyến 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 truyền văn bản gốc của Slack khi channels.slack.streaming.mode là partial (mặc định: true).

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

Dùng bản nháp xem trước thay vì truyền văn bản gốc của Slack:

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

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 streaming Slack đã lưu sang 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 đến trong khi OpenClaw đang xử lý phản hồi, rồi gỡ bỏ 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 phản hồi theo luồng, vốn dùng chỉ báo trạng thái mặc định "is typing...".

Thứ tự phân giải:

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

Ghi chú:

• Slack yêu cầu shortcode (ví dụ "hourglass_flowing_sand").
• Phản ứng này là best-effort và việc dọn dẹp được tự động thử sau khi phản hồi hoặc đường dẫn lỗi hoàn tất.

# Phương tiện, chia đoạn và gửi

# Lệnh và hành vi slash

Lệnh slash 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 native. 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 native yêu cầu thiết lập 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 của lệnh native là tắt cho Slack nên commands.native: "auto" không bật lệnh native Slack.

/help

Menu đối số native dùng chiến lược hiển thị 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: block 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 async khi có handler tùy chọn interactivity
• vượt giới hạn Slack: giá trị tùy chọn đã mã hóa dùng lại nút

/think

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

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

Slack có thể hiển thị 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.

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 có thể phát ra các chỉ thị phản hồi chỉ dành cho Slack:

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

Ghi chú:

• Đây là UI dành riêng cho Slack. Các kênh khác không dịch chỉ thị Slack Block Kit thành hệ thống nút riêng của chúng.
• 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 block tương tác được tạo vượt quá giới hạn Slack Block Kit, OpenClaw dùng lại phản hồi văn bản gốc thay vì gửi payload block không hợp lệ.

# Phê duyệt exec trong Slack

Slack có thể hoạt động như một client phê duyệt native với các nút và tương tác, thay vì dùng lại Web UI hoặc terminal.

• Phê duyệt exec dùng channels.slack.execApprovals.* cho định tuyến native tới DM/kênh.
• Phê duyệt Plugin vẫn có thể phân giải qua cùng bề mặt nút Slack-native khi yêu cầu đã đến Slack và loại id phê duyệt là plugin:.
• Ủy quyền người phê duyệt vẫn được thực thi: chỉ người dùng được nhận diện là người phê duyệt mới có thể phê duyệt hoặc từ chối yêu cầu qua Slack.

Tính năng 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 thiết lập ứng dụng Slack của bạn, lời nhắc phê duyệt hiển thị dưới dạng nút Block Kit trực tiếp trong hội thoại. Khi các nút đó có mặt, 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 (không bắt buộc; dùng lại 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 native khi enabled không được đặt hoặc là "auto" và ít nhất một người phê duyệt phân giải được. Đặt enabled: false để tắt Slack làm client phê duyệt native một cách tường minh. Đặt enabled: true để ép bật phê duyệt native khi người phê duyệt phân giải được.

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

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

Cấu hình Slack-native tường minh 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 gửi tới chat gốc:

{
  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 lời nhắc phê duyệt exec cũng phải định tuyến tới các chat khác hoặc các đích ngoài băng tường minh. Chuyển tiếp approvals.plugin dùng chung cũng riêng biệt; nút Slack-native vẫn có thể phân giải phê duyệt Plugin khi các yêu cầu đó đã đến Slack.

/approve cùng chat cũng hoạt động trong 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.
• Broadcast luồng (phản hồi luồng "Also send to channel") được xử lý như tin nhắn người dùng bình thường.
• Sự kiện thêm/gỡ 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/gỡ 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.
• Metadata chủ đề/mục đích của kênh được xem là ngữ cảnh không đáng tin cậy và có thể được đưa vào ngữ cảnh định tuyến.
• Việc gieo ngữ cảnh thread starter và lịch sử luồng ban đầu được lọc theo danh sách cho phép người gửi đã cấu hình khi áp dụng.
• Block actions 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ú:
  • block actions: giá trị đã chọn, nhãn, giá trị picker và metadata workflow_*
  • sự kiện modal view_submission và view_closed với metadata kênh đã định tuyến và đầu vào biểu mẫu

# 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ố

openclaw channels status --probe
openclaw logs --follow
openclaw 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 của tác nhân khi việc tải tệp từ Slack thành công và giới hạn kích thước cho phép. Tệp hình ảnh có thể được chuyển qua luồng hiểu phương tiện hoặc trực tiếp tới mô hình phản hồi hỗ trợ thị giác; 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 hình ả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 (xoxb-...).
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 luồng mô hình/công cụ hỗ trợ hình ảnh có thể dùng tệp đính kèm hình ảnh từ ngữ cảnh đó.
5. Tệp không phải hình ảnh vẫn có sẵn 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 luồng

Khi một tin nhắn đến trong một luồng (có cha thread_ts):

• Nếu 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ể nạp các tệp gốc làm ngữ cảnh khởi tạo luồng.
• Tệp đính kèm trực tiếp trong câu trả lời được ưu tiên hơn tệp đính kèm của tin nhắn gốc.
• Một tin nhắn gốc chỉ có tệp và không có văn bản được biểu diễn bằng placeholder tệp đính kèm để cơ chế dự phòng 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 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.
• Các 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 về 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 thị giác: Phân tích hình ảnh dùng mô hình phản hồi đang hoạt động khi mô hình đó hỗ trợ thị giác, hoặc mô hình 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 thị giác 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