​

Slack

​

Thiết lập nhanh

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

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

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

Mô hình token

• botToken + appToken là bắt buộc cho Socket Mode.
• Chế độ HTTP yêu cầu botToken + signingSecret.
• Token cấu hình ghi đè biến môi trường dự phòng.
• Biến môi trường SLACK_BOT_TOKEN / SLACK_APP_TOKEN chỉ áp dụng cho tài khoản mặc định.
• userToken (xoxp-...) chỉ có trong cấu hình (không có dự phòng môi trường) và mặc định là chỉ đọc (userTokenReadOnly: true).
• Tùy chọn: thêm chat:write.customize nếu muốn tin nhắn gửi đi sử dụng danh tính tác nhân hiện tại (tùy chỉnh username và icon). icon_emoji sử dụng cú pháp :emoji_name:.

​

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

​

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

• Chế độ tự động lệnh gốc là tắt cho Slack (commands.native: "auto" không kích hoạt lệnh gốc của Slack).
• Kích hoạt trình xử lý lệnh gốc của Slack với channels.slack.commands.native: true (hoặc toàn cầu commands.native: true).
• Khi lệnh gốc được kích hoạt, đăng ký các lệnh gạch chéo tương ứng trong Slack (/<command> tên), với một ngoại lệ:
  • đăng ký /agentstatus cho lệnh trạng thái (Slack dành riêng /status)
• Nếu lệnh gốc không được kích hoạt, bạn có thể chạy một lệnh gạch chéo được cấu hình duy nhất thông qua channels.slack.slashCommand.
• Menu đối số gốc hiện thích ứng với chiến lược hiển thị của chúng:
  • 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 không đồng bộ khi các trình xử lý tùy chọn tương tác có sẵn
  • nếu các giá trị tùy chọn được mã hóa vượt quá giới hạn của Slack, luồng sẽ quay lại nút
• Đối với tải trọng tùy chọn dài, menu đối số lệnh gạch chéo sử dụng hộp thoại xác nhận trước khi gửi giá trị đã chọn.

​

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]]

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

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

• agent:<agentId>:slack:slash:<userId>

​

Luồng, phiên và thẻ phản hồi

• DMs định tuyến là direct; kênh là channel; MPIMs là group.
• Với session.dmScope=main mặc định, DMs của Slack sụp đổ thành phiên chính của tác nhân.
• Phiên kênh: agent:<agentId>:slack:channel:<channelId>.
• Phản hồi luồng có thể tạo hậu tố phiên luồng (:thread:<threadTs>) khi áp dụng.
• channels.slack.thread.historyScope mặc định là thread; thread.inheritParent mặc định 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.replyToMode: off|first|all (mặc định off)
• channels.slack.replyToModeByChatType: theo direct|group|channel
• dự phòng cũ cho các cuộc trò chuyện trực tiếp: channels.slack.dm.replyToMode

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

​

Phương tiện, phân đoạn và phân phối

​

Hành động và cổng

​

Sự kiện và hành vi hoạt động

• Chỉnh sửa/xóa tin nhắn/phát sóng luồng được ánh xạ thành sự kiện hệ thống.
• Sự kiện thêm/xóa phản ứng được ánh xạ thành sự kiện hệ thống.
• Thành viên tham gia/rời đi, kênh được tạo/đổi tên, và sự kiện thêm/xóa ghim được ánh xạ thành sự kiện hệ thống.
• Cập nhật trạng thái luồng trợ lý (cho các chỉ báo “đang gõ…” trong luồng) sử dụng assistant.threads.setStatus và yêu cầu phạm vi bot assistant:write.
• channel_id_changed có thể di chuyển các 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 coi là ngữ cảnh không đáng tin cậy và có thể được tiêm vào ngữ cảnh định tuyến.
• Hành động khối và tương tác modal phát ra sự kiện hệ thống có cấu trúc Slack interaction: ... với các trường tải trọng phong phú:
  • hành động khối: các giá trị đã chọn, nhãn, giá trị chọn, và siêu dữ liệu workflow_*
  • sự kiện view_submission và view_closed của modal với siêu dữ liệu kênh được định tuyến và đầu vào biểu mẫu

​

Phản ứng xác nhận

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

• Slack mong đợi mã ngắn (ví dụ "eyes").
• Sử dụng "" để vô hiệu hóa phản ứng cho tài khoản Slack hoặc toàn cầu.

​

Phản ứng gõ dự phòng

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

• Slack mong đợi mã ngắn (ví dụ "hourglass_flowing_sand").
• Phản ứng là nỗ lực tốt nhất và việc dọn dẹp được thực hiện tự động sau khi phản hồi hoặc đường dẫn thất bại hoàn tất.

​

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Kết nối Slack cho OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": false
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Gửi tin nhắn đến OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "users:read",
        "app_mentions:read",
        "assistant:write",
        "reactions:read",
        "reactions:write",
        "pins:read",
        "pins:write",
        "emoji:read",
        "commands",
        "files:read",
        "files:write"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "reaction_added",
        "reaction_removed",
        "member_joined_channel",
        "member_left_channel",
        "channel_rename",
        "pin_added",
        "pin_removed"
      ]
    }
  }
}

​

Khắc phục sự cố

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

openclaw pairing list slack

​

Truyền văn bản

• 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: thêm các cập nhật xem trước phân đoạn.
• progress: hiển thị văn bản trạng thái tiến độ trong khi tạo, sau đó gửi văn bản cuối cùng.

channels:
  slack:
    streaming: partial
    nativeStreaming: false

• channels.slack.streamMode (replace | status_final | append) được tự động chuyển đổi thành channels.slack.streaming.
• boolean channels.slack.streaming được tự động chuyển đổi thành channels.slack.nativeStreaming.

​

Yêu cầu

1. Bật Agents và AI Apps trong cài đặt ứng dụng Slack của bạn.
2. Đảm bảo ứng dụng có phạm vi assistant:write.
3. Một luồng phản hồi phải có sẵn cho tin nhắn đó. Lựa chọn luồng vẫn tuân theo replyToMode.

​

Hành vi

• Khối văn bản đầu tiên bắt đầu một luồng (chat.startStream).
• Các khối văn bản sau đó được thêm vào cùng một luồng (chat.appendStream).
• Kết thúc phản hồi hoàn tất luồng (chat.stopStream).
• Phương tiện và tải trọng không phải văn bản quay lại phân phối bình thường.
• Nếu truyền thất bại giữa phản hồi, OpenClaw quay lại phân phối bình thường cho các tải trọng còn lại.

​

Tham chiếu cấu hình

• Tham chiếu cấu hình - Slack Các trường Slack quan trọng:
  • chế độ/xác thực: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • truy cập DM: dm.enabled, dmPolicy, allowFrom (cũ: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • chuyển đổi tương thích: dangerouslyAllowNameMatching (phá vỡ kính; giữ tắt trừ khi cần thiết)
  • truy cập kênh: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • luồng/lịch sử: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • phân phối: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • hoạt động/tính năng: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Liên quan

• Ghép nối
• Định tuyến kênh
• Khắc phục sự cố
• Cấu hình
• Lệnh gạch chéo