Slack

​

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

​

Chế độ relay

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

​

Cài đặt

openclaw plugins install @openclaw/slack

​

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-example
export SLACK_BOT_TOKEN=slack-bot-token-example
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=slack-app-token-example
SLACK_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-example
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

​

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

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

• 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

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

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

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

• 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

​

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

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { allow: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { allow: true, requireMention: true },
      },
    },
  },
}

​

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.

• 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

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

​

Phản ứng xác nhận

​

Emoji (ackReaction)

• 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" / 👀)

• 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)

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

• 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).

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

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

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

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

• 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

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

• 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

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

/openclaw /help

• 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

• 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

​

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

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

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

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

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

• Đâ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

• Đặ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.

​

Phê duyệt gốc trong Slack

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

• 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

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

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

​

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

​

Tham chiếu cấu hình

​

Khắc phục sự cố

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

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

​

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

​

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

​

Pipeline đầu vào

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

• 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

• 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