Slack

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Thiết lập nhanh

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

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

​

Tinh chỉnh transport Socket Mode

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

​

Danh sách kiểm tra manifest và scope

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "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"
      ]
    }
  }
}

{
  "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": [
        /* same as Socket Mode */
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

​

Cài đặt 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": "/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": "/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"
      }
      // ...repeat for every command with the same `url` value
    ]

​

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 đè phương án dự phòng từ env.
• Phương án 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ỉ cấu hình được trong config (không có phương án dự phòng env) và mặc định ở 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 qua SecretRef hoặc 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ế.
• Ở 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

​

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, phiên và thẻ trả lời

• DM định tuyến là direct; kênh là channel; MPIM là group.
• Với session.dmScope=main mặc định, DM Slack gộp vào phiên chính của agent.
• Phiên kênh: agent:<agentId>:slack:channel:<channelId>.
• Trả lời trong luồng có thể tạo hậu tố phiên luồng (:thread:<threadTs>) khi phù hợp.
• 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.thread.requireExplicitMention (mặc định false): khi true, chặn mention luồng ngầm định để bot chỉ phản hồi các mention @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 requireMention.

• channels.slack.replyToMode: off|first|all|batched (mặc định off)
• channels.slack.replyToModeByChatType: theo từng direct|group|channel
• phương án dự phòng kế thừa 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

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• phương án dự phòng emoji định danh agent (agents.list[].identity.emoji, nếu không có thì ”👀”)

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

​

Truyền phát văn bản

• off: tắt truyền phát 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úc.
• progress: hiển thị văn bản trạng thái tiến độ 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 độ vào cùng tin nhắn xem trước đã chỉnh sửa (mặc định: true). Đặt false để giữ riêng các tin nhắn công cụ/tiến độ.

• Phải có luồng trả lời để truyền phát 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ủa kênh và trò chuyện nhóm vẫn có thể dùng bản xem trước nháp thông thường khi truyền phát gốc không khả dụng.
• DM Slack cấp cao nhất mặc định ở ngoài luồng, nên chúng không hiển thị bản xem trước kiểu luồng; dùng trả lời trong luồng hoặc typingReaction nếu bạn muốn có tiến độ hiển thị ở đó.
• Media và payload không phải văn bản quay về cách gửi thông thường.
• Kết quả cuối media/lỗi hủy các chỉnh sửa xem trước đang chờ; kết quả cuối văn bản/block đủ điều kiện chỉ được đẩy ra khi có thể chỉnh sửa bản xem trước tại chỗ.
• Nếu truyền phát thất bại giữa chừng khi trả lời, OpenClaw quay về cách gửi thông thường cho các payload còn lại.

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

• channels.slack.streamMode (replace | status_final | append) được tự động di chuyển sang channels.slack.streaming.mode.
• boolean channels.slack.streaming được tự động di chuyển sang channels.slack.streaming.mode và channels.slack.streaming.nativeTransport.
• channels.slack.nativeStreaming kế thừa được tự động di chuyển sang channels.slack.streaming.nativeTransport.

​

Phương án dự phòng phản ứng đang nhập

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

• Slack yêu cầu shortcode (ví dụ "hourglass_flowing_sand").
• Phản ứng được thực hiện theo khả năng tốt nhất và việc dọn dẹp được tự động thử sau khi đường dẫn trả lời hoặc thất bại hoàn tất.

​

Media, chia khúc và gửi

​

Lệnh và hành vi slash

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

/openclaw /help

• Chế độ tự động của lệnh gốc bị tắt cho Slack, nên commands.native: "auto" không bật lệnh gốc của 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 giới hạn Slack: giá trị tùy chọn được mã hóa sẽ chuyển dự phòng 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]]

• Đây là giao diện người dùng riêng cho Slack. Các kênh khác không chuyển đổi 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 tác nhân tạo.
• Nếu các khối tương tác được tạo vượt giới hạn Slack Block Kit, OpenClaw sẽ chuyển dự phòng về phản hồi văn bản gốc thay vì gửi payload khối không hợp lệ.

​

Phê duyệt exec trong Slack

• Phê duyệt exec dùng channels.slack.execApprovals.* cho định tuyến DM/kênh gốc.
• Phê duyệt Plugin vẫn có thể được xử lý qua cùng bề mặt nút gốc của Slack 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 xác định là người phê duyệt mới có thể phê duyệt hoặc từ chối yêu cầu qua Slack.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (tùy chọn; chuyển dự phòng 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 lên kênh từ luồng (“Also send to channel” trong phản hồi luồng) được xử lý như tin nhắn người dùng thông thường.
• Sự kiện thêm/xóa reaction được ánh xạ thành sự kiện hệ thống.
• Sự kiện thành viên tham gia/rời khỏ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 khởi tạo luồng và việc nạp ngữ cảnh 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.
• Hành động khối 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_*
  • 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ố

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 (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 đường dẫn mô hình/công cụ có khả năng 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 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 luồng

• Nếu chính phản hồ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 người khởi tạo luồng.
• Tệp đính kèm phản hồi trực tiếp đượ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 placeholder tệp đính kèm để phương án 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

• Mỗi tệp đính kèm được xử lý độc lập thông 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ý tuân theo thứ tự tệp của Slack trong tải trọng sự kiện.
• Lỗi khi tải xuống 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 cho 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 thể truy cập, tệp vượt kích thước và phản hồi HTML xác thực/đăng nhập của 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 trả lờ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