Slack

Documentation Index

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

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

​

Chọn Socket Mode hoặc HTTP Request URLs

​

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

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

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 truyền tải 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": {
      "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"
      ]
    }
  }
}

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

​

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": "/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 cho 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 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 trong config (không có phương án dự phòng env) 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 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

​

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 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 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>.
• Trả lời luồng có thể tạo hậu tố phiên luồng (:thread:<threadTs>) khi áp dụng.
• Trong các kênh nơi OpenClaw xử lý tin nhắn cấp cao nhất mà không yêu cầu lượt nhắc rõ ràng, replyToMode khác off định tuyến từng gốc được xử lý vào agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> để luồng Slack hiển thị ánh xạ tới một phiên OpenClaw ngay từ lượt đầu tiên.
• Mặc định channels.slack.thread.historyScope là thread; mặc định 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 định để 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 câu 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 cũ cho chat 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
• emoji dự phòng theo danh tính tác nhân (agents.list[].identity.emoji, nếu không 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 trực tuyến văn bản

• off: tắt truyền trực tuyến bả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 từng 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ậ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ữ riêng các tin nhắn công cụ/tiến trình.
• streaming.preview.commandText / streaming.progress.commandText: đặt thành status để giữ các dòng tiến trình công cụ ngắn gọn trong khi ẩn văn bản lệnh/exec thô (mặc định: raw).

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

• Phải có sẵn một luồng trả lời để phát trực tuyến văn bản gốc và hiển thị trạng thái luồng trợ lý Slack. Việc chọn luồng vẫn tuân theo replyToMode.
• Gốc kênh, cuộc 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 thông thường khi phát trực tuyế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 vẫn ở ngoài luồng, nên không hiển thị bản xem trước phát trực tuyến/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à payload không phải văn bản quay về cơ chế gửi thông thường.
• Kết quả cuối là phương tiện/lỗi sẽ hủy các chỉnh sửa bản xem trước đang chờ; kết quả cuối dạng 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 phát trực tuyến thất bại giữa lúc 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) 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 sang các khóa chuẩ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 kiểu nỗ lực tối đa và việc dọn dẹp sẽ được tự động thử sau khi đường dẫn trả lời hoặc lỗi hoàn tất.

​

Phương tiện, chia đoạn 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 của lệnh gốc được 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 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

​

Trả lờ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à UI dành 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 agent viết.
• 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ề trả lời văn bản ban đầu thay vì gửi payload blocks 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 approval id 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; 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 luồng (“Also send to channel” thread replies) đượ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 đ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 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 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.
• Trình khởi tạo luồng và khởi tạo ngữ cảnh lịch sử luồng ban đầu được lọc theo allowlist 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 các 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 được định tuyến và dữ liệu nhập 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 media đượ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 media khi thành công.
3. Đường dẫn media đã 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ụ 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 media 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 bản trả lời không có media trực tiếp và tin nhắn gốc đi kèm có tệp, Slack có thể hydrate các tệp gốc làm ngữ cảnh khởi đầu luồng.
• Tệp đính kèm trả lời trực tiếp đượ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 một 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

• Mỗi tệp đính kèm được xử lý độc lập qua pipeline media.
• Các tham chiếu media đã 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 dung lượng, tải xuống và mô hình

• Giới hạn dung lượng: 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á dung lượng, 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 vision: 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ợ vision, 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 media
• 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